

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect 問い合わせイベント
<a name="contact-events"></a>

Amazon Connect では、Amazon Connect コンタクトセンターのほぼリアルタイムの問い合わせストリーム (音声通話、チャット、タスク、E メール) イベント (通話がキューに入っているなど) にサブスクライブできます。

問い合わせイベントを使用して、問い合わせアクティビティをモニタリングおよび追跡する分析ダッシュボードを作成したり、ワークフォースマネジメント (WFM) ソリューションに統合してコンタクトセンターのパフォーマンスをよりよく理解したり、通話の切断などのイベントにリアルタイムで反応するアプリケーションを統合したりできます。

**注記**  
新機能とイベントタイプを追加すると、コンタクトイベントデータモデルが新しいフィールドで更新されます。すべてのデータモデルの変更により、下位互換性が維持されます。  
アプリケーションを開発するときは、新しいフィールドとイベントタイプを適切に処理するように設計します。アプリケーションは次の条件を満たす必要があります。  
処理用に設計されていない新しく追加されたフィールドを無視します。
新しいイベントタイプが導入されても機能し続けます。
このアプローチは、サービスの進化に合わせてアプリケーションを安定させるのに役立ちます。

**Topics**
+ [問い合わせイベントデータモデル](#contact-events-data-model)
+ [問い合わせタイムスタンプ](#contact-timestamps)
+ [Amazon Connect の問い合わせイベントに登録する](#subscribe-contact-events)
+ [イベントタイプのストリーミングを停止する例](#stop-streaming-event)
+ [音声通話がエージェントに接続されている場合のコンタクトイベント例](#sample-contact-event)
+ [音声通話の接続が切断された場合のコンタクトイベント例](#sample-contact-event-call-disconnected)
+ [コンタクトのプロパティを更新したときのイベント例](#sample-updated-event)
+ [ルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント](#sample-routing-criteria-event-connected)
+ [コンタクトでルーティングステップが期限切れになった場合のサンプルイベント](#sample-routing-step-expires)
+ [顧客が設定したルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント](#sample-contact-event-voice-call-routing-criteria)

## 問い合わせイベントデータモデル
<a name="contact-events-data-model"></a>

問い合わせイベントは JSON で生成されます。イベントタイプごとに、ルールで設定されているように、JSON ブロブが、選択したターゲットに送信されます。利用できる問い合わせイベントは次のとおりです。
+ AMD\$1DISABLED - 留守番電話の検出が無効になっています。
+ INITIATED - 音声通話、チャット、タスク、または E メールが開始または転送されます。
+ CONNECTED\$1TO\$1SYSTEM - 問い合わせがメディアを確立しました (例えば、担当者またはボイスメールによって応答されました)。このイベントは [AnsweringMachineDetectionStatus](#AnsweringMachineDetectionStatus) のいずれのコードでも生成されます。
**注記**  
このイベントは発信通話 ([Amazon Connect アウトバウンドキャンペーン](how-to-create-campaigns.md)を含む) タスク、およびチャットについて生成されます。
+ CONTACT\$1DATA\$1UPDATED - 音声通話、チャット、タスク、または E メールの 1 つ以上の問い合わせプロパティが更新されました。スケジュールされたタイムスタンプ (タスクのみ）、エージェントのタイムスタンプ (プレビューダイヤルモードでのアウトバウンドキャンペーン音声問い合わせのみ）、ユーザー定義の属性とタグ、ルーティング条件の更新またはステップの有効期限が切れ、 Contact Lensが特定の問い合わせに対して有効になっているかどうか。
+ QUEUED - 音声通話、チャット、タスク、または E メールは、エージェントに割り当てられるようにキューに入れられます。
+ CONNECTED\$1TO\$1AGENT - 音声通話、チャット、タスク、または E メールがエージェントに接続されています。
+ COMPLETED - COMPLETED イベントは、該当する場合、アフターコンタクトワーク (ACW) など、コンタクトが完全に終了したことを示します。
  + ACW を使用するコンタクトの場合:

    エージェントが音声通話、チャット、タスク、または E メールの ACW を完了すると、次のフィールドに入力されます。
    + AgentInfo.afterContactWorkStartTimestamp
    + agentInfo.afterContactWorkEndTimestamp
    + agentInfo.afterContactWorkDuration
  + ACW を使用しないコンタクトの場合:

    これらのフィールドは、次の場合は入力されません。
    + コンタクトにエージェントが存在しなかった。
    + エージェントが ACW に入らなかった。

    このような場合、COMPLETED イベントは DISCONNECT イベントの直後に同じデータで公開されます。
**注記**  
チャットコンタクトの場合、コンタクトコントロールパネル (CCP) でコンタクトを適切にクリアせずにエージェントがステータスをオフラインに切り替えると、次の問題が発生する可能性があります。  
COMPLETED イベントは配信されない場合があります。
AfterContactWorkEndTimestamp の不一致が表示される場合があります。
+ DISCONNECTED - 音声通話、チャット、タスク、または E メールが切断されています。発信通話の場合、ダイヤルの試行が成功しないか、試行は接続されたものの通話がピックアップされない、または試行の結果 [SIT トーン](https://en.wikipedia.org/wiki/Special_information_tone)が返された場合のいずれかです。

  切断イベントとは、次の場合です。
  + チャット、またはタスクが切断された。
  + フローアクションの結果として、タスクが切断された。
  + タスクの有効期限切れ。タスクは、有効期限タイマーが完了すると、自動的に切断されます。デフォルトは 7 日間で、タスクの有効期限は最大 90 日間に設定できます。
+ PAUSED - アクティブなタスクコンタクトが一時停止されました。
+ RESUMED - 一時停止したタスクコンタクトが再開されました。
+ WEBRTC\$1API - コンタクトは、コミュニケーションウィジェットを使用して、アプリ内でエージェントに音声/ビデオ通話を行いました。

**Topics**
+ [AgentInfo](#AgentInfo)
+ [AttributeCondition](#AttributeCondition)
+ [キャンペーン](#Campaign-ces)
+ [問い合わせイベント](#ContactEvent)
+ [CustomerVoiceActivity](#CustomerVoiceActivity)
+ [Expiry](#Expiry)
+ [Expression](#Expression)
+ [GlobalResiliencyMetadata](#GlobalResiliencyMetadata)
+ [QueueInfo](#QueueInfo)
+ [RoutingCriteria](#RoutingCriteria)
+ [Steps](#Steps)
+ [SystemEndpoint](#SystemEndpoint)
+ [Endpoint](#Endpoint)
+ [Recordings](#Recordings)
+ [RecordingsInfo](#RecordingsInfo)
+ [ContactDetails](#ContactDetails)
+ [ContactEvaluations](#ContactEvaluations)
+ [ContactEvaluation](#ContactEvaluation)
+ [StateTransitions](#StateTransitions)
+ [StateTransition](#StateTransition)
+ [OutboundStrategy](#OutboundStrategy)

### AgentInfo
<a name="AgentInfo"></a>

`AgentInfo` オブジェクトには以下のプロパティが含まれています。

**AgentArn**  
エージェントアカウントの Amazon リソースネーム (ARN)  
タイプ: ARN

**AgentInitiatedHoldDuration**  
エージェントによって開始された秒単位の合計保留時間。  
タイプ: 整数

**AfterContactWorkStartTimestamp**  
エージェントが問い合わせの [問い合わせ後作業] の実行を開始した日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**AfterContactWorkEndTimestamp**  
エージェントがコンタクトの [アフターコンタクトワーク] を終了した日時 (UTC 時間)。エージェントがチャットコンタクトに対して AfterContactWork の実行を終了し、CCP でコンタクトをクリアせずにアクティビティステータスをオフラインまたは同等のものに切り替えた場合、`AfterContactWorkEndTimestamp` の不一致に気付くことがあります。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**AfterContactWorkDuration**  
`AfterContactWorkStartTimestamp` と `AfterContactWorkEndTimestamp` との時間差 (整数秒)。  
タイプ: 整数

**AcceptedByAgentTimestamp**  
プレビューダイヤルモードのアウトバウンドキャンペーン音声コンタクトがエージェントによって受け入れられた日時 (UTC 時間)。  
型: 文字列 (yyyy-mm-ddThh:mm:ssZ)

**PreviewEndTimestamp**  
エージェントがプレビューダイヤルモードのアウトバウンドキャンペーン音声コンタクトのプレビューを終了した日時 (UTC 時間)。  
型: 文字列 (yyyy-mm-ddThh:mm:ssZ)

**HierarchyGroups**  
エージェントのエージェント階層グループ。  
タイプ: ARN

### AttributeCondition
<a name="AttributeCondition"></a>

事前定義された属性の条件を指定するオブジェクト。

**Name**  
事前定義された属性の名前。  
型: String  
長さ: 1～64

**Value**  
事前定義された属性の値。  
型: String  
長さ:1～64

**ComparisonOperator**  
条件の比較演算子。  
型: String  
有効な値: NumberGreaterOrEqualTo、Match、Range

**ProficiencyLevel**  
条件の習熟度レベル。  
型: Float  
有効な値: 1.0、2.0、3.0、4.0、5.0

**Range**  
最小習熟度レベルと最大習熟度レベルを定義するオブジェクト。  
型: Range object

**MatchCriteria**  
AgentsCriteria を定義するオブジェクト。  
型: MatchCriteria オブジェクト

**AgentsCriteria**  
agentIds を定義するオブジェクト。  
型: AgentsCriteria オブジェクト

**AgentIds**  
エージェント ID でエージェントのリストを指定するオブジェクト。  
型: 文字列の配列  
長さの制限：最大長 256

### キャンペーン
<a name="Campaign-ces"></a>

キャンペーンに関連する情報。

タイプ: [キャンペーン](https://docs.aws.amazon.com/connect/latest/APIReference/API_Campaign.html)のオブジェクト

### 問い合わせイベント
<a name="ContactEvent"></a>

`Contact` オブジェクトには以下のプロパティが含まれています。

**ContactId**  
コンタクトの識別子。  
型: 文字列  
長さ: 1-256

**InitialContactId**  
最初の問い合わせの識別子。  
タイプ: 文字列  
長さ: 1-256

**RelatedContactId**  
この問い合わせに[関連する](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_Item.html) contactId。  
型: String  
長さ: 最小は 1 です｡ 最大 256。

**PreviousContactId**  
転送されたコンタクトの元の識別子。  
型: 文字列  
長さ: 1-256

**チャネル**  
チャネルのタイプ。  
タイプ: `VOICE`、`CHAT`、`TASK`、または `EMAIL`

**InstanceArn**  
エージェントのユーザーアカウントが作成された Amazon Connect インスタンスの Amazon リソース名 (AARN)。  
タイプ: ARN

**InitiationMethod**  
コンタクトが開始された方法を示します。  
有効な値:  
+ INBOUND: 顧客がコンタクトセンターとの音声 (電話) または E メールによる問い合わせを開始しました。
+ OUTBOUND: 問い合わせコントロールパネル (CCP) からのエージェント主導のアウトバウンド音声通話または E メールを表します。
+ TRANSFER: エージェントが CCP でクイック接続を使用して問い合わせを別のエージェントやキューに転送した場合。これにより、新しい問い合わせレコードが作成されます。
+ CALLBACK: コールバックフローの一環としてお客様に連絡した場合。このシナリオの InitiationMethod の詳細については、「[Amazon Connect のリアルタイムメトリクスでキューに入れられたコールバック](about-queued-callbacks.md)」を参照してください。
+ API: API によって Amazon Connect で問い合わせが開始されました。これは、[StartOutboundVoiceContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundVoiceContact.html) API を使用して作成してエージェントにキューに入れたアウトバウンドコンタクト、または [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API を呼び出したコンタクトセンターとの顧客によって開始されたライブチャット、[StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html) API を呼び出して顧客によって開始されたタスク、または [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html) API を呼び出して顧客によって開始された E メールである可能性があります。
+ QUEUE\$1TRANSFER: 問い合わせが 1 つのキューであり、フローブロックを使用して別のキューに転送された場合。
+ EXTERNAL\$1OUTBOUND: エージェントが、CCP のクイック接続またはフローブロックを使用して、コンタクトセンターへの外部参加者との音声 (電話) 問い合わせを開始しました。
+ MONITOR: スーパーバイザーがエージェントのモニタリングを開始しました。スーパーバイザーは、断りなくエージェントやお客様をモニタリングしたり、会話に割り込んだりすることができます。
+ DISCONNECT: [切断フローの設定](set-disconnect-flow.md) ブロックがトリガーされたとき、切断イベントの後に実行するフローを指定する場合。

  切断イベントとは、次の場合です。
  + チャット、またはタスクが切断された。
  + フローアクションの結果として、タスクが切断された。
  + タスクの有効期限切れ。タスクは、有効期限タイマーが完了すると、自動的に切断されます。デフォルトは 7 日間で、タスクの有効期限は最大 90 日間に設定できます。

  切断イベントが発生すると、対応するコンテンツフローが実行されます。切断フローの実行中に新しいコンタクトが作成される場合、その新しいコンタクトは、DISCONNECT メソッドにより開始されます。
+ AGENT\$1REPLY: エージェントによって承諾されたインバウンド E メールコンタクトに対応するエージェントの返信 E メールコンタクトを表します。
+ FLOW: 自動 (フロー開始) E メールコンタクトを表します。
+ CAMPAIGN\$1PREVIEW: 問い合わせは、プレビューダイヤルモードを使用してアウトバウンドキャンペーンによって開始されました。エージェントは、通話が発信される前に顧客情報をプレビューします。

**DisconnectReason コード**  
問い合わせが終了した理由を示します。メディア接続に失敗したアウトバウンドキャンペーンのコンタクトで利用できます。  
有効な値:  
+ OUTBOUND\$1DESTINATION\$1ENDPOINT\$1ERROR: 現在の設定では、この宛先にダイヤルすることはできません (例えば、不適切なインスタンスからエンドポイント宛先を呼び出すなど)。
+ OUTBOUND\$1RESOURCE\$1ERROR: インスタンスの通話を発信するためのアクセス権限が不十分であるか、必要なリソースが見つかりませんでした。
+ OUTBOUND\$1ATTEMPT\$1FAILED: 不明なエラー、無効なパラメータ、または API を呼び出すためのアクセス権限が不十分でした。
+ OUTBUND\$1PREVIEW\$1DISCARDED: コンタクトは作成されず、受信者はリストから削除されました。これ以上の試行は行われません。
+ EXPIRED: 可能なエージェントが不足しているか、このような通話数を処理する通信容量が不足しています。
+ DISCARDED: エージェントが E メールコンタクトを破棄したことを示します。

**AnsweringMachineDetectionStatus**  
コンタクトが接続されている場合の[アウトバウンドキャンペーン](how-to-create-campaigns.md)コールの実際の処理方法を示します Amazon Connect。  
タイプ: 文字列  
有効な値:  
+ `HUMAN_ANSWERED`: ダイヤルされた番号は担当者が応答しました。
+ `VOICEMAIL_BEEP`: ダイヤルされた番号は、ビープ音付きのボイスメールによって応答されました。
+ `VOICEMAIL_NO_BEEP`: ダイヤルされた番号は、ビープ音なしのボイスメールによって応答されました。
+ `AMD_UNANSWERED`: ダイヤルされた番号は鳴り続けましたが、応答がありませんでした。
+ `AMD_UNRESOLVED`: ダイヤルされた番号は接続されましたが、留守番電話の検出では、担当者が応答したのか、ボイスメールが応答したのか判断できませんでした。
+ `AMD_UNRESOLVED_SILENCE`: ダイヤルされた番号は接続されたましたが、留守番電話の検出がありませんでした。
+ `AMD_NOT_APPLICABLE`: 呼び出し音が鳴る前に通話が切れました。検出したメディアはありませんでした。
+ `SIT_TONE_BUSY`: ダイヤルされた番号は通話中でした。
+ `SIT_TONE_INVALID_NUMBER`: ダイヤルされた番号は有効な番号ではありませんでした。
+ `SIT_TONE_DETECTED`: 特殊情報トーン (SIT) が検出されました。
+ `FAX_MACHINE_DETECTED`: FAX 機が検出されました。
+ `AMD_ERROR`: ダイヤルされた番号は接続されたが、留守番電話の検出にエラーがありました。

**EventType**  
発行されるイベントのタイプ。  
タイプ: 文字列  
有効な値: INITIATED、CONNECTED\$1TO\$1SYSTEM、CONTACT\$1DATA\$1UPDATED、QUEUED、CONNECTED\$1TO\$1AGENT、DISCONNECTED、PAUSED、RESUMED、COMPLETED

**UpdatedProperties**  
更新されたプロパティの型。  
タイプ: 文字列  
有効な値: ScheduledTimestamp、UserDefinedAttributes、ContactLens.ConversationalAnalytics.Configuration,セグメント属性、タグ、GlobalResiliencyMetadata

**AgentInfo**  
問い合わせが割り当てられたエージェント。  
型: `AgentInfo` オブジェクト 

**QueueInfo**  
問い合わせが配置されたキュー。  
型: `QueueInfo` オブジェクト 

**ContactLens**  
フローで Contact Lens が有効になっている場合の Contact Lens の情報。  
型: `ContactLens` オブジェクトの詳細については、「[ContactLens](ctr-data-model.md#ctr-ContactLens)」を参照してください。

**SegmentAttributes**  
属性マップを使用して個別のコンタクトのセグメントに保存されるシステム定義のキー値のペアのセット。属性は標準 Amazon Connect 属性であり、フローでアクセスできます。属性キーには英数字、「-」、「\$1」文字のみを使用できます。  
このフィールドはチャネルサブタイプを表示するのに使用できます。例えば、`connect:Guide`、`connect:SMS` です。  
型: SegmentAttributes   
メンバー: SegmentAttributeName、SegmentAttributeValue

**Tags**  
コンタクトに関連付けられている[タグ](granular-billing.md)。これには、 AWS 生成されたタグとユーザー定義タグの両方が含まれます。  
タイプ: 文字列間のマッピング

**CustomerId**  
顧客 ID 番号。例えば、CustomerId は、CRM からの顧客番号の場合もあります。CRM システムから発信者の一意の顧客 ID を取得するための Lambda 関数を作成できます。Amazon Connect Voice ID 機能を有効にすると、この属性に発信者の CustomerSpeakerId が入力されます。  
タイプ: 文字列 

**ChatMetrics**  
エージェント、ボット、顧客がチャットコンタクトでやり取りする方法に関する情報。    
**ChatContactMetrics**  
コンタクトレベルでの参加者の全体的なやり取りに関する情報。  
型: [ChatContactMetrics](#chat-contact-metrics) オブジェクト  
**CustomerMetrics**  
コンタクトでの顧客とのやり取りに関する情報。  
型: [ParticipantMetrics](#participantmetrics) オブジェクト  
**AgentMetrics**  
コンタクトでのエージェントのやり取りに関する情報。  
型: [ParticipantMetrics](#participantmetrics) オブジェクト

**GlobalResiliencyMetadata**  
トラフィック分散の詳細など、問い合わせのグローバルレジリエンシー設定に関する情報。  
型: [GlobalResiliencyMetadata](#GlobalResiliencyMetadata) オブジェクト

### CustomerVoiceActivity
<a name="CustomerVoiceActivity"></a>

`CustomerVoiceActivity` オブジェクトには以下のプロパティが含まれています。

**GreetingStartTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの開始を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**GreetingEndTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの終了を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

### Expiry
<a name="Expiry"></a>

ルーティングステップの有効期限を指定するオブジェクト。

**DurationInSeconds**  
ルーティングステップの有効期限が切れる前の待機秒数。  
型: Integer  
最小値: 0

**ExpiryTimestamp**  
ルーティングステップの有効期限が切れた日時を示すタイムスタンプ。  
型: String (yyyy-mm-ddThh:mm:ssZ)

### Expression
<a name="Expression"></a>

ルーティングステップの式を指定するタグ付き UNION。

**AndExpression**  
AND で結合されるルーティング式のリスト。  
型: Expression  
最小値: 0

**OrExpression**  
OR で結合されるルーティング式のリスト。  
型: Expression

**AttributeCondition**  
事前定義された属性の条件を指定するオブジェクト。  
型: AttributeCondition

**NotAttributeCondition**  
特定の習熟度を持つエージェントを除外する事前定義された属性条件を指定するオブジェクト。  
型: AttributeCondition

### GlobalResiliencyMetadata
<a name="GlobalResiliencyMetadata"></a>

トラフィック分散の詳細など、問い合わせのグローバルレジリエンシー設定に関する情報。

**ActiveRegion**  
問い合わせがアクティブな現在の AWS リージョン。これは、問い合わせがリアルタイムで処理されている場所を示します。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 1,024 です。

**OriginRegion**  
問い合わせが最初に作成および開始された AWS リージョン。これは、問い合わせがリージョン間で転送された場合`ActiveRegion`、 とは異なる場合があります。  
タイプ: 文字列  
長さの制約: 最小長は 0 です。最大長は 1,024 です。

**TrafficDistributionGroupId**  
トラフィック分散グループの識別子。  
タイプ: 文字列  
パターン: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`

### QueueInfo
<a name="QueueInfo"></a>

`QueueInfo` オブジェクトには以下のプロパティが含まれています。

**QueueArn**  
キュー用 Amazon リソースネーム (ARN)。  
型: 文字列

**QueueType**  
キューのタイプ。  
タイプ: 文字列

### RoutingCriteria
<a name="RoutingCriteria"></a>

ルーティング条件のリスト。コンタクトのルーティング条件が更新される都度、このリストに追加されます。

**ActivationTimestamp**  
ルーティング条件がアクティブに設定される日時を示すタイムスタンプ。コンタクトがキューに転送されると、ルーティング条件が有効になります。  
エージェントキュー内のコンタクトに対してルーティング条件がアクティブ化されない場合でも、 ActivationTimestamp はエージェントキュー内のコンタクトのルーティング条件で設定されます。  
型: String (yyyy-mm-ddThh:mm:ssZ)

**Index**  
ルーティング条件のインデックスに関する情報。  
型: Integer  
最小値: 0

**Steps**  
ルーティングステップのリスト。  
タイプ: ステップのオブジェクトのリスト  
長さ: 1～5

### Steps
<a name="Steps"></a>

Amazon Connect が、指定されたステップ期間中にステップ内の要件を満たす対応可能なエージェントを見つけられなかった場合、エージェントの参加が完了するまで、ルーティング条件は順番に次のステップに進みます。すべてのステップが完了すると、キュー内の任意のエージェントにコンタクトが提示されます。

**Status**  
ルーティングのステップのステータスを表します。  
型: String  
有効な値：EXPIRED, ACTIVE, JOINED, INACTIVE, DEACTIVATED, INTERRUPTED

**Expression**  
ルーティングのステップの式を指定するオブジェクト。  
型: Expression

**Expiry**  
ルーティングステップの有効期限を指定するオブジェクト。  
型: Expiry

### SystemEndpoint
<a name="SystemEndpoint"></a>

システムエンドポイント。たとえば、INBOUND の場合、これは顧客がダイヤルした電話番号または顧客が連絡した E メールアドレスです。OUTBOUND および EXTERNAL\$1OUTBOUND の場合、これは顧客へのダイヤルに使用されるアウトバウンドキューに割り当てられたアウトバウンド発信者 ID 番号、または顧客への連絡に使用されるアウトバウンドキューに割り当てられたアウトバウンド E メールアドレスです。

**注記**  
このフィールドは現在、CALLBACK、MONITOR、QUEUE\$1TRANSFER コンタクトの開始メソッドを持つコンタクトには入力されません。

**Type**  
Endpoint

### Endpoint
<a name="Endpoint"></a>

エンドポイントに関する情報。Amazon Connect では、エンドポイントは、顧客の電話番号、またはコンタクトセンターの電話番号など、問い合わせの送信先です。

**Address**  
エンドポイントのタイプの値。TELEPHONE\$1NUMBER の場合、値は E.164 形式の電話番号です。  
型: String  
長さ: 1-256

**Type**  
エンドポイントタイプ｡ 現在、エンドポイントには電話番号のみが使用できます。  
有効な値：TELEPHONE\$1NUMBER \$1 VOIP \$1 CONTACT\$1FLOW \$1 CONNECT\$1PHONENUMBER\$1ARN \$1 EMAIL\$1ADDRESS

**DisplayName**  
エンドポイントの名前を表示します。  
型: String  
長さ: 0-256

### Recordings
<a name="Recordings"></a>

録音が有効になっている場合、これは記録に関する情報です。

**Type**  
RecordingsInfo の配列

### RecordingsInfo
<a name="RecordingsInfo"></a>

音声録音、チャットのトランスクリプトまたは画面録画に関する情報。

**DeletionReason**  
録音/トランスクリプトが削除された場合、これが削除の際に入力する理由です。  
型: String

**FragmentStartNumber**  
顧客のオーディオストリームが開始された、Kinesis Video Streams のフラグメントを識別する番号。  
型: String

**FragmentStopNumber**  
顧客のオーディオストリームが停止した、Kinesis Video Streams のフラグメントを識別する番号。  
型: String

**Location**  
録音/トランスクリプトのための Amazon S3 での場所。  
型: String  
長さ: 0-256

**MediaStreamType**  
会話中に使用されるメディアストリームに関する情報。  
型: String  
有効な値：AUDIO, VIDEO, CHAT

**ParticipantType**  
会話参加者がエージェントか顧客かに関する情報。参加者のタイプは次のとおりです。  
+ すべて
+ マネージャー
+ [エージェント]
+ お客様
+ サードパーティー
+ スーパーバイザー
型: String

**StartTimestamp**  
録音の最後のレッグの会話が始まった時刻 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**Status**  
録音/トランスクリプトのステータス。  
有効な値：AVAILABLE \$1 DELETED \$1 NULL

**StopTimestamp**  
録音の最後のレッグの会話が停止した時刻 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**StorageType**  
録音/トランスクリプトの保存場所。  
型: String  
有効な値：Amazon S3 \$1 KINESIS\$1VIDEO\$1STREAM

### ContactDetails
<a name="ContactDetails"></a>

文字列キーのマップであり、コンタクト内で弱い型付けのユーザー定義属性を含む値ペアです。このオブジェクトは、タスクの問い合わせにのみ使用されます。

**Key**  
型: String  
長さ: 1-128

**Value**  
型: String  
長さ: 0-1024

### ContactEvaluations
<a name="ContactEvaluations"></a>

キーが FormId であるコンタクト評価に関する情報 - フォームの一意の識別子。

**Type**  
文字列、ContactEvaluation のマップ

### ContactEvaluation
<a name="ContactEvaluation"></a>

**EvaluationArn**  
評価フォームの Amazon リソースネーム。常に存在します。  
型: String

**Status**  
評価の状態。  
型: String  
有効な値：COMPLETE, IN\$1PROGRESS, DELETED

**StartTimestamp**  
評価が開始された日時 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**EndTimestamp**  
評価が送信された日時 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**DeleteTimestamp**  
評価が削除された日時 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**ExportLocation**  
評価がエクスポートされたパス。  
型: String  
長さ: 0-256

### StateTransitions
<a name="StateTransitions"></a>

スーパーバイザーの StateTransition のリスト。

**Type**  
StateTransition

### StateTransition
<a name="StateTransition"></a>

スーパーバイザーの状態遷移に関する情報。

**StateStartTimestamp**  
状態が開始された日時 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**StateEndTimestamp**  
状態が終了された日時 (UTC 時間)。  
型: String (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**State**  
有効な値：SILENT\$1MONITOR \$1 BARGE

### OutboundStrategy
<a name="OutboundStrategy"></a>

アウトバウンド戦略に関する情報。

型: [OutboundStrategy](https://docs.aws.amazon.com/connect/latest/APIReference/API_OutboundStrategy.html) オブジェクト

## 問い合わせタイムスタンプ
<a name="contact-timestamps"></a>

**InitiationTimestamp**  
このコンタクトが開始された日時 (UTC 時間)。アウトバウンドキャンペーンの一部として音声コンタクトが開始された場合、`InitiationTimestamp` は、開始されたイベントのコンタクトが開始されたときのタイムスタンプを示し、後続のイベントで呼び出しが開始されたときのタイムスタンプに更新されます。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') 

**ConnectedToSystemTimestamp**  
お客様のエンドポイントが Amazon Connect に接続された日時 (UTC 時間)。INBOUND の場合、これは InitiationTimestamp と一致します。OUTBOUND、CALLBACK、API の場合、これは顧客のエンドポイントが応答する日時です。

**EnqueueTimestamp**  
コンタクトがキューに追加された日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') 

**ConnectedToAgentTimestamp**  
コンタクトがエージェントに接続された日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') 

**DisconnectTimestamp**  
顧客のエンドポイントが現在のコンタクトから切断された日時 (UTC 時間)。転送シナリオでは、前のコンタクトの DisconnectTimestamp は、that コンタクトが終了した日時を示します。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') 

**ScheduledTimestamp**  
この問い合わせがフローの実行をトリガーするようにスケジュールされた日時 (UTC 時間)。これは、タスクチャネル用にのみサポートされます。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z') 

**GreetingStartTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの開始を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**GreetingEndTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの終了を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

### ChatContactMetrics
<a name="chat-contact-metrics"></a>

コンタクトレベルでの参加者の全体的なやり取りに関する情報。

**MultiParty**  
このコンタクトでマルチパーティーチャットまたはスーパーバイザーの割り込みが有効になっているかどうかを示すブールフラグ。  
タイプ: ブール値

**TotalMessages**  
コンタクトのチャットメッセージの数。  
タイプ: 整数  
最小値: 0

**TotalBotMessages**  
チャットコンタクトのボットメッセージと自動メッセージの合計数。  
タイプ: 整数  
最小値: 0

**TotalBotMessageLengthInChars**  
チャットコンタクトのボットメッセージと自動メッセージの合計文字数。  
タイプ: 整数  
最小値: 0

**ConversationCloseTimeInMillis**  
最後の顧客メッセージの後にコンタクトが終了するまでにかかった時間。  
タイプ: Long  
最小値: 0

**ConversationTurnCount**  
チャットコンタクトの会話ターンの数。顧客と他の参加者間のやり取りを示します。  
タイプ: 整数  
最小値: 0

**AgentFirstResponseTimestamp**  
チャットコンタクトのエージェントの最初の応答タイムスタンプ。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

**AgentFirstResponseTimeInMillis**  
チャットコンタクトを取得した後にエージェントが応答する時間。  
タイプ: Long  
最小値: 0

### ParticipantMetrics
<a name="participantmetrics"></a>

コンタクトでの参加者のやり取りに関する情報。

**ParticipantId**  
参加者の ID。  
タイプ: 文字列  
長さ: 1-256

**ParticipantType**  
会話参加者に関する情報。参加者タイプは次のとおりです: [エージェント、顧客、スーパーバイザー]。  
タイプ: 文字列

**ConversationAbandon**  
チャット会話が参加者によって中止されたかどうかを示すブール値フラグ。  
タイプ: ブール値

**MessagesSent**  
参加者が送信したチャットメッセージの数。  
タイプ: 整数  
最小値: 0

**NumResponses**  
参加者が送信したチャットメッセージの数。  
タイプ: 整数  
最小値: 0

**MessageLengthInChars**  
参加者が送信したチャット文字の数。  
タイプ: 整数  
最小値: 0

**TotalResponseTimeInMillis**  
参加者ごとのチャット応答時間の合計。  
タイプ: Long  
最小値: 0

**MaxResponseTimeInMillis**  
参加者ごとの最大チャット応答時間。  
タイプ: Long  
最小値: 0

**LastMessageTimestamp**  
参加者による最後のチャットメッセージのタイムスタンプ。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

## Amazon Connect の問い合わせイベントに登録する
<a name="subscribe-contact-events"></a>

Amazon Connect の問い合わせイベントは、[Amazon EventBridge](https://aws.amazon.com/eventbridge/) を使用して公開され、新しいルールを作成することで、Amazon EventBridge コンソールで Amazon Connect インスタンスのいくつかのステップで有効にすることができます。イベントは順序付けされていませんが、データの使用に役立つタイムスタンプがあります。

イベントは、[ベストエフォート](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)ベースで出力されます。

Amazon Connect の問い合わせイベントに登録するには

1. Amazon EventBridge コンソールで、**[Create rule]** (ルールの作成) を選択します。

1. 次の画像に示すように、**[ルールの詳細を定義]** ページで、ルールに名前を割り当てて、**[イベントパターンを持つルール]** を選択し、**[次へ]** を選択します。  
![\[EventBridge コンソールの [ルールの詳細を定義] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/eventbridge-createrule.png)

1. **[イベントパターンを構築]** ページの **[イベントソース]** で、**[AWS イベントまたは EventBridge パートナーイベント]** が選択されていることを確認します。

1. 次の図に示すように、**サンプルイベントタイプ**で**AWS イベント**を選択し、ドロップダウンボックスから** Amazon Connect 問い合わせイベント**を選択します。  
![\[[サンプルイベント] セクション、サンプルイベントタイプは AWS イベントです。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/eventbridge-sampleevents.png)

1. [Creation method] (作成方法) で、[Use pattern form] (パターンフォームを使用する) を選択します。**[イベントパターン]** セクションで、次の図に示すように、**[AWS サービス]**、**[Amazon Connect]**、**[Amazon Connect コンタクトイベント]** を選択し、**[次へ]** を選択します。  
![\[デフォルトのルールの詳細ページの [作成方法] セクションと [イベントパターン] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/eventbridge-creationmethod.png)

1. [Select target(s)] (ターゲットを選択) ページで、Lambda 関数、SQS キュー、または SNS トピックを含む任意のターゲットを選択できます。ターゲットの設定については、「[Amazon EventBridge targets](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)」を参照してください。

1. オプションでタグを設定する **[Review and create]** (確認して作成) ページで、**[Create rule]** (ルールの作成) を選択します。

 ルールの設定の詳細については、*Amazon EventBridge ユーザーガイド*の「[Amazon EventBridge rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)」を参照してください。

## イベントタイプのストリーミングを停止する例
<a name="stop-streaming-event"></a>

次の例は、Amazon Connect から EventBridge への `CONTACT_DATA_UPDATED` イベントのストリーミングを停止する方法を示しています。

```
{
  "source": [
    "aws.connect"
  ],
  "detail-type": [
    "Amazon Connect Contact Event"
  ],
  "detail": {
    "eventType": [
      {
        "anything-but": [
          "CONTACT_DATA_UPDATED"
        ]
      }
    ]
  }
}
```

## 音声通話がエージェントに接続されている場合のコンタクトイベント例
<a name="sample-contact-event"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "contactId":"11111111-1111-1111-1111-111111111111",
        "channel":"VOICE",
        "instanceArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"INBOUND",
        "eventType":"CONNECTED_TO_AGENT",
        "agentInfo":{
          "agentArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
          "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
          "hierarchyGroups": { 
                         "level1": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a",
                        },
                        "level2": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b",
                        },
                        "level3": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c",
                        },
                        "level4": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d",
                        },
                        "level5": {
                            "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e",
                        }
                 } 
            }
        },   
         "queueInfo": {  
            "queueType":"type",
            "queueArn":"arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2021-08-04T17:29:04.000Z"
          },
         "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
         } 
    }
}
```

## 音声通話の接続が切断された場合のコンタクトイベント例
<a name="sample-contact-event-call-disconnected"></a>

次のサンプルイベントは、**[Dept]** をキーとするユーザー定義タグを持つコンタクトを示しています。`initiationMethod` が `OUTBOUND` の場合、EventBridge が受信するイベントに `queueInfo` は含まれないことに注意してください。

```
{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType": "DISCONNECTED",
        "contactId": "11111111-1111-1111-1111-111111111111",
        "initialContactId": "11111111-2222-3333-4444-555555555555",
        "previousContactId": "11111111-2222-3333-4444-555555555555",
        "channel": "Voice",
        "instanceArn": "arn:aws::connect:your-region:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod": "OUTBOUND",
        "initiationTimestamp":"2021-08-04T17:17:53.000Z",
        "connectedToSystemTimestamp":"2021-08-04T17:17:55.000Z",
        "disconnectTimestamp":"2021-08-04T17:18:37.000Z",
        "agentInfo": {
            "agentArn": "arn",
            "connectedToAgentTimestamp":"2021-08-04T17:29:09.000Z",
            "hierarchyGroups": { 
                 "level1": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901a",
                },
                "level2": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901b",
                },
                "level3": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901c",
                },
                "level4": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901d",
                },
                "level5": {
                    "arn": "arn:aws:connect:your-region:012345678901:instance/12345678-1234-1234-1234-123456789012/agent-group/abcdefgh-1234-1234-1234-12345678901e",
                }
            } 
        },
           
        "CustomerVoiceActivity": {
           "greetingStartTimestamp":"2021-08-04T17:29:20.000Z",
           "greetingEndTimestamp":"2021-08-04T17:29:22.000Z",
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890",
            "Dept":"Finance"
        }
    }
}
```

## コンタクトのプロパティを更新したときのイベント例
<a name="sample-updated-event"></a>

```
{
"version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
"detail": {
    "eventType": "CONTACT_DATA_UPDATED",
    "contactId": "the contact ID",
    "channel": "CHAT",
    "instanceArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID",
    "initiationMethod": "API",
    "queueInfo": {
        "queueArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/queue/the queue ID",
        "enqueueTimestamp": "2023-10-24T02:39:15.240Z",
        "queueType": "STANDARD"
    },
    "agentInfo": {
        "agentArn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent/the agent ID",
        "connectedToAgentTimestamp": "1970-01-01T00:00:00.001Z",
        "hierarchyGroups": {
            "level1": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level2": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level3": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            },
            "level4": {
                "arn": "arn:aws:connect:us-west-2:the account ID:instance/the instance ID/agent-group/the agent group ID"
            }
        }
    },
    "updatedProperties": ["ContactLens.ConversationalAnalytics.Configuration"],
    "initiationTimestamp": "2023-10-24T02:39:15.154Z",
    "connectedToSystemTimestamp": "1970-01-01T00:00:00.001Z",
    "tags": {
        "aws:connect:instanceId": "the instance ID"
       },
    "contactLens": {
        "conversationalAnalytics": {
            "configuration": {
                "enabled": true,
                "channelConfiguration": {
                    "analyticsModes": ["PostContact"]
                },
                "languageLocale": "en-US",
                "redactionConfiguration": {
                    "behavior": "Enable",
                    "policy": "RedactedAndOriginal",
                    "entities": ["EMAIL"],
                    "maskMode": "EntityType"
                }
            }
        }
    }
}
}
```

## ルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント
<a name="sample-routing-criteria-event-connected"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "OrExpression": [{
                       "AttributeCondition": {
                           "Name": "Technology",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 2.0,
                           "Value": "AWS Kinesis"
                       }
                    },
                    {
                       "AttributeCondition": {
                           "Name": "Language",
                           "ComparisonOperator": "NumberGreaterOrEqualTo",
                           "ProficiencyLevel": 4.0,
                           "Value": "English"
                        }
                    }],
                    "AndExpression": [{
                        "AttributeCondition": {
                            "Name": "Language",
                            "ComparisonOperator": "NumberGreaterOrEqualTo",
                            "ProficiencyLevel": 2.0,
                            "Value": "Spanish"
                        }
                    }]
                }
            }]
        }]
    }
}
```

## コンタクトでルーティングステップが期限切れになった場合のサンプルイベント
<a name="sample-routing-step-expires"></a>

```
{
    "version": "0",
    "id": "the event ID",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "the account ID",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...", 
        "contactArn", 
        "instanceArn"
    ],
    "detail": {
        "eventType":"CONTACT_DATA_UPDATED",
        "contactId":"12345678-1234-1234-1234-123456789012",
        "channel":"CHAT",
        "instanceArn":"arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "initiationMethod":"API",
        "queueInfo":{
            "queueArn":"arn:aws:connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "enqueueTimestamp":"2023-11-01T18:33:03.062Z",
            "queueType":"STANDARD"
        },
        "updatedProperties":["RoutingCriteria.Step.Status"],
        "initiationTimestamp":"2023-11-01T18:33:00.716Z",
        "connectedToSystemTimestamp":"2023-11-01T18:33:01.736Z",
        "tags":{
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012"
        },
        "routingCriteria":{
            "steps":[{
                "expiry":{
                    "durationInSeconds":50,
                    "expiryTimestamp":"2023-11-01T18:34:54.275Z"
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Location",
                        "value":"AZ",
                        "proficiencyLevel":3.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"EXPIRED"
            },
            {
                "expiry":{
                    "durationInSeconds":10
                },
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":4.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"ACTIVE"
            },
            {
                "expression":{
                    "attributeCondition":{
                        "name":"Language",
                        "value":"Spanish",
                        "proficiencyLevel":1.0,
                        "comparisonOperator":"NumberGreaterOrEqualTo"
                    }
                },
                "status":"INACTIVE"
            }],
            "activationTimestamp":"2023-11-01T18:34:04.275Z",
            "index":1
        }
    }
}
```

## 顧客が設定したルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント
<a name="sample-contact-event-voice-call-routing-criteria"></a>

```
{
    "version": "0",
    "id": "abcabcab-abca-abca-abca-abcabcabcabc",
    "detail-type": "Amazon Connect Contact Event",
    "source": "aws.connect",
    "account": "111122223333",
    "time": "2021-08-04T17:43:48Z",
    "region": "your-region",
    "resources": [
        "arn:aws:...",
        "contactArn",
        "instanceArn"
    ],
    "detail": {
        "ContactId": "12345678-1234-1234-1234-123456789012",
        "Channel": "VOICE",
        "InstanceArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012",
        "InitiationMethod": "INBOUND",
        "EventType": "CONNECTED_TO_AGENT",
        "AgentInfo": {
            "AgentArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/agent/12345678-1234-1234-1234-123456789012",
            "ConnectedToAgentTimestamp": "2021-08-04T17:29:09.000Z"
        },
        "QueueInfo": {
            "QueueType": "type",
            "QueueArn": "arn:aws::connect:us-west-2:123456789012:instance/12345678-1234-1234-1234-123456789012/queue/12345678-1234-1234-1234-123456789012",
            "EnqueueTimestamp": "2021-08-04T17:29:04.000Z"
        },
        "tags": {
            "aws:connect:instanceId":"12345678-1234-1234-1234-123456789012",
            "aws:connect:systemEndpoint":"+11234567890"
        },
        "RoutingCriteria": [{
            "ActivationTimestamp": "2021-08-04T17:29:04.000Z",
            "Index": 0,
            "Steps": [{
                "Status": "JOINED",
                "Expiry": {
                    "DurationInSeconds": 60,
                },
                "Expression": {
                    "AttributeCondition": {
                        "ComparisonOperator": "Match",
                        "MatchCriteria": {
                            "AgentsCriteria": {
                                "AgentIds": ["AGENT_1"]
                            }
                        }
                    }
                }
            }]
        }]
    }
}
```