Digitalインタラクションのデータ形式

Digitalインタラクションのデータ形式について

XM Discoverでは、CSV、Excel、またはJSONを介してdigitalインタラクション(会話)をアップロードできます。デジタルインタラクションでは、会話の参加者を特定し、各メッセージを参加者に帰属させます。

通常、デジタルインタラクションには、顧客と貴社内のエンティティとの間の会話を表す、構造化および非構造化データフィールドが多数含まれています(例えば、貴社ウェブサイト上の顧客とチャットボット間のテキストの書き起こしや、顧客とライブサポート担当者間のチャットの書き起こしなど)。構造化フィールドには、日付、数値、または高度に整理されたテキストデータ(ブランド名、参加者名、製品名など)を含めることができます。非構造化フィールドには、メモ、コメント、その他の自由記述フィールドが含まれます。

以下の形式でdigitalインタラクションをアップロードできます。

• CSV
• XLSまたはXLSX (Microsoft Excel)
• JSON

DigitalインタラクションのCSVおよびExcelの書式設定

このセクションでは、CSVファイルとExcelファイルの個別のフィードバックの書式設定について説明します。どちらのファイル形式も、フォーマットと要件は同じです。

CSVファイルとExcelファイルでは、デジタルインタラクションは複数行を使用して定義されます。仕組みは以下の通りです。

• 各行には、会話内の個々の対話のほか、参加者データとタイムスタンプが含まれています。
• 同じ会話に属する個別の行は、同じ会話 ID で識別されます。
• 会話全体のフィールド値（ドキュメント日付やカスタム属性など）は、会話の最初の行から取得されます。
• 列ヘッダーは、以下の表のフィールドと完全に一致している必要があります。

ファイルを作成したら、conversationId で並べ替えて、特定のインタラクションのすべての行がグループ化されるようにします。次に、conversationTimestamp でファイルを並べ替え、会話が時系列順になるようにします。

デジタルインタラクションフィールド

DigitalインタラクションのJSONフォーマット

このセクションでは、digitalインタラクションのJSONフォーマット要件について説明します。

最上位オブジェクト

次の表は、ドキュメントノードの最上位オブジェクトについて説明したものです。

コンテンツオブジェクト

以下の表では、content オブジェクト内にネストされたオブジェクトについて説明します。

参加者オブジェクト

以下の表は、participants オブジェクト内にネストされたフィールドについて説明したものです。

conversationContentオブジェクト

以下の表では、conversationContent オブジェクト内にネストされたフィールドについて説明します。

JSONの例

エージェントとクライアントの通話記録の例を以下に示します。

[

{

"conversationId": "37852",

"conversationTimestamp": "2020-07-30T12:42:15.000Z",

「コンテンツ」: {

"participants": [

{

"participantId": "1",

"participantType": "エージェント",

"is_bot": true

},

{

"participantId": "2",

"participantType": "CLIENT",

"is_bot": false

}

],

"conversationContent": [

{

"participantId": "1"、

"text": "こんにちは、ご用件をお伺いします。",

"timestamp": "2020-07-30T12:42:15.000Z",

"id": "3785201"

},

{

"participantId": "2",

"text": "こんにちは、本日営業していますか？",

"timestamp": "2020-07-30T12:42:15.000Z",

"id": "3785202"

},

{

"participantId": "1",

"text": "営業時間は17:00から23:00です。",

"timestamp": "2020-07-30T12:42:15.000Z",

"id": "3785203"

},

{

"participantId": "2",

"text": "予約をお願いします。",

"timestamp": "2020-07-30T12:42:15.000Z",

"id": "3785204"

},

{

"participantId": "1",

「はい、もちろんです！」どのような名前を使用できますか？」,

"timestamp": "2020-07-30T12:42:15.000Z",

"id": "3785205"

}

]

},

"city": "Boston",

"source": "Facebook"

}

]