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

# Amazon Connect の問い合わせレコードのデータモデル
<a name="ctr-data-model"></a>

**注記**  
サポート終了通知: 2026 年 5 月 20 日に、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Amazon Connect 機能にアクセスしたり、Voice ID リソースにアクセスしたりできなくなります。詳細については、「[Amazon Connect Voice ID のサポート終了](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)」を参照してください。

この記事では、 Amazon Connect 問い合わせレコードのデータモデルについて説明します。問い合わせレコードは、コンタクトセンターにある問い合わせに関連付けられているイベントをキャプチャします。リアルタイムおよび履歴メトリクスは、問い合わせレコードでキャプチャされたデータに基づいています。

## 重要事項
<a name="important-things-to-know-ctr-data-model"></a>
+ 新機能を継続的にリリースしているため、問い合わせレコードデータモデルに新しいフィールドが追加されています。データモデルに加えた変更は、すべて下位互換性があります。アプリケーションを開発するときには、問い合わせレコードデータモデルへの新しいフィールドの追加を無視するように構築することをお勧めします。これにより、アプリケーションの耐障害性が確保されます。
+ Amazon Connect は、少なくとも 1 回問い合わせレコードを配信します。問い合わせレコードは、最初の配信後に新しい情報が到着するなど、複数の理由で再度配信される場合があります。例えば、[update-contact-attributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/connect/update-contact-attributes.html) CLI コマンドを使用してコンタクトレコードを更新すると、 Amazon Connect によって新しいコンタクトレコードが配信されます。この問い合わせレコードは関連付けられた問い合わせが開始されてから 24 か月間使用可能です。

  問い合わせレコードエクスポートストリームを使用するシステムを構築する場合は、問い合わせの重複した問い合わせレコードを確認するロジックを必ず含めてください。**LastUpdateTimestamp** プロパティを使用して、コピーに以前のコピーよりも新しいデータが含まれているかどうかを判断します。次に、重複排除に **ContactId** プロパティを使用します。
+ 一意の連絡先に対して実行されるすべてのアクションがイベントを生成します。これらのイベントは、連絡先レコードのフィールドまたは属性として表示されます。問い合わせのアクションの数が内部ストレージの制限などのしきい値を超えると、それ以降のアクションはその問い合わせレコードに表示されなくなります。
+ 問い合わせレコードの保持期間と、問い合わせレコードの属性セクションの最大サイズについては、「[Amazon Connect 機能の仕様](feature-limits.md)」を参照してください。
+ 問い合わせレコードが作成されるタイミング (すなわち、エクスポートまたはデータレポートに使用可能になるタイミング) については、「[コンタクトレコードのイベント](about-contact-states.md#ctr-events)」を参照してください。
+ テレフォニーコールやケース属性を含むすべての問い合わせ属性のリストについては、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。
+ 以前は、*問い合わせレコード*を*問い合わせトレースレコード (CTR)* と呼んでいました。これからは*問い合わせレコード*のみを使用します。2 つの用語に違いはありません。

## Agent
<a name="ctr-Agent"></a>

着信問い合わせを受け入れたエージェントに関する情報。

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

**AgentInteractionDuration**  <a name="AgentInteractionDuration-CTR"></a>
エージェントが顧客とやり取りした時間 (秒単位)。アウトバウンドコールの場合、これは、顧客がいなくてもエージェントが連絡先に接続された時間を整数秒単位で表したものです。  
これには、エージェントの一時停止時間 (タスクにのみ適用) は含まれません。  
型: Integer  
最小値: 0

**AgentPauseDuration**  <a name="AgentPauseDuration-CTR"></a>
エージェントに割り当てられたタスクが一時停止された整数の秒単位の時間。  
型: Integer  
最小値: 0

**AfterContactWorkDuration**  <a name="AfterContactWorkDuration-CTR"></a>
`AfterContactWorkStartTimestamp` と `AfterContactWorkEndTimestamp` との時間差 (整数秒)。  
型: Integer  
最小値: 0

**AfterContactWorkEndTimestamp**  
エージェントが問い合わせの [問い合わせ後作業] の実行を停止した日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

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

**ARN**  
エージェントの Amazon リソースネーム。  
型: ARN

**Capabilities**  
エージェントの機能に関する情報。  
型: Capabilities

**ConnectedToAgentTimestamp**  
コンタクトがエージェントに接続された日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**CustomerHoldDuration**  <a name="CustomerHoldDuration-CTR"></a>
エージェントに接続されている間に顧客が経過した時間 (整数秒)。  
型: Integer  
最小値: 0

**AgentInitiatedHoldDuration**  <a name="AgentInitiatedHoldDuration-CTR"></a>
特定のエージェントが顧客を保留にした合計時間 (秒)。マルチパーティーシナリオでは、エージェント A が顧客を保留してから通話を終了し、エージェント B が後で顧客を保留解除した場合、残りの保留期間はエージェント B に起因します。  
CustomerHoldDuration と AgentInitiatedHoldDuration の主な違いは次のとおりです。  
+ CustomerHoldDuration は、顧客の視点からすべての保留時間を追跡します。
+ AgentInitiatedHoldDuration は、特定のエージェントによって開始された保留時間を追跡するため、マルチパーティーコールシナリオで特に役立ちます。
マルチパーティー以外のシナリオの場合、CustomerHoldDuration と AgentInitiatedHoldDuration は同じになります。  
型: Integer  
最小値: 0

**DeviceInfo**  
エージェントのデバイスに関する情報。  
型: [DeviceInfo](#ctr-deviceinfo) 

**HierarchyGroups**  
エージェントのエージェント階層グループ。  
タイプ: [AgentHierarchyGroups](#ctr-AgentHierarchyGroups)

**LongestHoldDuration**  
顧客がエージェントに保留された最長時間 (整数秒)。  
型: Integer  
最小値: 0

**NumberOfHolds**  
エージェントに接続されている間に顧客が保留された回数。  
型: Integer  
最小値: 0

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

**RoutingProfile**  
エージェントのルーティングプロファイル。  
タイプ: [RoutingProfile](#ctr-RoutingProfile)

**Username**  
エージェントのユーザー名。  
型: String  
長さ: 1～100

**StateTransitions**  
スーパーバイザーの状態遷移。  
型: [StateTransitions](#ctr-StateTransitions) の配列。

## AgentHierarchyGroup
<a name="ctr-AgentHierarchyGroup"></a>

エージェント階層グループに関する情報。

**ARN**  
グループの Amazon リソースネーム (ARN)。  
型: ARN

**GroupName**  
階層グループの名前。  
型: String  
長さ: 1-256

## AgentHierarchyGroups
<a name="ctr-AgentHierarchyGroups"></a>

エージェント階層に関する情報。階層は最大 5 つのレベルで設定できます。

**Level1**  
エージェント階層のレベル 1 のグループ。  
タイプ: [AgentHierarchyGroup](#ctr-AgentHierarchyGroup)

**Level2**  
エージェント階層のレベル 2 のグループ。  
タイプ: [AgentHierarchyGroup](#ctr-AgentHierarchyGroup)

**Level3**  
エージェント階層のレベル 3 のグループ。  
タイプ: [AgentHierarchyGroup](#ctr-AgentHierarchyGroup)

**Level4**  
エージェント階層のレベル 4 のグループ。  
タイプ: [AgentHierarchyGroup](#ctr-AgentHierarchyGroup)

**Level5**  
エージェント階層のレベル 5 のグループ。  
タイプ: [AgentHierarchyGroup](#ctr-AgentHierarchyGroup)

## AttributeCondition
<a name="ctr-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

## ChatMetrics
<a name="ctr-ChatMetrics"></a>

エージェント、ボット、顧客がチャットコンタクトでやり取りする方法に関する情報。ChatMetrics には、[ContactMetrics](#ctr-ContactMetrics)、[CustomerMetrics](#ctr-CustomerMetrics)、[AgentMetrics](#ctr-AgentMetrics) のサブカテゴリが含まれます。

## ContactMetrics
<a name="ctr-ContactMetrics"></a>

コンタクトレベルでの参加者の全体的なやり取りに関する情報。これには、次のメトリクスが含まれます。

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

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

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

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

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

**ConversationTurnCount**  
チャットコンタクトの会話ターンの数。  
型: Integer  
最小値: 0

**AgentFirstResponseTimestamp**  
チャットコンタクトのエージェントの最初の応答タイムスタンプ。  
タイプ: String (yyyy-mm-ddThh:mm:ssZ)

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

## CustomerMetrics
<a name="ctr-CustomerMetrics"></a>

コンタクトにおける顧客とのやり取りに関する情報。これには、次のメトリクスが含まれます。

**Type**  
 [ParticipantMetrics](#ctr-ParticipantMetrics) オブジェクト

## AgentMetrics
<a name="ctr-AgentMetrics"></a>

コンタクトにおけるエージェントとのやり取りに関する情報。これには、次のメトリクスが含まれます。

**Type**  
 [ParticipantMetrics](#ctr-ParticipantMetrics) オブジェクト

## ParticipantMetrics
<a name="ctr-ParticipantMetrics"></a>

チャットコンタクトの個々の参加者のメトリクスに関する情報。

**ParticipantId**  
参加者の参加者 ID。  
型: String  
長さ: 1-256

**ParticipantType**  
会話参加者に関する情報。次の参加者タイプがサポートされています: エージェント、顧客、スーパーバイザー。  
型: String

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

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

**NumResponses**  
参加者が送信した応答の数。  
型: Integer  
最小値: 0

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

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

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

**LastMessageTimestamp**  
参加者による最後のチャットメッセージのタイムスタンプ。  
タイプ: String (yyyy-mm-ddThh:mm:ssZ)

## ContactDetails
<a name="ctr-contact-details"></a>

問い合わせ内で軽く入力されるユーザー定義の属性が含まれます。

このオブジェクトは、タスクの問い合わせにのみ使用されます。音声もしくはチャットの問い合わせ、またはフローブロックで問い合わせ属性が設定されているタスクについては、[ContactTraceRecord](#ctr-ContactTraceRecord) Attributes オブジェクトを確認します。

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

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

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

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

## ContactTraceRecord
<a name="ctr-ContactTraceRecord"></a>

問い合わせに関する情報。

システム定義のすべてのセグメント属性については、「[セグメント属性](connect-attrib-list.md#attribs-segment-attributes)」を参照してください。

**Agent**  
この問い合わせが正常にエージェントに接続されている場合、これはエージェントに関する情報です。  
タイプ: [Agent](#ctr-Agent)

**Customer**  
コンタクトセンターに連絡するユーザー (顧客) に関する情報。  
タイプ: [Customer](#ctr-Customer)

**AgentConnectionAttempts**  
この問い合わせをエージェントに接続 Amazon Connect しようとした回数。  
型: Integer  
最小値: 0

**Attributes**  
キーと値のマップ形式の、問い合わせ属性。  
型: Attributes  
メンバー: `AttributeName`、`AttributeValue`

**AWSAccountId**  
問い合わせを所有する AWS アカウントの ID。  
型: String

**AWSContactTraceRecordFormatVersion**  
レコード形式バージョン。  
型: String

**Channel**  
問い合わせがコンタクトセンターに到達した方法。  
有効な値: `VOICE`、`CHAT`、`TASK`、`EMAIL`

**ConnectedToSystemTimestamp**  
カスタマーエンドポイントが接続された日時 Amazon Connectを UTC 時間で表します。`INBOUND` の場合、これは InitiationTimestamp に一致します。`OUTBOUND`、`CALLBACK`、`API` の場合、これは顧客のエンドポイントが応答する日時です。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**ContactId**  
コンタクト ID。  
型: String  
長さ: 1-256

**ContactLens**  
このコンタクトに適用される Contact Lens の機能に関する情報。  
タイプ: [ContactLens](#ctr-ContactLens) 

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

**CustomerEndpoint**  
顧客または外部サードパーティー参加者のエンドポイント。  
タイプ: [Endpoint](#ctr-endpoint)、`EMAIL_ADDRESS`

**CustomerVoiceActivity**  
このフィールドは、アウトバウンドキャンペーンでのみ利用可能な留守番電話検出 (AMD) を使用した通話に対して入力されます。それ以外の場合、このフィールドは null です。  
`CustomerVoiceActivity` オブジェクトには以下のプロパティが含まれています。    
**GreetingStartTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの開始を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')  
**GreetingEndTimestamp**  
アウトバウンド音声コールからの顧客のあいさつの終了を測定する日時 (UTC 時間)。  
型: 文字列 (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

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

**DisconnectReason**  
問い合わせが終了した理由を示します。このデータは、現在、 Amazon Connect コンタクトレコードストリームおよび **[コンタクトの詳細]** ページのみで使用できます。  
切断理由は、さまざまなテレフォニープロバイダー間の応答を統一された切断理由に標準化します。これにより、無効な番号、通話拒否、スパムブロック (一時的および永続的) などの問題を特定できます。これらの最終的なテレフォニーイベントを使用すると、通話終了の処理方法についてデータ駆動型の意思決定を行うことができます。  
型: String  
音声問い合わせには、次の接続解除理由があります。  
+ `TELECOM_BUSY` – サードパーティーを呼び出そうとすると、ネットワークビジーシグナルが返されます。これは、現在呼び出そうとしているエンドポイントが、現在通話中であるため、通話できないことを示します。
+ `TELECOM_NUMBER_INVALID` – 呼び出そうとしている番号に適切な E164 形式がないか、呼び出そうとしている番号が存在しないか、使用されていません。
+ `TELECOM_POTENTIAL_BLOCKING` – 顧客を呼び出そうとすると、ネットワークレベルブロックに基づいて現在ブロックされている数を示すレスポンスを、複数のネットワークから受け取ります。
**注記**  
Amazon Connect により、顧客は独自のベストプラクティスに基づいてスパムブロックにフラグを付けることができます。スパムブロックにはグローバルな統合がないため、このカテゴリではごく少数の誤検出が発生する可能性があります。Amazon Connect では、呼び出しの約 1% がこの結果になることを想定しています。ブロックが発生した場合は、呼び出しているキャリアネットワークを確認することをお勧めします。また、呼び出しを試みているキャリアに連絡して、呼び出しがブロックされた理由を特定する必要があります。ルールがブロックされているため、ユーザーに代わってネットワークをブロック解除 AWS することはできません。
+ `TELECOM_UNANSWERED` – Amazon Connect は、複数のルート経由で呼び出しを配信しようとし、現在、ネットワークまたはハンドセットのいずれかからメッセージを受信して、現時点でシステムが呼び出しを配信できないことを確認します。
+ `TELECOM_TIMEOUT` – 呼び出しの試行が複数のネットワークで発生し、呼び出し音が 60 秒に達すると、システムはこの呼び出し試行のタイムアウトポイントに達したことを報告します。
+ `TELECOM_ORIGINATOR_CANCEL` – これは、接続が確立される前に発信側によって呼び出しがキャンセルされた場合に発生します。受信通話の場合、これは顧客が接続前に呼び出しをキャンセルしたときに発生します。発信通話の場合、これは、エージェント/API ユーザーが接続前に呼び出しをキャンセルした場合、または 60 秒経っても呼び出しに応答がない場合に発生します。
+ `TELECOM_PROBLEM` – 複数のネットワーク経由でこの顧客に到達しようとし、宛先ネットワークに問題があることを示す応答を PSTN から受信する場合、エンドネットワークには到達できないが、番号は有効であると思われる場合は、この理由コードが適用されます。
**注記**  
Amazon Connect は、カバレッジガイドに示されるように、複数のプロバイダーとのアウトバウンド設定の一部として呼び出しを試みます。ガイドにマルチキャリア設定が示されている場合、複数のネットワークの結果にサードパーティーネットワークへの問題リンクが表示されます。Amazon Connect では、平均して約 2% の呼び出しがこの結果になることを想定しています。通信問題を AWS Support に報告する必要はありません。これは Amazon Connect の障害を表すものではありません。
+ `CUSTOMER_NEVER_ARRIVED` – 受信ウェブ通話コンタクトを作成すると、顧客が指定された期間内に接続しない場合、Amazon Connect は自動的にコンタクトを終了します。
+ `THIRD_PARTY_DISCONNECT` – 呼び出しが、通話中の顧客とエージェントに接続された場合、その呼び出しのリモート側が切断を開始すると、このフラグがトリガーされます。
+ `CUSTOMER_DISCONNECT` – 呼び出しが、通話中の顧客とエージェントに接続された場合、その呼び出しの顧客側が切断を開始すると、このフラグがトリガーされます。この状態は、受信不良と意図的な切断を区別できません。
+ `AGENT_DISCONNECT` – 呼び出しが、通話中の顧客とエージェントに接続された場合、その呼び出しのエージェント側が切断を開始すると、このフラグがトリガーされます。
+ `BARGED` – 呼び出しが、通話中の顧客とエージェントに接続されましたが、マネージャーがエージェントをその通話から切断した場合です。
+ `CONTACT_FLOW_DISCONNECT` – コンタクトフロー内の切断/切断ブロックによってコンタクトが終了したことを示します。
+ `OTHER` – API コールが開始する切断など、上記のコードに含まれていない切断理由を示します。
アウトバウンドキャンペーンの [音声] コンタクトの切断の理由には、次があります。  
+ `OUTBOUND_DESTINATION_ENDPOINT_ERROR`: 現在の設定では、この宛先にダイヤルすることはできません (例えば、不適切なインスタンスからエンドポイント宛先を呼び出すなど)。
+ `OUTBOUND_RESOURCE_ERROR`: インスタンスの通話を発信するためのアクセス権限が不十分であるか、必要なリソースが見つかりませんでした。
+ `OUTBOUND_ATTEMPT_FAILED`: 不明なエラー、無効なパラメータ、または API を呼び出すためのアクセス権限が不十分でした。
+ `OUTBUND_PREVIEW_DISCARDED`: コンタクトは作成されず、受信者はリストから削除されました。これ以上の試行は行われません。
+ `EXPIRED`: 可能なエージェントが不足しているか、このような通話数を処理する通信容量が不足しています。
チャットの切断理由には、次のようなものがあります。  
+ `AGENT_DISCONNECT`: エージェントがチャットを明示的に切断または拒否します。
+ `CUSTOMER_DISCONNECT`: お客様が明示的に接続を切断します。
+ `AGENT_NETWORK_DISCONNECT`: ネットワークの問題によりエージェントがチャットから切断されました。
+ `CUSTOMER_CONNECTION_NOT_ESTABLISHED`: 顧客はチャットを開始しますが、接続 (ウェブソケットまたはストリーミング) を取得しません。
+ `EXPIRED`: 設定されたチャット期間の有効期限が切れたため、チャットが切断されました。
+ `CONTACT_FLOW_DISCONNECT`: チャットが切断されたか、フローによって完了しました。
+ `API`: StopContact API が呼び出され、チャットが終了しました。
+ `BARGED`: マネージャーがエージェントを割り込まれたチャットから切断しました。
+ `IDLE_DISCONNECT`: アイドル状態の参加者が原因で切断します。
+ `THIRD_PARTY_DISCONNECT`: 複数の参加者が関与するチャットで、コンタクトがまだチャット中のときにエージェント 1 がエージェント 2 を切断した場合、エージェント 2 の切断理由は `THIRD_PARTY_DISCONNECT` になります。
+ `SYSTEM_ERROR`: システム内のエラーにより、チャットセッションが異常終了しました。
上記一覧以外外の理由で終了するコンタクトについては、切断の理由は「null」として記録されます。  
タスクの切断理由には、次のようなものがあります。  
+ `AGENT_COMPLETED`: エージェントはタスクに必要なアクションを完了し、割り当てられた時間が期限切れになる前にコンタクトを切断しました。(タスクコンタクトに適用されます)
+ `AGENT_DISCONNECT`: エージェントはタスクを完了としてマークしました。
+ `EXPIRED`: タスクが 7 日以内に割り当てまたは完了しなかったため、自動的に期限切れになりました。
+ `CONTACT_FLOW_DISCONNECT`: タスクが切断されたか、フローによって完了しました。
+ `API`:[StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html) API が呼び出され、タスクが終了しました。
+ `OTHER`: これには、前のコードで明示的にカバーされていない理由がすべて含まれます。
E メールの切断理由には、次のようなものがあります。  
+ `TRANSFERRED`: E メールコンタクトが別のキューまたは別のエージェントに転送されました。
+ `AGENT_DISCONNECT`: エージェントが E メールコンタクトを切断したか、応答せずに終了しました。
+ `EXPIRED`: E メールコンタクトの有効期限が、エージェントが承諾または処理する前に切れました。これは、エージェントが利用できないか、有効期限が切れる前のキューの容量が E メールを処理するのに十分ではなかったことが原因である可能性があります。
+ `DISCARDED`: アウトバウンド (エージェントが返信するアウトバウンド、またはエージェントが開始したアウトバウンド) の E メールコンタクトがドラフト状態で破棄されました。
+ `CONTACT_FLOW_DISCONNECT`: E メールコンタクトがフローで切断されました。
+ `API`: [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html) API が呼び出され、E メールが終了しました。
+ `OTHER`: これには、これ以前の理由に明示的に含まれていないない理由がすべて含まれます。

**AnsweringMachineDetectionStatus**  
コンタクトが Amazon Connectに接続している場合に、[アウトバウンドキャンペーン](how-to-create-campaigns.md)着信が実際に処理される方法を示します。  
有効な値:  
+ `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`: ダイヤルされた番号は接続されたが、留守番電話の検出にエラーがありました。

**InitialContactId**  
最初の問い合わせの識別子。  
型: String  
長さ: 1-256

**InitiationMethod**  
コンタクトが開始された方法を示します。詳細については、「[Amazon Connect コンタクトセンターでの問い合わせ開始方法とフロータイプ](contact-initiation-methods.md)」を参照してください。  
有効な値:  
+  `INBOUND`: 顧客がコンタクトセンターに対し、音声 (電話) による問い合わせを開始しました。
+  `OUTBOUND`: エージェントが CCP を使用して顧客の番号に電話をかけることで、その顧客に対し音声 (電話) による対応を開始しました。
+  `TRANSFER`: エージェントが CCP のクイック接続を使用して、顧客を別のエージェントもしくはキューに転送しました。これにより、新しいコンタクトレコードが作成されます。
+  `CALLBACK`: コールバックフローの一環として顧客への連絡が行われました。

  このシナリオの InitiationMethod の詳細については、「[Amazon Connect のリアルタイムメトリクスでキューに入れられたコールバック](about-queued-callbacks.md)」を参照してください。
+  `API`: Amazon Connect の API によって、通話が開始されました。これは、[StartOutBoundVoiceContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundVoiceContact.html) API を使用してエージェント向けに作成してキューに入れた発信コンタクトであるか、[StartChatConnect](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API を呼び出して顧客とコンタクトセンターの間で開始されたライブチャットです。
+  `WEBRTC_API`: 問い合わせのビデオ通話に通信ウィジェットが使用されました。
+  `QUEUE_TRANSFER`: 1 つのキュー内の (顧客キューフローをリッスンしている) 顧客が、フローブロックによって別のキューに転送されました。
+  `EXTERNAL_OUTBOUND`: エージェントが、CCP のクイック接続またはフローブロックを使用して、コンタクトセンターへの外部参加者との音声 (電話) 問い合わせを開始しました。
+  `MONITOR`: スーパーバイザーがエージェントのモニタリングを開始しました。スーパーバイザーは、断りなくエージェントやお客様をモニタリングしたり、会話に割り込んだりすることができます。
+  `DISCONNECT`: [切断フローの設定](set-disconnect-flow.md) ブロックがトリガーされている場合、コンタクト中に切断イベントが発生した後に実行するフローを指定します。

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

  切断フローの実行中に新しいコンタクトが作成される場合、その新しいコンタクトは、DISCONNECT メソッドにより開始されます。
+  `AGENT_REPLY`: エージェントがインバウンド E メールコンタクトに返信して、アウトバウンド E メールの返信を作成しました。
+  `FLOW`: E メールが [[メッセージを送信](send-message.md)] ブロックによって開始されました。
+  `CAMPAIGN_PREVIEW`: コンタクトは、プレビューダイヤルモードを使用してアウトバウンドキャンペーンによって開始されました。エージェントは、通話が発信される前に顧客情報をプレビューします。

**InitiationTimestamp**  
このコンタクトが開始された日時 (UTC 時間)。  
+ `INBOUND` の場合、これはリクエストが入ったときです。
+ `OUTBOUND` は、エージェントがダイヤルを開始したときです。
+ `CALLBACK` は、コールバックの問い合わせが作成されたときです。
+ `EXTERNAL_OUTBOUND` の場合、エージェントが外部参加者にダイヤルし始めたのはこの時です。
+  `MONITOR` の場合、これはマネージャーがコンタクトを聞き始めた時点です。
+ `TRANSFER` および `QUEUE_TRANSFER` は、転送が開始されたときです。
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)  
タスクの場合、InitiationTimestamp はタスクコンタクトが作成された日時を示し、EnqueueTimestamp はタスクコンタクトがコンタクトとエージェントと一致させるためにキューに入れられた日時示します。  
コンタクトがキューに入る前にタスクで処理が行われるようにフローを設定できます。例えば、この処理には 1 分または数日かかる場合があります。多くのタスク、特にバックオフィス処理に使用されるタスクはキューに入れられないため、InitiationTimestamp があっても EnqueueTimestamp がなくても構いません。  
スケジュールされたタスクは、コンタクトの作成時に開始されますが、スケジュールに合う場合のみフローの実行が開始されます。  
7 日間の有効期限値は絶対的なものではなく、タスクが 7 日 をわずかに超える (7.01 日) と期限切れになる場合があります。

**InstanceARN**  
 Amazon Connect インスタンスの Amazon リソースネーム。  
型: ARN

**LastUpdateTimestamp**  
この問い合わせが最後に更新された日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**LastPausedTimestamp**  
このコンタクトが最後に中断された日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**LastResumedTimestamp**  
このコンタクトが最後に再開された日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**MediaStreams**  
メディアストリーム。  
タイプ: Array of [MediaStream](#MediaStream) の配列

**NextContactId**  
次の場合に作成されたコンタクトの ID:  
+ エージェントが CCP でクイック接続または数字パッドを使用した。
-または-  
+ 次のいずれかのフローブロックが実行された:
  + [フローへの転送](transfer-to-flow.md)
  + [キューへの転送](transfer-to-queue.md)
  + [切断フローの設定](set-disconnect-flow.md)
-または-  
+ その他の WebRTC (オーディオまたはビデオ) 参加者が追加されました。
型: String  
長さ: 1-256

**OutboundStrategy**  
アウトバウンド戦略に関する情報。  
型: [OutboundStrategy](https://docs.aws.amazon.com/connect/latest/APIReference/API_OutboundStrategy.html) オブジェクト

**PreviousContactId**  
現在の問い合わせが次の場合に作成された場合の前回の問い合わせの ID。  
+ エージェントが CCP でクイック接続または数字パッドを使用した。
-または-  
+ 次のいずれかのフローブロックが実行された:
  + [フローへの転送](transfer-to-flow.md)
  + [キューへの転送](transfer-to-queue.md)
  + [切断フローの設定](set-disconnect-flow.md)
-または-  
+ その他の WebRTC (オーディオまたはビデオ) 参加者が追加されました。
型: String  
長さ: 1-256

**Queue**  
この問い合わせがキュー登録されている場合、これはそのキューに関する情報です。  
タイプ: [QueueInfo](#ctr-QueueInfo)

**キャンペーン**  
キャンペーンに関連する情報。  
タイプ: [キャンペーン](https://docs.aws.amazon.com/connect/latest/APIReference/API_Campaign.html)のオブジェクト

**DisconnectDetails**  
通話切断エクスペリエンスに関する情報。  
タイプ: [DisconnectDetails](#ctr-disconnectdetails)

**QualityMetrics**  
参加者が通話中に会話しているメディア接続の品質に関する情報。  
タイプ: [QualityMetrics](#ctr-qualitymetrics)

**Recording**  
記録が有効になっている場合、これは記録に関する情報です。  
タイプ: [RecordingInfo](#ctr-RecordingInfo)

**Recordings**  
記録が有効になっている場合、これは記録に関する情報です。  
タイプ: [RecordingsInfo](#ctr-RecordingsInfo) の配列  
問い合わせの最初の録音は、問い合わせレコードの Recording セクションと Recordings セクションの両方に表示されます。

**Connect AI agents**  
問い合わせで Amazon Q が有効になっている場合、これは Amazon Q セッションに関する情報です。  
タイプ: [WisdomInfo](#ctr-wisdominfo)

**RelatedContactId**  
この問い合わせが別の問い合わせに関連付けられている場合、これは関連する問い合わせの識別子です。  
型: String  
長さ: 1-256

**ScheduledTimestamp**  
このコンタクトがフローの実行をトリガーするようにスケジュールされた日時 (UTC 時間)。これは、タスクチャネル用にのみサポートされます。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

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

**SystemEndpoint**  
システムエンドポイント。`INBOUND` の場合、これは顧客がダイヤルした電話番号です。`OUTBOUND` と `EXTERNAL_OUTBOUND` の場合、これは、顧客にダイヤルするために使用するアウトバウンドキューに割り当てられているアウトバウンド発信者 ID 番号です。の場合`CALLBACK`、これは顧客にダイヤルアウトするために使用される発信者 ID 番号です。発信者 ID 番号がキューへの転送ブロックで明示的に設定されている場合、その番号は顧客にダイヤルアウトするために使用されます。Transfer to Queue ブロックで発信者 ID が設定されていない場合、キューで設定されたアウトバウンド発信者 ID 番号を使用して顧客にダイヤルアウトします。発信者 ID が設定されていない場合、SystemEndpoint 値は匿名として表示されます。  
[電話番号への転送](transfer-to-phone-number.md) ブロックがカスタム発信者 ID を指定せずに使用されると、コール元の発信者 ID が発信者 ID として渡されます。例えば、外部番号に転送し、カスタム発信者 ID を使用して組織からのコールが送信されることを指定しない場合、連絡先の発信者 ID が部外者に表示されます。  
タイプ: [Endpoint](#ctr-endpoint)、`EMAIL_ADDRESS`

**AdditionalEmailRecipients**  
To フィールドと CC フィールド。  
型: String  
長さ: 1-256

**ContactAssociationId**  
relatedContactId によってリンクされたすべてのコンタクトに共通するコンタクト識別子。これは、スレッド内の E メールコンタクトに使用されます。  
型: Integer 

**TotalPauseCount**  
コンタクトが接続されなかった場合を含めた一時停止回数の合計。  
型: Integer 

**TotalPauseDurationInSeconds**  
エージェントの接続される前後を含む一時停止期間の合計。  
型: Integer 

**TransferCompletedTimestamp**  
TransferCompleteTimestamp は、エージェント (転送を開始したユーザー) が新しいエージェントの参加前に切断 (コールド転送) した時に入力されます。新しいエージェントが接続 (ウォーム転送) される前に転送を開始したエージェントが切断されない場合、TransferCompleteTimestamp はエージェントの初回のコンタクトに入力されません。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**TransferredToEndpoint**  
この問い合わせが転送された場合 Amazon Connect、転送エンドポイント。  
タイプ: [Endpoint](#ctr-endpoint)

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

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

## ContactLens
<a name="ctr-ContactLens"></a>

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

**ConversationalAnalytics**  
[Contact Lens の会話分析](analyze-conversations.md)機能に関する情報。  
問い合わせの会話分析動作を保持するオブジェクト。  
タイプ: [ConversationalAnalytics](#ctr-ConversationalAnalytics)

## ConversationalAnalytics
<a name="ctr-ConversationalAnalytics"></a>

[Contact Lens の会話分析](analyze-conversations.md)に関する情報。

**Configuration**  
問い合わせの会話分析の設定。  
タイプ: [Configuration](#ctr-Configuration)

## Configuration
<a name="ctr-Configuration"></a>

Contact Lens の会話分析の設定。会話分析を設定するには、 Amazon Connect 管理者ウェブサイトの[記録と分析の動作の設定](set-recording-behavior.md)フローブロックを使用するか、フロー言語で [UpdateContactRecordingBehavior](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-updatecontactrecordingbehavior.html) 問い合わせアクションを使用します。

**Enabled**  
Contact Lens はコンタクトで有効ですか?  
タイプ: ブール値

**ChannelConfiguration**  
コンタクトに対するチャネル固有の Contact Lens の会話分析の設定。会話分析の設定は、異なるチャネルからの問い合わせを処理できるフローブロックにマッピングされます。ほとんどの設定パラメータがすべてのチャネルに適用され、チャネル固有のサブセットはこのオブジェクトに含まれます。  
タイプ: [ChannelConfiguration](#ctr-ChannelConfiguration)

**LanguageLocale**  
Contact Lens がコンタクトの分析に使用する言語ロケール。  
タイプ: 文字列

**RedactionConfiguration**  
問い合わせのリダクション設定。  
タイプ: [RedactionConfiguration](#ctr-RedactionConfiguration)

**SentimentConfiguration**  
コンタクトの感情の設定。  
タイプ: [SentimentConfiguration](#ctr-SentimentConfiguration)

## ChannelConfiguration
<a name="ctr-ChannelConfiguration"></a>

問い合わせのチャネル設定。

**AnalyticsModes**  
問い合わせの分析モードのリスト。  
タイプ: [AnalyticsModes](#ctr-AnalyticsModes)

## Customer
<a name="ctr-Customer"></a>

コンタクトセンターに連絡するユーザー (顧客) に関する情報。

**Capabilities**  <a name="Capabilities-CTR"></a>
顧客の機能に関する情報。  
タイプ: [Capabilities](#ctr-Capabilities)

## Capabilities
<a name="ctr-Capabilities"></a>

ビデオ機能と画面共有機能に関する情報。

**Video**  <a name="Video-CTR"></a>
有効な値: SEND。

**ScreenShare**  <a name="ScreenShare-CTR"></a>
有効な値: SEND。

## AnalyticsModes
<a name="ctr-AnalyticsModes"></a>

問い合わせの分析モードのリスト。

**AnalyticsModes**  
問い合わせの分析モード。  
タイプ: 文字列  
音声の有効な値: `PostContact` \$1 `RealTime`  
チャットの有効な値: `ContactLens`

## RedactionConfiguration
<a name="ctr-RedactionConfiguration"></a>

問い合わせのリダクション設定。

**Behavior**  
Contact Lens 出力ファイルと音声録音で、個人情報などの機密データに対して編集を有効にするかどうかを指定します。このフィールドが `Disabled` に設定されている場合、このオブジェクト内の他のすべての値は無視されます。  
タイプ: 文字列  
有効な値: `Enable` \$1 `Disable`

**Policy**  
編集後と元のトランスクリプト、および音声ファイルを取得するか、編集後のトランスクリプトと音声ファイルのみを取得するか、編集前のコンテンツを含むトランスクリプトのみを取得するかを示します。`None` を指定すると編集が適用されません。  
タイプ: 文字列  
有効な値: `None` \$1 `RedactedOnly` \$1 `RedactedAndOriginal`

**Entities**  
問い合わせの編集エンティティのリスト。これが存在する場合、このリストに記載されているエンティティのみが編集されます。  
タイプ: [Entities](#ctr-Entities)

**MaskMode**  
問い合わせレコード内の機密情報をマスクする方法。  
+ `PII` を選択すると、編集されたすべてのエンティティが `[PII]` の文字列に置き換えられます。
+ `EntityType` を選択すると、編集されたすべてのエンティティがエンティティのラベルに置き換えられます。例えば、`EMAIL` エンティティの編集が設定されている場合、トランスクリプト内の E メールは `[EMAIL]` の文字列に置き換えられます。
タイプ: 文字列  
有効な値: `PII ` \$1 `EntityType` 

## SentimentConfiguration
<a name="ctr-SentimentConfiguration"></a>

コンタクトの感情の設定。

**Behavior**  
コンタクトの感情分析が有効か無効かを示します。デフォルト値は `Enable` です。  
タイプ: 文字列  
有効な値: `Enable` \$1 `Disable`

## Entities
<a name="ctr-Entities"></a>

問い合わせの編集エンティティのリスト。

**Entity**  
問い合わせで編集の必要なエンティティ。  
タイプ: 文字列  
最小値: 0

## SummaryConfiguration
<a name="ctr-SummaryConfiguration"></a>

問い合わせの要約設定。

**SummaryModes**  
問い合わせの要約モードのリスト。  
タイプ: [SummaryModes](#ctr-SummaryModes)  
最大値: 1

## SummaryModes
<a name="ctr-SummaryModes"></a>

問い合わせの要約モードのリスト。要約モードに `PostContact` を指定すると、[生成 AI を活用した問い合わせ後の要約](view-generative-ai-contact-summaries.md)が有効になります。

**SummaryMode**  
問い合わせの要約モード。  
型: 文字列  
有効な値: `PostContact`

## DeviceInfo
<a name="ctr-deviceinfo"></a>

参加者のデバイスに関する情報。

**PlatformName**  
参加者が通話に使用したプラットフォームの名前。  
型: String  
長さ: 1-128

**PlatformVersion**  
参加者が通話に使用したプラットフォームのバージョン。  
型: String  
長さ: 1-128

**OperatingSystem**  
参加者が通話に使用したオペレーティングシステム。  
型: String  
長さ: 1-128

## DisconnectDetails
<a name="ctr-disconnectdetails"></a>

通話切断エクスペリエンスに関する情報。このデータを使用して通話切断のトラブルシューティングを行う方法については、「[問い合わせレコードの DisconnectDetails を使用した通話切断に関するトラブルシューティング](troubleshoot-call-disconnects.md)」を参照してください。

**PotentialDisconnectIssue**  
通話の切断に関する潜在的な問題を示します。サービスが潜在的な問題を検出しなかった場合、このフィールドへの入力はありません。  
型: String  
長さ: 0～128  
有効な値:   
+ `AGENT_CONNECTIVITY_ISSUE`: エージェントのネットワーク接続に関する潜在的な問題を示します。
+ `AGENT_DEVICE_ISSUE`: ワークステーション、ヘッドセット、マイクなどのエージェントのデバイスに潜在的な問題があるため、顧客がエージェントの声を聞き取れない問題を示します。
+ `CUSTOMER_CONNECTIVITY_ISSUE`: 顧客のネットワーク接続に関する潜在的な問題を示します。
+ `CUSTOMER_DEVICE_ISSUE`: デバイスのスピーカーやマイクなどの顧客のデバイスに潜在的な問題があるため、顧客がエージェントの声を聞き取れない問題を示します。

## Endpoint
<a name="ctr-endpoint"></a>

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

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

**Type**  
エンドポイントタイプ｡ 現在、エンドポイントには電話番号のみが使用できます。  
有効な値: `TELEPHONE_NUMBER` 

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

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

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

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

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

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

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

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

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

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

## ExternalThirdParty
<a name="ctr-ExternalThirdParty"></a>

外部サードパーティー参加者に関する情報。

**ExternalThirdPartyInteractionDuration**  
外部エージェントが顧客とやり取りした時間 (秒単位)。  
型: Integer  
最小値: 0

## GlobalResiliencyMetadata
<a name="ctr-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}$`

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

コンタクト評価に関する情報。

**FormId**  
フォームの一意の識別子。常に存在します。  
型: String

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

**Status**  
評価の状態。  
型: String  
有効な値: `COMPLETE`、`IN_PROGRESS`、`DELETED`

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

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

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

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

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

コンタクトで使用されるメディアストリームに関する情報。

**Type**  
型: MediaStreamType  
有効な値: `AUDIO`、`CHAT`、`AUTOMATED_INTERACTION`

## QualityMetrics
<a name="ctr-qualitymetrics"></a>

参加者が通話中に会話しているメディア接続の品質に関する情報。

**Agent**  
エージェントのメディア接続の品質に関する情報。エージェントの声が顧客にどのように聞こえたかを測ります。  
タイプ: [AgentQualityMetrics](#ctr-agentqualitymetrics)

**Customer**  
顧客のメディア接続の品質に関する情報。顧客の声がエージェントにどのように聞こえたかを測ります。  
タイプ: [CustomerQualityMetrics](#ctr-customerqualitymetrics)

## AgentQualityMetrics
<a name="ctr-agentqualitymetrics"></a>

エージェントのメディア接続の品質に関する情報。エージェントの声が顧客にどのように聞こえたかを測ります。

**注記**  
AgentQualityMetrics は音声通話でのみ使用できます。

**Audio**  
エージェントのオーディオ品質に関する情報。  
タイプ: [AudioQualityMetricsInfo](#ctr-audioqualitymetrics)

## CustomerQualityMetrics
<a name="ctr-customerqualitymetrics"></a>

顧客のメディア接続の品質に関する情報。顧客の声がエージェントにどのように聞こえたかを測ります。

**注記**  
CustomerQualityMetrics は、アプリ内およびウェブ音声通話でのみ使用できます。アプリ内通話とウェブ通話の詳細については、「[アプリ内通話、ウェブ通話、ビデオ通話機能、および画面共有のセットアップ](inapp-calling.md)」を参照してください。

**Audio**  
エージェントのオーディオ品質に関する情報。  
タイプ: [AudioQualityMetricsInfo](#ctr-audioqualitymetrics)

## AudioQualityMetricsInfo
<a name="ctr-audioqualitymetrics"></a>

オーディオの品質スコアと品質問題に関する情報

**QualityScore**  
メディア接続に対して推定される品質を表す数値。  
型: Number  
最低値: 1.00  
最大値: 5.00

** PotentialQualityIssues**  
メディア接続の品質低下の原因となる可能性のある問題のリスト。サービスが潜在的な品質問題を何も検出しなかった場合、リストは空になります。  
型: StringArray  
有効な値: 空の配列、または次のいずれかの値を含む配列: `HighPacketLoss`、`HighRoundTripTime`、`HighJitterBuffer`。

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

キューに関する情報。

**ARN**  
キューの Amazon リソースネーム。  
型: ARN

**DequeueTimestamp**  <a name="DequeueTimestamp-CTR"></a>
問い合わせがキューから削除された日時 (UTC 時間)。顧客が切断されたか、エージェントが顧客とのやり取りを開始しました。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**Duration**  <a name="Duration-CTR"></a>
`EnqueueTimestamp` と `DequeueTimestamp` との時間差 (整数秒)。  
型: Integer  
最小値: 0

**EnqueueTimestamp**  <a name="EnqueueTimestamp-CTR"></a>
コンタクトがキューに追加された日時 (UTC 時間)。  
型: String (*yyyy*-*mm*-*dd*T*hh*:*mm*:*ss*Z)

**Name**  
キューの名前。  
型: String  
長さ: 1-256

## RecordingInfo
<a name="ctr-RecordingInfo"></a>

音声録音に関する情報。

**DeletionReason**  
記録が削除された場合、これが削除の際に入力する理由となります。  
型: String

**Location**  
記録 Amazon S3の場所。  
型: String  
長さ: 0-256

**Status**  
記録ステータス。  
有効な値: `AVAILABLE` \$1 `DELETED` \$1 `NULL` 

**Type**  
記録タイプ。  
有効な値: `AUDIO` 

## RecordingsInfo
<a name="ctr-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**  
会話参加者がエージェントか顧客かに関する情報。参加者のタイプは次のとおりです。  
+ すべて
+ マネージャー
+ [エージェント]
+ お客様
+ サードパーティー
+ スーパーバイザー
+ IVR
型: String

**StartTimestamp**  
録音の最後のレッグの会話が始まった時刻。  
タイプ: String *(yyyy-mm-ddThh:mm:ssZ)*

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

**StopTimestamp**  
録音の最後のレッグの会話が停止した時刻。  
タイプ: String *(yyyy-mm-ddThh:mm:ssZ)*

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

## References
<a name="ctr-contact-references"></a>

問い合わせに関連する他のドキュメントへのリンクが含まれています。

**リファレンスの情報**  
Name  
Type: `URL` \$1 `ATTACHMENT` \$1 `NUMBER` \$1 `STRING` \$1 `DATE` \$1 `EMAIL`  
+ Type = `ATTACHMENT` のとき、レコードには Status フィールドもあります。

  有効なステータス値: `APPROVED` \$1 `REJECTED` 
Value

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

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

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

**Index**  
ルーティング条件のインデックスに関する情報。  
キューに入れられたコンタクトでルーティング条件を 3 回より多く更新した場合、最後の 3 つの更新のみがコンタクトレコードに表示されます。ただし、インデックスを使用して、コンタクトレコードでルーティング条件が更新された回数を特定できます。  
例えば、ルーティング条件が 5 回更新された場合、コンタクトレコードにインデックス 2、3、および 4 を含む 3 つのルーティング条件が表示されます。これは、最大 3 つのルーティング条件のみがコンタクトレコードに保存されるためです。インデックス 0 と 1 を持つ最初の 2 つのルーティング条件の更新は、コンタクトレコードに表示されません。  
型: Integer  
最小値: 0

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

## RoutingProfile
<a name="ctr-RoutingProfile"></a>

ルーティングプロファイルに関する情報。

**ARN**  
ルーティングプロファイルの Amazon リソースネーム。  
型: ARN

**Name**  
ルーティングプロファイルの名前。  
型: String  
長さ: 1～100

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

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

**stateStartTimestamp**  
状態が開始された日時 (UTC 時間)。  
型: String (yyyy-mm-ddThh:mm:ssZ)

**stateEndTimestamp**  
状態が終了された日時 (UTC 時間)。  
型: String (yyyy-mm-ddThh:mm:ssZ)

**state**  
有効な値: `SILENT_MONITOR | BARGE`。

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

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

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

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

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

## VoiceIdResult
<a name="ctr-VoiceID"></a>

最新の音声 ID ステータス。

**Authentication**  
通話の音声認証情報。  
型: Authentication

**FraudDetection**  
通話の不正検出情報。  
型: FraudDetection

**GeneratedSpeakerId**  
音声 ID によって生成されるスピーカー識別子。  
型: String  
長さ: 25 文字

**SpeakerEnrolled**  
この顧客は、今回の問い合わせ中に登録されましたか?  
型: Boolean

**SpeakerOptedOut**  
この顧客は、今回の問い合わせ中、オプトアウトしましたか?  
型: Boolean

## WisdomInfo
<a name="ctr-wisdominfo"></a>

Connect AI エージェントセッションに関する情報。

**SessionArn**  
問い合わせの Connect AI エージェントセッションの Amazon リソースネーム (ARN)。  
型: ARN

## Authentication
<a name="ctr-Authentication"></a>

通話の Voice ID 認証に関する情報。

**ScoreThreshold**  
ユーザーの認証に必要な最小認証スコア。  
型: Integer  
最小値: 0  
最大値: 100

**MinimumSpeechInSeconds**  
ユーザーの認証に使用されるスピーチの秒数。  
型: Integer  
最小値: 5  
最大値: 10

**Score**  
音声 ID 認証評価の出力。  
型: Integer  
最小値: 0  
最大値: 100

**Result**  
音声 ID 認証評価の文字列出力。  
型: String  
長さ: 1～32  
有効な値: `Authenticated` \$1 `Not Authenticated` \$1 `Not Enrolled` \$1 `Opted Out` \$1 `Inconclusive` \$1 `Error`

## FraudDetection
<a name="ctr-FraudDetection"></a>

通話の Voice ID 不正検出に関する情報。

**ScoreThreshold**  
問い合わせのフローで設定されたウォッチリスト内の不正行為者検出のためのしきい値。  
型: Integer  
最小値: 0  
最大値: 100

**Result**  
ウォッチリスト内の不正行為者検出の文字列出力。  
型: String  
有効な値: `High Risk` \$1 `Low Risk` \$1 `Inconclusive` \$1 `Error`

**Reasons**  
詐欺の種類が含まれます: 既知の詐欺師と音声スプーフィング。  
型: List of String  
長さ: 1-128

**RiskScoreKnownFraudster**  
既知の不正行為者カテゴリのウォッチリストスコアに含まれる不正行為者の検出。  
型: Integer  
最小値: 0  
最大値: 100

**RiskScoreVoiceSpoofing**  
音声合成システムで録音された音声の再生など、音声スプーフィングに基づく不正リスクスコア。  
型: Integer  
長さ: 3

**RiskScoreSyntheticSpeech (未使用)**  
このフィールドは使用されません。このスコアは、音声スプーフィングのリスクスコアの合計として表示されます。  
型: Integer  
長さ: 3

**GeneratedFraudsterID**  
不正行為タイプが既知の不正行為者の場合は、不正行為者 ID。  
型: String  
長さ: 25 文字

**WatchlistID**  
コンタクトのフローで設定された不正行為者ウォッチリスト。既知の不正行為者の検出に使用します。  
型: String  
長さ: 22 文字

## 中止された問い合わせを特定する方法
<a name="abandoned-contact"></a>

中止された問い合わせとは、キューに入っているときに顧客によって切断された問い合わせを指します。これは、エージェントに接続されていなかったことを意味します。

中止された問い合わせの問い合わせレコードには、[**Queue**] (キュー) と、この問い合わせはキューに入れられたため [**Enqueue Timestamp**] (キュー追加のタイムスタンプ) が含まれます。**[ConnectedToAgentTimestamp]** や、問い合わせがエージェントに接続された後にのみ入力されるその他のフィールドは含まれません。