本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 提供用於 Contact Lens 整合的通話中繼資料
<a name="callmetadata-contactlens-integration"></a>

在 Connect Customer 中，與客戶的每次互動都是 Connect Customer 聯絡人。透過Contact Lens連接器的每個語音工作階段都會建立 Connect Customer 聯絡人。連接器會使用呼叫中繼資料中提供的欄位來建立 Connect Customer 聯絡人。通話中繼資料包括通話中繼資料中串流通話的客服人員使用者 ID 和客服人員佇列 ID。

您可以在音訊串流工作階段的 SIP INVITE 中使用支援的 SIPREC 中繼資料參數，將客服人員使用者 ID 和其他通話中繼資料提供給 Contact Lens 連接器。連接器會剖析下列呼叫中繼資料欄位，並將此資訊新增至 Connect Customer 聯絡人。


| 通話狀態欄位 | SIPREC 中繼資料 | Value | 如果未提供 | 
| --- | --- | --- | --- | 
| 客服人員使用者 ID | AmznConnectAgentUserId | Connect Customer 客服人員使用者 ID | 必要 | 
| 佇列 ID | AmznConnectQueueId | Connect 客戶佇列 ID | 「選用」。如果未提供，則會使用 Connect Customer 執行個體的預設佇列。 | 
| 參與者順序 | AmznConnectParticipantOrder | 有效值：asc、desc | 「選用」。如果未提供，則會使用遞增順序。Connect Customer 使用標籤來排序 SIPREC 串流。標籤順序的第一個串流是客服人員，第二個是來電者。 | 

聯絡人必須具有 Connect Customer 客服人員使用者 ID。 只有在提供 agentId 時，才會Contact Lens開始擷取串流音訊，並產生通話錄音和通話分析。

如果代理程式 ID 遺失，則 Connect Customer Contact Lens 連接器工作階段會終止。如果您的 SIPREC 中繼資料未由 Connect Customer Contact Lens 連接器自動剖析，且未設定客服人員使用者 ID，您可以使用下列欄位建立流程 Lambda 並存取所有 SIP 和 SIPREC 中繼資料：


| 屬性 | 說明 | JSONPath 參考 | 
| --- | --- | --- | 
| SIPREC 中繼資料 | 來自 SIP 事件的 SIPREC 中繼資料 | $.Media.Sip.SiprecMetadata | 
| SIP 標頭 | 來自 SIP 事件的 SIP 標頭。{SIP header name} 是 SIP 事件中提供的 SIP 標頭名稱。例如，「收件者」、「寄件者」等。 | $.Media.Sip.Headers.{SIP header name} | 

如需詳細資訊，請參閱[電話語音中繼資料屬性 (通話屬性)](connect-attrib-list.md#telephony-call-metadata-attributes)。

## 如何使用事件中繼資料
<a name="howto-correlate-eventscalls"></a>

Connect Customer 會發佈 SIP、串流和聯絡事件。這些事件包括從通話的 SIPREC SIP INVITE 收集的中繼資料。中繼資料包括 SIPREC 中繼資料、SIP 標頭、fromNumber、toNumber 等。以下是您可以對此事件中繼資料執行的一些操作：

1. 您可以處理這些事件中的中繼資料，以判斷通話的唯一識別符，並將通話與您自己的系統建立關聯。

1.  然後，您可以使用 [設定聯絡屬性](set-contact-attributes.md) 區塊，將通話的唯一識別符新增至通話的聯絡屬性。

1.  您可以在 Connect Customer 管理網站中依自訂聯絡人屬性搜尋，在兩個 Connect Customer 執行個體中尋找第三方通話的聯絡人。

如需如何建立 Connect Customer 流程 Lambda 函數的詳細資訊，請參閱 [授予 Connect Customer 存取函數的權限 AWS Lambda](connect-lambda-functions.md)。如需流程 Lambda 中可存取的所有支援聯絡屬性清單，請參閱 [Connect Customer 中的可用聯絡屬性清單及其 JSONPath 參考](connect-attrib-list.md)。