翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Kinesis Data Streams を使用して音声およびチャットコンタクトの Contact Lens 分析にアクセスする
コンタクト分析セグメントストリームを使用すると、音声コンタクトとチャットコンタクトの Contact Lens 分析にアクセスできます。ストリーミングは、既存の[通話とチャット分析 API](contact-lens-api.md) のスケーリング制限を克服しています。音声コンタクトでは、部分的なトランスクリプトにアクセスできる、`Utterance` と呼ばれるデータセグメントにもアクセスできます。これにより、ライブコールでエージェントを支援するための超低レイテンシー要件を満たすことができます。
このセクションでは、ストリーミングのために Amazon Kinesis Data Streams と統合する方法について説明します。
ストリーミングを通して、以下のイベントタイプを受信できます。
+ コンタクト分析セッションの開始時に公開された STARTED イベント。
+ コンタクト分析セッション中に公開された SEGMENTS イベント。これらのイベントには、分析された情報を含むセグメントのリストが含まれます。
+ コンタクト分析セッションの終了時に公開された COMPLETED イベントまたは FAILED イベント。
**Topics**
+ [コンタクト分析セグメントストリームを有効にする](enable-contact-analysis-segment-streams.md)
+ [音声: 会話分析セグメントストリームのデータモデル](real-time-contact-analysis-segment-streams-data-model.md)
+ [チャット: 会話分析セグメントストリームのデータモデル](chat-real-time-contact-analysis-segment-streams-data-model.md)
+ [音声: 会話分析セグメントストリームのサンプル](sample-real-time-contact-analysis-segment-stream.md)
+ [チャット: 会話分析セグメントストリームのサンプル](chat-sample-real-time-contact-analysis-segment-stream.md)
# Contact Lens の会話を分析するためにコンタクト分析セグメントストリームを有効にする
問い合わせ分析セグメントストリームは、デフォルトでは有効になっていません。このトピックでは、有効にする方法について説明します。
## ステップ 1: Kinesis ストリームを作成する
Amazon Connect インスタンスが存在するのと同じアカウントとリージョンにデータストリームを作成します。詳細については、『*Amazon Kinesis Data Streams デベロッパーガイド*』の「[ステップ 1: データストリームの作成](https://docs.aws.amazon.com/streams/latest/dev/tutorial-stock-data-kplkcl-create-stream.html)」を参照してください。
**ヒント**
データのタイプごとに個別のストリームを作成することをお勧めします。コンタクト分析セグメントストリーム、エージェントイベント、およびコンタクトレコードに同じストリームを使用することは可能ですが、それぞれ個別のストリームを使用した方が、ストリームの管理とデータの取得がはるかに容易になります。詳細については、「[Amazon Kinesis Data Streams デベロッパーガイド](https://docs.aws.amazon.com/streams/latest/dev/introduction.html)」を参照してください。
## ステップ 2: Kinesis ストリームのサーバー側暗号化を設定する (オプションですが、推奨)
これを行うには、いくつかの方法があります。
+ オプション 1: Kinesis AWS マネージドキー (`aws/kinesis`) を使用します。追加の設定なしで機能します。
+ オプション 2: Amazon Connect インスタンスの通話録音、チャットのトランスクリプト、またはエクスポートされたレポートで同じ顧客管理キーを使用します。
オプション 2: Amazon Connect インスタンスの通話録音、チャットのトランスクリプト、またはエクスポートされたレポートで同じ顧客管理キーを使用します。その場合、Kinesis データストリームに同じ KMS キーを選択します。このキーには、使用に必要な許可 (付与) が既にあります。
+ オプション 3: 別の顧客管理キーを使用します。
既存の顧客管理キーを使用するか、新しい顧客管理キーを作成して、Amazon Connect ロールがキーを使用するために必要な許可を追加します。 AWS KMS 付与を使用して許可を追加するには、次の例を参照してください。
```
aws kms create-grant \
--key-id your key ID \
--grantee-principal arn:aws:iam::your AWS account ID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_11111111111111111111 \
--operations GenerateDataKey \
--retiring-principal arn:aws:iam::your AWS account ID:role/adminRole
```
`grantee-principal` は、Amazon Connect インスタンスに関連付けられているサービスにリンクされたロールの ARN です。サービスにリンクされたロールの ARN を確認するには、Amazon Connect コンソールで、**[Overview]** (概要)、**[Distribution settings]** (ディストリビューションの設定)、**[Service-linked role]** (サービスにリンクされたロール) に移動します。
## ステップ 3: Kinesis ストリームを関連付ける
Amazon Connect [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html) API を使用して、以下のリソースタイプを関連付けます。
+ 音声コンタクトでは `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` を使用します。
+ チャットコンタクトでは `REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS` を使用します。
**注記**
`REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` は廃止されましたが、まだサポートされており、音声コンタクトのみに適用されます。今後の音声コンタクトでは `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` を使用してください。
以前ストリームを `REAL_TIME_CONTACT_ANALYSIS_SEGMENTS` に関連付けたことがある場合は、ストリームを `REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS` に更新するためのアクションは必要ありません。
リアルタイムコンタクト分析セグメントの公開先の Kinesis ストリームを指定します。インスタンス ID と Kinesis ストリーム ARN が必要です。コードの例を以下に示します。
```
// Build request
const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
InstanceId: 'your Amazon Connect instance ID',
ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS or REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS',
StorageConfig: {
StorageType: 'KINESIS_STREAM',
KinesisStreamConfig: {
StreamArn: 'the ARN of your Kinesis stream',
},
}
};
```
### AWS CLI
以下はチャットコンタクトの例です。
**ヒント**
AWS リージョン (`--region`) を含めない場合、CLI プロファイルに基づいてデフォルトのリージョンが使用されます。
`--storage-config` パラメータ値は一重引用符 (') 内に含めないでください。そうしないと、エラーが発生します。
```
aws connect associate-instance-storage-config \
--region "us-west-2" \
--instance-id your Amazon Connect instance ID \
--resource-type REAL_TIME_CONTACT_ANALYSIS_CHAT_SEGMENTS \
--storage-config StorageType=KINESIS_STREAM,KinesisStreamConfig={StreamArn=the ARN of your Kinesis stream}
```
### AWS SDK
以下は音声コンタクトの例です。
```
import { Connect } from 'aws-sdk';
async function associate (): Promise {
const clientConfig: Connect.ClientConfiguration = {
region: 'the Region of your Amazon Connect instance',
};
const connect = new Connect(clientConfig);
// Build request
const request: Connect.Types.AssociateInstanceStorageConfigRequest = {
InstanceId: 'your Amazon Connect instance ID',
ResourceType: 'REAL_TIME_CONTACT_ANALYSIS_VOICE_SEGMENTS',
StorageConfig: {
StorageType: 'KINESIS_STREAM',
KinesisStreamConfig: {
StreamArn: 'the ARN of your Kinesis stream',
},
}
};
try {
// Execute request
const response: Connect.Types.AssociateInstanceStorageConfigResponse = await connect.associateInstanceStorageConfig(request).promise();
// Process response
console.log('raw response: ${JSON.stringify(response, null, 2)}');
} catch (err) {
console.error('Error calling associateInstanceStorageConfig. err.code: ${err.code},' +
'err.message: ${err.message}, err.statusCode: ${err.statusCode}, err.retryable: ${err.retryable}');
}
}
associate().then(r => console.log('Done'));
```
## ステップ 4: Amazon Connect インスタンスの Contact Lens を有効にする
手順については、「[Amazon Connect Contact Lens 会話分析を有効にする](enable-analytics.md)」を参照してください。
## ステップ 5 (オプション): サンプルセグメントストリームを確認する
[音声](sample-real-time-contact-analysis-segment-stream.md)または[チャット](chat-sample-real-time-contact-analysis-segment-stream.md)のサンプルセグメントストリームを確認して、それぞれどのようなものかを把握しておくことをお勧めします。
# Contact Lens で音声コンタクトを分析するための会話分析セグメントストリームのデータモデル
リアルタイム問い合わせ分析セグメントストリームは JSON で生成されます。リアルタイム会話分析が有効になっているすべてのコンタクトの関連ストリームに、イベント JSON blob が公開されます。音声コンタクトの会話分析セッションのために、以下のタイプのイベントを公開できます。
+ STARTED イベント - 各会話分析セッションは、セッションの開始時に 1 つの STARTED イベントを公開します。
+ SEGMENTS イベント - 各会話分析セッションは、セッション中に 1 つ以上の SEGMENTS イベントを公開することがあります (イベントが 0 の場合もあります)。これらのイベントには、分析された情報を含むセグメントのリストが含まれます。音声コンタクトの場合、セグメントのリストには 、「`Utterance`」、「`Transcript`」、「`Categories`」または「`PostContactSummary`」セグメントが含まれる場合があります。
+ COMPLETED または FAILED イベント - 各会話分析セッションは、セッションの終了時に 1 つの COMPLETED イベントまたは FAILED イベントを公開します。
## 音声コンタクトのすべてのイベントに含まれる共通のプロパティ
すべてのイベントには、以下のプロパティが含まれます。
**バージョン**
イベントスキーマのバージョン。
型: 文字列
**Channel**
この問い合わせのチャネルのタイプ。
型: 文字列
有効な値: `VOICE`、`CHAT`、`TASK`
チャネルの詳細については、「[Amazon Connect で問い合わせをルーティングするためのチャネルと同時実行数](channels-and-concurrency.md)」を参照してください。
**AccountId**
この問い合わせが行われるアカウントの ID。
型: 文字列
**ContactId**
分析される問い合わせの ID。
型: 文字列
**InstanceId**
この問い合わせが行われるインスタンスの ID。
型: 文字列
**LanguageCode**
この問い合わせに関連付けられている言語コード。
タイプ: 文字列
有効な値: [Contact Lens リアルタイム通話分析でサポートされている言語](supported-languages.md#supported-languages-contact-lens)のいずれかの言語コード。
**EventType**
発行されるイベントのタイプ。
型: 文字列
有効な値: `STARTED`、`SEGMENTS`、`COMPLETED`、`FAILED`
## STARTED イベント
`STARTED` イベントには、共通のプロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: STARTED
## SEGMENTS イベント
`SEGMENTS` イベントには、以下のプロパティが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: SEGMENTS
+ セグメント: 共通のプロパティに加えて、`SEGMENTS` イベントには、セグメントのリストと分析情報が含まれます。
タイプ: [セグメント](#segment)オブジェクトの配列
+ PostContactSummary: 音声コンタクトセグメントのコンタクト後の概要に関する情報。
タイプ: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) オブジェクト
必須: いいえ
**セグメント**
リアルタイム分析セッションで分析されたセグメント。
各セグメントは、以下のオプションのプロパティを持つオブジェクトです。セグメントタイプに応じて、以下のプロパティの 1 つだけが存在します。
+ Utterance
+ Transcript
+ カテゴリ
+ PostContactSummary
**Utterance**
分析された発話。
必須: いいえ
+ **ID**
発話の ID。
型: 文字列
+ ** TranscriptId**
この発話に関連付けられているトランスクリプトの ID。
タイプ: 文字列
+ **ParticipantId**
参加者の ID。
型: 文字列
+ ** ParticipantRole**
参加者のロール。例えば、顧客、エージェント、システムなどです。
型: 文字列
+ ** PartialContent**
発話の内容。
型: 文字列
+ ** BeginOffsetMillis**
このトランスクリプトのコンタクトの開始オフセット。
タイプ: 整数
+ ** EndOffsetMillis**
このトランスクリプトのコンタクトの終了オフセット。
タイプ: 整数
**Transcript**
分析されたトランスクリプト。
型: [トランスクリプト](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Transcript.html)オブジェクト
必須: いいえ
**Categories**
一致したカテゴリルール。
タイプ: [Categories](https://docs.aws.amazon.com/contact-lens/latest/APIReference/API_Categories.html) オブジェクト
必須: いいえ
**PostContactSummary**
音声コンタクトセグメントのコンタクト後の概要に関する情報。
タイプ: [PostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-contact-lens_PostContactSummary.html) オブジェクト
必須: いいえ
## COMPLETED イベント
`COMPLETED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: COMPLETED
## FAILED イベント
`FAILED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ LanguageCode
+ EventType: FAILED
# Contact Lens でチャットを分析するための会話分析セグメントストリームのデータモデル
チャットコンタクトの会話分析セグメントストリームは JSON で生成されます。リアルタイム会話分析が有効になっているすべてのコンタクトの関連ストリームに、イベント JSON blob が公開されます。チャットコンタクトの会話分析セッションのために、以下のタイプのイベントを公開できます。
+ STARTED イベント - 各会話分析セッションは、セッションの開始時に 1 つの STARTED イベントを公開します。
+ SEGMENTS イベント - 各会話分析セッションは、セッション中に 1 つ以上の SEGMENTS イベントを公開することがあります (イベントが 0 の場合もあります)。これらのイベントには、分析された情報を含むセグメントのリストが含まれます。チャットコンタクトの場合、セグメントのリストには「`Attachments`」、「`Transcript`」、「`Categories`」、「`Events`」、「`Issues`」または「`PostContactSummary`」セグメントが含まれる場合があります。
+ COMPLETED または FAILED イベント - 各会話分析セッションは、セッションの終了時に 1 つの COMPLETED イベントまたは FAILED イベントを公開します。
## チャットコンタクトのすべてのイベントに含まれる共通のプロパティ
すべてのイベントには、以下のプロパティが含まれます。
**バージョン**
イベントスキーマのバージョン。チャットコンタクトの場合、これは 2.0.0 です。
タイプ: 文字列
**Channel**
この問い合わせのチャネルのタイプ。
型: 文字列
有効な値: `VOICE`、`CHAT`、`TASK`
チャネルの詳細については、「[Amazon Connect で問い合わせをルーティングするためのチャネルと同時実行数](channels-and-concurrency.md)」を参照してください。
**AccountId**
この問い合わせが行われるアカウントの ID。
タイプ: 文字列
**InstanceId**
この問い合わせが行われるインスタンスの ID。
タイプ: 文字列
**ContactId**
分析される問い合わせの ID。
タイプ: 文字列
**StreamingEventType**
発行されるイベントのタイプ。
型: 文字列
有効な値: `STARTED`、`SEGMENTS`、`COMPLETED`、`FAILED`
**StreamingSettings**
このコンタクトContact Lensの設定
型: [StreamingSettings](#streamingsettingsobject) オブジェクト
## StreamingSettings オブジェクト
**LanguageCode**
この問い合わせに関連付けられている言語コード。
タイプ: 文字列
有効な値: [Contact Lens リアルタイム通話分析でサポートされている言語](supported-languages.md#supported-languages-contact-lens)のいずれかの言語コード。
**Output**
このコンタクトで有効になっている Contact Lens 出力タイプ。
タイプ: 文字列
有効な値: `Raw`、`Redacted`、`RedactedAndRaw`
**RedactionTypes**
このコンタクトで有効になっている秘匿化のタイプ。
型: 文字列の配列
有効な値: `PII`
**RedactionTypesMetadata**
各秘匿化タイプの秘匿化メタデータ。
型: RedactionType 文字列から [RedactionMetadata](#redactionmetadata) オブジェクト
有効な値: `PII`
## RedactionMetadata オブジェクト
秘匿化設定に関する情報を提供します。
**RedactionMaskMode**
データの秘匿化置換設定
タイプ: 文字列
有効な値: `PII`、`EntityType`
## STARTED イベント
`STARTED` イベントには、共通のプロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ ContactId
+ StreamingEventType: STARTED
+ StreamingSettings
## SEGMENTS イベント
`SEGMENTS` イベントには、以下のプロパティが含まれます。
+ Version
+ Channel
+ AccountId
+ OutputType
+ 現在のセグメントの Contact Lens 出力タイプ。
+ タイプ: 文字列
+ 有効な値: `Raw`、`Redacted`
+ ContactId
+ StreamingEventType: SEGMENTS
+ StreamingSettings
+ セグメント
+ 分析情報を含むセグメントのリスト。
+ タイプ: [セグメント](#chat-segment)オブジェクトの配列
**セグメント**
リアルタイム分析セッションで分析されたセグメント。
各セグメントは、以下のオプションのプロパティを持つオブジェクトです。セグメントタイプに応じて、以下のプロパティの 1 つだけが存在します。
+ [アタッチメント](#chat-attachments)
+ [カテゴリ](#chat-category)
+ [イベント](#chat-event)
+ [問題](#chat-issues)
+ [トランスクリプト](#chat-transcript)
+ [PostContactSummary](#chat-postcontactsummary)
**アタッチメント**
分析された添付ファイル。
必須: いいえ
型: [RealTimeContactAnalysisSegmentAttachments](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentAttachments.html) オブジェクト
**Categories**
一致したカテゴリルール。
型: [RealTimeContactAnalysisSegmentCategories](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentCategories.html) オブジェクト
必須: いいえ
**イベント**
コンタクトイベントを説明するセグメントタイプ。
型: [RealTimeContactAnalysisSegmentEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentEvent.html) オブジェクト
必須: いいえ
**問題**
検出された問題のリストを含むセグメントタイプ。
型: [RealTimeContactAnalysisSegmentIssues](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentIssues.html) オブジェクト
必須: いいえ
**トランスクリプト**
分析されたトランスクリプトセグメント。
型: [RealTimeContactAnalysisSegmentTranscript](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentTranscript.html) オブジェクト
必須: いいえ
**PostContactSummary**
チャットのリアルタイムコンタクトセグメントのコンタクト後の概要に関する情報。
タイプ: [RealTimeContactAnalysisSegmentPostContactSummary](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealTimeContactAnalysisSegmentPostContactSummary.html) オブジェクト
必須: いいえ
## COMPLETED イベント
`COMPLETED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ InstanceId
+ ContactId
+ StreamingEventType: COMPLETED
+ StreamingSettings
## FAILED イベント
`FAILED` イベントには、以下の共通プロパティのみが含まれます。
+ Version
+ Channel
+ AccountId
+ InstanceId
+ ContactId
+ StreamingEventType: FAILED
+ StreamingSettings
# Contact Lens を使用して通話を分析するための会話分析セグメントストリームのサンプル
このトピックでは、音声コンタクト中に発生する可能性のある STARTED、SEGMENTS、COMPLETED、FAILED イベントのサンプルセグメントストリームを示します。
## サンプルの STARTED イベント
+ EventType: STARTED
+ 会話分析セッションの開始時に公開されます。
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "STARTED"
}
```
## サンプルの SEGMENTS イベント
+ EventType: SEGMENTS
+ 会話分析セッション中に公開されます。これらのイベントには、セグメントのリストと分析情報が含まれます。セグメントのリストには、「`Utterance`」、「`Transcript`」、「`Categories`」または「`PostContactSummary`」セグメントが含まれる場合があります。
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "SEGMENTS",
"Segments": [
{
"Utterance": {
"Id": "7b48ca3d-73d3-443a-bf34-a9e8fcc01747",
"TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"PartialContent": "Hello, thank you for calling Example Corp. My name is Adam.",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22980
}
},
{
"Utterance": {
"Id": "75acb743-2154-486b-aaeb-c960ae290e88",
"TranscriptId": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"PartialContent": "How can I help you?",
"BeginOffsetMillis": 23000,
"EndOffsetMillis": 24598
}
},
{
"Transcript": {
"Id": "121d1581-905f-4169-9804-b841bb4df04a",
"ParticipantId": "AGENT",
"ParticipantRole": "AGENT",
"Content": "Hello, thank you for calling Example Corp. My name is Adam. How can I help you?",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 24598,
"Sentiment": "NEUTRAL"
}
},
{
"Transcript": {
"Id": "4295e927-43aa-4447-bbfc-8fccc2027530",
"ParticipantId": "CUSTOMER",
"ParticipantRole": "CUSTOMER",
"Content": "I'm having trouble submitting the application, number AX876293 on the portal. I tried but couldn't connect to my POC on the portal. So, I'm calling on this toll free number",
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690,
"Sentiment": "NEGATIVE",
"IssuesDetected": [
{
"CharacterOffsets": {
"BeginOffsetChar": 0,
"EndOffsetChar": 81
}
}
]
}
},
{
"Categories": {
"MatchedCategories": [
"CreditCardRelated",
"CardBrokenIssue"
],
"MatchedDetails": {
"CreditCardRelated": {
"PointsOfInterest": [
{
"BeginOffsetMillis": 19010,
"EndOffsetMillis": 22690
}
]
},
"CardBrokenIssue": {
"PointsOfInterest": [
{
"BeginOffsetMillis": 25000,
"EndOffsetMillis": 29690
}
]
}
}
}
},
{
"PostContactSummary": {
"Content": "Customer contacted Example Corp because of an issue with their application",
"Status": "COMPLETED"
}
}
]
}
```
## サンプルの COMPLETED イベント
+ EventType: COMPLETED
+ 分析が正常に完了した場合、問い合わせ分析セッションの終了時に公開されます。
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "COMPLETED"
}
```
## サンプルの FAILED イベント
+ EventType: FAILED
+ 分析が失敗した場合、会話分析セッションの終了時に公開されます。
```
{
"Version": "1.0.0",
"Channel": "VOICE",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"LanguageCode": "en-US", // the language code of the contact
"EventType": "FAILED"
}
```
# Contact Lens でチャットを分析するための会話分析ストリームのサンプル
このトピックでは、チャットコンタクト中に発生する可能性のある STARTED、SEGMENTS、COMPLETED、FAILED イベントのサンプルセグメントストリームを示します。
## サンプルの STARTED イベント
+ EventType: STARTED
+ 会話分析セッションの開始時に公開されます。
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "STARTED",
"StreamingSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": [
"PII"
],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```
## サンプルの SEGMENTS イベント
+ EventType: [SEGMENTS](chat-real-time-contact-analysis-segment-streams-data-model.md#chat-segment-streams-data-model-segments-event)
+ 会話分析セッション中に公開されます。このイベントには、分析された情報を含む [RealtimeContactAnalysisSegment](https://docs.aws.amazon.com/connect/latest/APIReference/API_RealtimeContactAnalysisSegment.html) オブジェクトのリストが含まれます。セグメントのリストには、「`"Transcript"`」、「`"Categories"`」、「`"Issue"`」、「`"Event"`」、「`"Attachment"`」または「PostContactSummary」セグメントが含まれることがあります。
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"OutputType": "Redacted",
"StreamingEventType": "SEGMENTS",
"StreamingSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": [
"PII"
],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
},
"Segments": [{
"Transcript": {
"Id": "07a2d668-5c9e-4f69-b2fe-986261b0743a",
"ParticipantId": "a309ac1e-ca87-44ca-bb5d-197eca8ed77a",
"ParticipantRole": "AGENT",
"DisplayName": "[PII]",
"Content": "Hello, thank you for contacting Example Corp. My name is Ray.",
"ContentType": "text/markdown",
"Time": {
"AbsoluteTime": "2024-03-14T19:39:26.715Z"
},
"Sentiment": "NEUTRAL"
}
}, {
"Categories": {
"MatchedDetails": {
"Hi": {
"PointsOfInterest": [{
"TranscriptItems": [{
"Id": "5205b050-8aa9-4645-a381-a308801649ab",
"CharacterOffsets": {
"BeginOffsetChar": 0,
"EndOffsetChar": 40
}
}]
}]
}
}
}
}, {
"Issues": {
"IssuesDetected": [{
"TranscriptItems": [{
"Content": "I have an issue with my bank account",
"Id": "0e5574a7-2aeb-4eab-8bb5-3a7f66a2284a",
"CharacterOffsets": {
"BeginOffsetChar": 7,
"EndOffsetChar": 43
}
}]
}]
}
}, {
"Attachments": {
"Id": "06ddc1eb-2302-4a8e-a73f-37687fe41aa9",
"ParticipantId": "7810b1de-cca8-4153-b522-2498416255af",
"ParticipantRole": "CUSTOMER",
"DisplayName": "Customer",
"Attachments": [{
"AttachmentName": "Lily.jpg",
"ContentType": "image/jpeg",
"AttachmentId": "343e34da-391a-4541-8b7e-3909d931fcfa",
"Status": "APPROVED"
}],
"Time": {
"AbsoluteTime": "2024-03-14T19:39:26.715Z"
}
}
}, {
"Event": {
"Id": "fbe61c5f-d0d8-4345-912a-4e81f5734d3b",
"ParticipantId": "7810b1de-cca8-4153-b522-2498416255af",
"ParticipantRole": "CUSTOMER",
"DisplayName": "Customer",
"EventType": "application/vnd.amazonaws.connect.event.participant.left",
"Time": {
"AbsoluteTime": "2024-03-14T19:40:00.614Z"
}
}
},
{
"PostContactSummary": {
"Content": "Customer contacted Example Corp because of an issue with their bank account",
"Status": "COMPLETED"
}
}]
}
```
## サンプルの COMPLETED イベント
+ EventType: COMPLETED
+ 分析が正常に完了した場合、問い合わせ分析セッションの終了時に公開されます。
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "COMPLETED",
"StreamingEventSettings": {
"LanguageCode": "en-US", // the language code of the contact
"Output": "RedactedAndRaw",
"RedactionTypes": ["PII"],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```
## サンプルの FAILED イベント
+ EventType: FAILED
+ 分析が失敗した場合、会話分析セッションの終了時に公開されます。
```
{
"Version": "2.0.0",
"Channel": "CHAT",
"AccountId": "123456789012", // your AWS account ID
"InstanceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", // your Amazon Connect instance ID
"ContactId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", // the ID of the contact
"StreamingEventType": "FAILED",
"StreamingEventSettings": {
"LanguageCode": "en-US",
"Output": "RedactedAndRaw",
"RedactionTypes": ["PII"],
"RedactionTypesMetadata": {
"PII": {
"RedactionMaskMode": "PII"
}
}
}
}
```