Qualtrics Platform
Customer Journey Optimizer
XM Discover
Qualtrics Social Connect

成績証明書データ書式の呼出

成績証明書データ書式の呼出について

XM Discoverを使用すると、CSV、Excel、JSON、WebVTT 形式で成績証明書（音声対話の記録）を呼び出すことができます。コール成績証明書は、会話の参加者を識別し、各メッセージを参加者に属性化します。

通常、コール成績証明書には、顧客と会社のエンティティ間の会話 (顧客と自動電話サービス間のトランスクリプト、顧客とライブサポート担当者間の通話記録など) を表す多数の構造化データ項目と非構造化データ項目が含まれています。構造化項目には、組織の高度な日付、数値、またはテキストデータ (ブランド名、参加者名、製品名など) を含めることができます。非構造化フィールドには、メモ、コメント、およびその他の自由記述フィールドが含まれます。

コールは、以下の形式でアップロードすることができます。

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

記録を呼び出すための CSV および Excel の書式設定

このセクションでは、CSV ファイルおよび Excel ファイルのコール成績証明書の書式設定について説明します。両方のファイルタイプの書式設定と要件は同じです。

CSV ファイルおよび Excel ファイルでは、コール成績証明書は複数の行を使用して定義されます。動作は以下のとおりです。

各行には、参加者データおよびタイムスタンプとともに、対話の個別ダイアログ行が含まれます。
同じメッセージのやり取り ID を共有することで、別々の行が 1 つの会話にまとめられます。
会話全体のフィールド値 ([ドキュメント日付] やカスタム属性など) は、会話の最初の行から取得されます。

要素

説明

conversationId

(必須)

メッセージのやり取り全体の一意の ID。同じ ID を持つ各行は、1 つの会話内で個別の行として処理されます。

このフィールドを natural_id 属性にマッピングして、ドキュメントの自然な ID として使用できます。

conversationTimestamp

(必須)

会話全体の日時。秒精度の ISO 8601 書式を使用します。

この項目を document_date 属性にマッピングして、伝票日付として使用することができます。

participantId

(必須)

参加者の ID。対話 (ドキュメント) ごとに一意である必要があります。

participantType

(必須)

参加者のタイプ。使用可能な値:

エージェント: 会社の担当者またはチャットボットを示します。
CLIENT: カスタマを示します。
TYPE_UNKNOWN: 識別されない関与者を示します。

これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者タイプ属性に渡されます。

指定しない場合、CB 参加者タイプにはレポート可能な値がありません。

is_ivr

(オプション)

参加者が自動音声応答装置 (IVR) ボットであるか個人であるかを示すブール型フィールド。

true: IVR ボットを示します。
false: 個人を示します。

これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者の種類属性に渡されます。

指定しない場合、CB 参加者の種類にはレポート可能な値がありません。

text

(必須)

音声の字幕です。

注意: すべてのテキストエレメントの合計が 100,000 文字を超えることはできません。存在する場合、伝票はスキップされます。

start

(必須)

スピーチの開始時刻 (会話の最初から経過したミリ秒)。

end

(必須)

スピーチが終了する時間 (会話の最初から経過したミリ秒単位)。

contentSegmentType

(必須)

このパラメータは、自然言語処理 (NLP) エンジンがデータを正しく処理できるようにするトランスクリプト書式を識別します。

使用可能な値:

; TOKEN: 転写されたデータは1語ずつ提供される。
SENTENCE：変換されたデータは、一度に 1 文ずつ提供される。
; TURN: 転写されたデータは、スピーカターンを一度に1つずつ提供する。

カスタムフィールド

(オプション)

複数の項目を指定して、構造化属性をカンバセーションに追加することができます。

コール成績証明書の JSON 書式設定

このセクションには、コール成績証明書の JSON 書式設定が含まれています。

最上位オブジェクト

以下の表では、文書ノードの最上位オブジェクトについて説明します。

要素	説明
conversationId	メッセージのやり取り全体の一意の ID。このフィールドを natural_id 属性にマッピングして、ドキュメントの自然な ID として使用できます。
conversationTimestamp	会話全体の日時。秒精度の ISO 8601 書式を使用します。この項目を document_date 属性にマッピングして、伝票日付として使用することができます。
コンテンツ	対話のコンテンツを含むオブジェクト。以下のネストされたオブジェクトが含まれます。参加者 conversationContent contentSegmentType
カスタムフィールド (属性)	複数のキーと値のペアを指定して、構造化属性をカンバセーションに追加することができます。

コンテンツオブジェクト

以下の表は、コンテンツオブジェクト内にネストされているオブジェクトを示しています。

要素	説明
参加者	対話の参加者に関する情報を提供するオブジェクトの配列。以下のフィールドが含まれます。 participant_id 種類 is_ivr
conversationContent	対話の行を含むオブジェクトの配列。以下のフィールドが含まれます。 participant_id テキスト開始終了
contentSegmentType (必須)	このパラメータは、自然言語処理 (NLP) エンジンがデータを正しく処理できるようにするトランスクリプト書式を識別します。使用可能な値: ; TOKEN: 転写されたデータは1語ずつ提供される。 SENTENCE：変換されたデータは、一度に 1 文ずつ提供される。 ; TURN: 転写されたデータは、スピーカターンを一度に1つずつ提供する。

参加者オブジェクト

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

要素

説明

participant_id

(必須)

参加者の ID。対話 (ドキュメント) ごとに一意である必要があります。

type

(必須)

参加者のタイプ。使用可能な値:

エージェント: 会社の担当者またはチャットボットを示します。
CLIENT: カスタマを示します。
TYPE_UNKNOWN: 識別されない関与者を示します。

これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者タイプ属性に渡されます。

指定しない場合、CB 参加者タイプにはレポート可能な値がありません。

is_ivr

(オプション)

参加者が自動音声応答装置 (IVR) ボットであるか個人であるかを示すブール型フィールド。

true: IVR ボットを示します。
false: 個人を示します。

これらの値は、レポートおよび参加者ビジュアル化のために CB 参加者の種類属性に渡されます。

指定しない場合、CB 参加者の種類にはレポート可能な値がありません。

conversationContent Object

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

要素	説明
participant_id (必須)	話している参加者の ID。participants 配列で指定された ID のいずれかと一致する必要があります。
text (必須)	音声の字幕です。注意: すべてのテキストエレメントの合計が 100,000 文字を超えることはできません。存在する場合、伝票はスキップされます。
start (必須)	スピーチの開始時刻 (会話の最初から経過したミリ秒)。
end (必須)	スピーチが終了する時間 (会話の最初から経過したミリ秒単位)。

例

エージェントとクライアント間のコールトランスクリプトの例を以下に示します。

[ { "conversationId": "46289", "conversationTimestamp": "2020-07-30T10:15:45.000Z",


 "participants": [
 "participants": [

 "participant_id": "1",
 "type": "AGENT

": "false
",

 "start": 22000,

 "end": 32000

 },

 "

participant_id": "2",

 "text": "Hi, I have a have a hin of questions.",

 "start": 32000,

 "end": 42000

 }

,

 "contentSegmentType": "TURN"

,

"city" "city": "Boston "

コール成績証明書の WebVTT 書式設定

WebVTT 書式設定を使用してコール成績証明書をアップロードすることができます。

文書日付は、ファイル名から自動的に取得されます (利用可能な場合)。伝票日付を自動的に設定するには、ファイル名が以下の接頭辞で始まるようにしてください

<Timezone><YYYY><MM><DD>。

例: GMT20201011-meeting.vtt

ファイル名で別の形式が使用されている場合は、マッピング手順で [ドキュメント日付] フィールドに日付変換を適用します。詳細については、特定の伝票日付の設定を参照してください。

例

以下は、WebVTT 形式の Zoom コール字幕の例です。

WEBVTT 1 00:00:00.599 --> 00:00:02.280 : Alright so let me 2 :00:04.230 --> 00:00:05.339 : start sharing 3 :00:12.809; 00:00:02.280 ; John: :gt screen: