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

# Contact Lens 統合用の通話メタデータを提供する
<a name="callmetadata-contactlens-integration"></a>

Amazon Connect では、顧客とのそれぞれのやり取りは Amazon Connect コンタクトです。Contact Lens コネクタを通過する各音声セッションは、Amazon Connect コンタクトを作成します。コネクタは、通話メタデータで提供されたフィールドを使用して Amazon Connect コンタクトを作成します。通話メタデータには、通話メタデータ内のストリーミングされた通話のエージェントユーザー ID とエージェントキュー ID が含まれています。

オーディオストリームセッションの SIP INVITE 内でサポートされている SIPREC メタデータパラメータを使用して、エージェントユーザー ID およびその他の通話メタデータを Contact Lens コネクタに提供できます。コネクタは、次の通話メタデータフィールドを解析し、この情報を Amazon Connect コンタクトに追加します。


| 通話状態フィールド | SIPREC メタデータ | 値 | 指定されていない場合 | 
| --- | --- | --- | --- | 
| エージェントユーザー ID | AmznConnectAgentUserId | Amazon Connect エージェントユーザー ID | 必須 | 
| キュー ID | AmznConnectQueueId | Amazon Connect キュー ID | オプション。指定しない場合、Amazon Connect インスタンスのデフォルトキューが使用されます。 | 
| 参加順序 | AmznConnectParticipantOrder | 有効な値: asc、desc | オプション。指定しない場合、昇順が使用されます。Amazon Connect は、ラベルを使用して SIPREC ストリームをソートします。ラベル順序の最初のストリームはエージェントで、2 番目のストリームは発信者です。 | 

コンタクトには Amazon Connect エージェントユーザー ID が必要です。Contact Lens は、agentId が指定されている場合にのみ、ストリーミングされた音声のキャプチャと通話録音と通話分析の生成を開始します。

agentid がない場合、Amazon Connect Contact Lens コネクタセッションは終了します。SIPREC メタデータが Amazon Connect Contact Lens コネクタによって自動的に解析されず、エージェントユーザー ID が設定されていない場合は、次のフィールドを使用してフロー Lambda を作成し、すべての SIP および SIPREC メタデータにアクセスできます。


| 属性 | 説明 | JSONPath 参照 | 
| --- | --- | --- | 
| SIPREC メタデータ | SIP イベントからの SIPREC メタデータ | $.Media.Sip.SiprecMetadata | 
| SIP ヘッダー | SIP イベントからの SIP ヘッダー。{SIP ヘッダー名} は、SIP イベントで提供される SIP ヘッダーの名前です。例えば、「To」、「From」などです。 | $.Media.Sip.Headers.{SIP ヘッダー名} | 

詳細については、「[テレフォニー通話メタデータ属性 (通話属性)](connect-attrib-list.md#telephony-call-metadata-attributes)」を参照してください。

## イベントメタデータの使用方法
<a name="howto-correlate-eventscalls"></a>

Amazon Connect は、SIP、ストリーミング、およびコンタクトイベントを公開します。これらのイベントには、通話の SIPREC SIP INVITE から収集されたメタデータが含まれます。メタデータには、SIPREC メタデータ、SIP ヘッダー、fromNumber、toNumber などが含まれます。このイベントメタデータでできることをいくつか紹介します。

1. これらのイベントのメタデータを処理して、通話の一意の識別子を決定し、通話を独自のシステムと関連付けることができます。

1.  その後、[コンタクト属性の設定](set-contact-attributes.md) ブロックを使用して、通話の一意の識別子を通話のコンタクト属性に追加できます。

1.  Connect Customer 管理ウェブサイトのカスタム連絡先属性で検索して、2 つの Amazon Connect インスタンスでサードパーティー呼び出しの連絡先を検索できます。

Amazon Connect フロー Lambda 関数を作成する方法については、「[AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)」を参照してください。フロー Lambda でアクセスできるサポートされているすべてのコンタクト属性のリストについては、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。