問い合わせイベントデータモデル問い合わせタイムスタンプ Amazon Connect の問い合わせイベントに登録するイベントタイプのストリーミングを停止する例音声通話がエージェントに接続されている場合のコンタクトイベント例音声通話の接続が切断された場合のコンタクトイベント例コンタクトデータ更新のイベント例音声通話がエージェントに接続されている場合のコンタクトイベント例コンタクトでルーティングステップが期限切れになった場合のサンプルイベントルーティング条件を使用して顧客が提供するエージェントに音声通話が接続された場合の問い合わせイベントの例

Amazon Connect 問い合わせイベント

Amazon Connect では、Amazon Connect コンタクトセンターへの問い合わせ (音声通話、チャット、タスク) イベントのほぼリアルタイムでのストリームに登録できます。

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

内容

問い合わせイベントデータモデル
問い合わせタイムスタンプ
Amazon Connect の問い合わせイベントに登録する
イベントタイプのストリーミングを停止する例
音声通話がエージェントに接続されている場合のコンタクトイベント例
音声通話の接続が切断された場合のコンタクトイベント例
コンタクトのプロパティを更新したときのイベント例
ルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント
コンタクトでルーティングステップが期限切れになった場合のサンプルイベント
ルーティング条件を使用して顧客が提供するエージェントに音声通話が接続された場合の問い合わせイベントの例

問い合わせイベントデータモデル

問い合わせイベントはで生成されますJSON。イベントタイプごとに、ルールで設定されているように、BLOB JSON が選択したターゲットに送信されます。利用できる問い合わせイベントは次のとおりです。

AMD_DISABLED - 留守番電話の検出は無効になっています。
INITIATED - 音声通話、チャット、またはタスクが開始または転送されます。
CONNECTED_TO_SYSTEM - 問い合わせがメディアを確立している (例えば、人物またはボイスメールによって応答された）。このイベントは AnsweringMachineDetectionStatus のいずれのコードでも生成されます。

注記
このイベントは発信通話 (Amazon Connect アウトバウンドキャンペーンを含む) タスク、およびチャットについて生成されます。
CONTACT_DATA_UPDATED - 音声通話、チャット、またはタスクで 1 つ以上の問い合わせプロパティが更新されました。スケジュールされたタイムスタンプ (タスクのみ）、ユーザー定義の属性とタグ、ルーティング条件が更新されるか、ステップの有効期限が切れています。また、Contact Lens が特定の問い合わせに対して有効になっているかどうか。
QUEUED - 音声通話、チャット、またはタスクは、エージェントに割り当てられるようにキューに入れられます。
CONNECTED_TO_AGENT - 音声通話、チャット、またはタスクがエージェントに接続されている。
DISCONNECTED - 音声通話、チャット、またはタスクが切断されている。発信通話の場合、ダイヤル試行は成功しないか、試行は接続されていますが、呼び出しが応答しないか、試行によってSITトーンがになります。

切断イベントとは、次の場合です。
- チャット、またはタスクが切断された。
- フローアクションの結果として、タスクが切断された。
- タスクの有効期限切れ。タスクが 7 日以内に完了しない場合、タスクは自動的に切断されます。
PAUSED - アクティブなタスクコンタクトが一時停止されました。
RESUMED - 一時停止したタスクコンタクトが再開されました。

AgentInfo

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

AgentArn

エージェントアカウントの Amazon リソースネーム (ARN）。

タイプ: ARN

HierarchyGroups

エージェントのエージェント階層グループ。

タイプ: ARN

AttributeCondition

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

Name

事前定義された属性の名前。

タイプ: String

長さ: 1～64

Value

事前定義された属性の値。

タイプ: String

長さ:1～64

ComparisonOperator

条件の演算子。

タイプ: String

有効な値： NumberGreaterOrEqualTo

ProficiencyLevel

条件の習熟度レベル。

タイプ: Float

有効な値: 1.0、2.0、3.0、4.0、5.0

MatchCriteria

を定義するオブジェクト AgentsCriteria。

型: MatchCriteria オブジェクト

AgentsCriteria

を定義するオブジェクトagentIds。

型: AgentsCriteria オブジェクト

AgentIds

エージェント ID でエージェントのリストを指定するオブジェクト。

型: 文字列の配列

長さの制限: 最大長は 256 です

Campaign

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

タイプ: キャンペーンのオブジェクト

問い合わせイベント

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

ContactId

コンタクトの識別子。

型: 文字列

長さ: 1-256

InitialContactId

最初の問い合わせの識別子。

型: 文字列

長さ: 1-256

RelatedContactId

この問い合わせ contactId に関連する。

タイプ: String

長さ: 最小は 1 です｡最大 256。

PreviousContactId

転送されたコンタクトの元の識別子。

型: 文字列

長さ: 1-256

Channel

チャネルのタイプ。

タイプ: VOICE、CHAT または TASK

InstanceArn

エージェントのユーザーアカウントが作成される Amazon Connect インスタンスの Amazon リソースネーム (ARN）。

タイプ: ARN

InitiationMethod

コンタクトが開始された方法を示します。

有効な値:

INBOUND: 顧客がコンタクトセンターとの音声 (電話) 問い合わせを開始しました。
OUTBOUND: 問い合わせコントロールパネル () からエージェントが開始したアウトバウンド音声通話を表しますCCP。
TRANSFER: のクイック接続を使用して、問い合わせがエージェントによって別のエージェントまたはキューに転送されましたCCP。これにより、新しい問い合わせレコードが作成されます。
CALLBACK: コールバックフローの一環として顧客に連絡されました。このシナリオ InitiationMethod のの詳細については、「」を参照してくださいAmazon Connect のリアルタイムメトリクスでキューに入れられたコールバック。
API: 問い合わせはによって Amazon Connect で開始されましたAPI。これは、を使用して作成してエージェントにキューに入れたアウトバウンドの問い合わせであったりStartOutboundVoiceContactAPI、カスタマーがコンタクトセンターと開始したライブチャットであったり、 StartChatContact を呼び出したりAPI、を呼び出してカスタマーが開始したタスクであったりしますStartTaskContactAPI。
QUEUE_TRANSFER: 問い合わせが 1 つのキューである間、フローブロックを使用して別のキューに転送されました。
EXTERNAL_OUTBOUND: エージェントが、 CCPまたはフローブロックでクイック接続を使用して、コンタクトセンターへの外部参加者との音声 (電話) 問い合わせを開始しました。
MONITOR: スーパーバイザーがエージェントでモニターを開始しました。スーパーバイザーは、断りなくエージェントやお客様をモニタリングしたり、会話に割り込んだりすることができます。
DISCONNECT: 切断フローの設定ブロックがトリガーされると、切断イベント後に実行するフローを指定します。

切断イベントとは、次の場合です。
- チャット、またはタスクが切断された。
- フローアクションの結果として、タスクが切断された。
- タスクの有効期限切れ。タスクが 7 日以内に完了しない場合、タスクは自動的に切断されます。
切断イベントが発生すると、対応するコンテンツフローが実行されます。切断フローの実行中に新しい問い合わせが作成された場合、その新しい問い合わせの開始方法はですDISCONNECT。

DisconnectReason コード

問い合わせが終了した理由を示します。メディア接続に失敗したアウトバウンドキャンペーンのコンタクトで利用できます。

有効な値:

OUTBOUND_DESTINATIONENDPOINT_ERROR_: 現在の設定では、この送信先をダイヤルすることはできません (例えば、対象外のインスタンスからエンドポイントの送信先を呼び出す）。
OUTBOUND_RESOURCE_ERROR: インスタンスにアウトバウンドコールを実行するための十分なアクセス許可がないか、必要なリソースが見つかりませんでした。
OUTBOUND_ATTEMPT_FAILED: を呼び出すための不明なエラー、無効なパラメータ、または不十分なアクセス許可がありましたAPI。
EXPIRED: 十分なエージェントが利用できないか、このような呼び出しに十分な通信容量がありません。

AnsweringMachineDetectionStatus

コンタクトがに接続されている場合に、アウトバウンドキャンペーンコールが実際にどのように破棄されるかを示します Amazon Connect。

型: 文字列

有効な値:

HUMAN_ANSWERED: ダイヤルされた番号は担当者が応答しました。
VOICEMAIL_BEEP: ダイヤルされた番号は、ビープ音付きのボイスメールによって応答されました。
VOICEMAIL_NO_BEEP: ダイヤルされた番号は、ビープ音なしのボイスメールによって応答されました。
AMD_UNANSWERED: ダイヤルされた番号は鳴り続けましたが、応答がありませんでした。
AMD_UNRESOLVED: ダイヤルされた番号は接続されましたが、留守番電話の検出では、担当者が応答したのか、ボイスメールが応答したのか判断できませんでした。
AMD_NOT_APPLICABLE: 呼び出し音が鳴る前に通話が切れました。検出したメディアはありませんでした。
SIT_TONE_BUSY: ダイヤルされた番号は通話中でした
SIT_TONE_INVALID_NUMBER: ダイヤルされた番号は有効な番号ではありませんでした。
SIT_TONE_DETECTED: 特別な情報トーン (SIT) が検出されました。
FAX_MACHINE_DETECTED: FAX 機が検出されました。
AMD_ERROR: ダイヤルされた番号は接続されたが、留守番電話の検出にエラーがありました。

EventType

発行されるイベントのタイプ。

型: 文字列

有効な値: INITIATED、CONNECTED_TO_SYSTEM、CONTACT_DATA_UPDATED、QUEUED、CONNECTED_TO_AGENT、DISCONNECTED、PAUSED、 RESUMED

UpdatedProperties

更新されたプロパティの型。

型: 文字列

有効な値： ScheduledTimestamp、 UserDefinedAttributes、 ContactLensConversationalAnalytics。設定、タグ

AgentInfo

問い合わせが割り当てられたエージェント。

型: AgentInfo オブジェクト

QueueInfo

問い合わせが配置されたキュー。

型: QueueInfo オブジェクト

ContactLens

フローで Contact Lens が有効になっている場合、Contact Lens の情報。

タイプ: ContactLens オブジェクトの詳細については、Amazon Connect APIリファレンス」の「フロー言語」セクションの UpdateContactRecordingBehaviorアクションを参照してください。

SegmentAttributes

属性マップを使用して個別のコンタクトのセグメントに保存されるシステム定義のキー値のペアのセット。属性は標準 Amazon Connect 属性であり、フローでアクセスできます。属性キーには英数字、「-」、「_」文字のみを使用できます。

このフィールドはチャネルサブタイプを表示するのに使用できます。例えば、connect:Guide、connect:SMS などです。

タイプ: SegmentAttributes

メンバー: SegmentAttributeName、SegmentAttributeValue

Tags

コンタクトに関連付けられているタグ。これには、 AWS 生成されたタグとユーザー定義タグの両方が含まれます。

型: 文字列間のマッピング

CustomerVoiceActivity

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

GreetingStartTimestamp

アウトバウンド音声通話からの顧客の挨拶の開始時刻をUTC計測する日時。

タイプ: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

GreetingEndTimestamp

アウトバウンド音声通話からの顧客の挨拶の終了をUTC計測する日時。

タイプ: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

Expiry

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

DurationInSeconds

ルーティングステップの有効期限が切れる前の待機秒数。

タイプ: Integer

最小値: 0

ExpiryTimestamp

ルーティングステップの有効期限が切れた時刻を示すタイムスタンプ。

タイプ: String (yyyy-mm-ddThh:mm:ssZ)

Expression

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

AndExpression

一緒にAND処理されるルーティング式のリスト。

タイプ: Expression

最小値: 0

OrExpression

OR で結合されるルーティング式のリスト。

タイプ: Expression

AttributeCondition

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

タイプ: AttributeCondition

QueueInfo

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

QueueArn

キューの Amazon リソースネーム (ARN）。

型: 文字列

QueueType

キューのタイプ。

型: 文字列

RoutingCriteria

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

ActivationTimestamp

ルーティング条件がアクティブに設定されるタイミングを示すタイムスタンプ。コンタクトがキューに転送されると、ルーティング条件が有効になります。

ActivationTimestamp は、エージェントキュー内の問い合わせのルーティング条件がアクティブ化されていなくても、エージェントキュー内の問い合わせのルーティング条件に設定されます。

タイプ: String (yyyy-mm-ddThh:mm:ssZ)

Index

ルーティング条件のインデックスに関する情報。

タイプ: Integer

最小値: 0

Steps

ルーティングステップのリスト。

タイプ: ステップのオブジェクトのリスト

長さ: 1～5

Steps

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

Status

ルーティングのステップのステータスを表します。

タイプ: String

有効な値: EXPIRED, ACTIVE, JOINED, INACTIVE, DEACTIVATED, INTERRUPTED

Expression

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

タイプ: Expression

Expiry

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

タイプ: Expiry

問い合わせタイムスタンプ

InitiationTimestamp

この問い合わせが開始された日時UTC。アウトバウンドキャンペーンの一部として音声問い合わせが開始された場合、 InitiationTimestampは、開始されたイベントの問い合わせが開始されたときに表示され、後続のイベントで通話が開始されたときに更新されます。

タイプ: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

ConnectedToSystemTimestamp

カスタマーエンドポイントが Amazon Connect に接続された日時UTC。

EnqueueTimestamp

問い合わせがキューに追加された日時UTC。

タイプ: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

ConnectedToAgentTimestamp

問い合わせがエージェントに接続された日時UTC。

タイプ: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

DisconnectTimestamp

カスタマーエンドポイントが Amazon Connect から切断された日時 UTC

タイプ: 文字列 (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')

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

イベントは、ベストエフォートベースで出力されます。

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

Amazon EventBridge コンソールで、ルールの作成 を選択します。
次の画像に示すように、[ルールの詳細を定義] ページで、ルールに名前を割り当てて、[イベントパターンを持つルール] を選択し、[次へ] を選択します。
ビルドイベントパターンページのイベントソース で、AWS イベントまたは EventBridgeパートナーイベントが選択されていることを確認します。
次の図に示すように、サンプルイベントタイプ AWS でイベント を選択し、ドロップダウンボックスから Amazon Connect 問い合わせイベントを選択します。
[Creation method] (作成方法) で、[Use pattern form] (パターンフォームを使用する) を選択します。[イベントパターン] セクションで、[AWS サービス]、[Amazon Connect]、[Amazon Connect コンタクトイベント] を選択し、[次へ] を選択します。
ターゲットの選択ページで、Lambda 関数、SQSキュー、またはSNSトピックを含む任意のターゲットを選択できます。ターゲットの設定については、Amazon EventBridge はをターゲットとします。
オプションでタグを設定する [Review and create] (確認して作成) ページで、[Create rule] (ルールの作成) を選択します。

ルールの設定の詳細については、「Amazon ユーザーガイド」の「Amazon EventBridge ルール」を参照してください。 EventBridge

イベントタイプのストリーミングを停止する例

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


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

音声通話がエージェントに接続されている場合のコンタクトイベント例


{
    "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"
         } 
    }
}

音声通話の接続が切断された場合のコンタクトイベント例

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


{
    "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"
        }
    }
}

コンタクトのプロパティを更新したときのイベント例


{
"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"
                }
            }
        }
    }
}
}

ルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント


{
    "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"
                        }
                    }]
                }
            }]
        }]
    }
}

コンタクトでルーティングステップが期限切れになった場合のサンプルイベント


{
    "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
        }
    }
}

ルーティング条件を使用して顧客が提供するエージェントに音声通話が接続された場合の問い合わせイベントの例


{
    "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"]
                            }
                        }
                    }
                }
            }]
        }]
    }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

エージェントイベントが Amazon Connect でデータモデルをストリーミングする

問い合わせレコードデータモデル

Amazon Connect 問い合わせイベント

内容

問い合わせイベントデータモデル

注記

イベントオブジェクト

AgentInfo

AttributeCondition

Campaign

問い合わせイベント

CustomerVoiceActivity

Expiry

Expression

QueueInfo

RoutingCriteria

Steps

問い合わせタイムスタンプ

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

イベントタイプのストリーミングを停止する例

音声通話がエージェントに接続されている場合のコンタクトイベント例

音声通話の接続が切断された場合のコンタクトイベント例

コンタクトのプロパティを更新したときのイベント例

ルーティング条件を使用して音声通話がエージェントに接続された際のサンプルコンタクトイベント

コンタクトでルーティングステップが期限切れになった場合のサンプルイベント

ルーティング条件を使用して顧客が提供するエージェントに音声通話が接続された場合の問い合わせイベントの例