本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为以下各项提供通话元数据 Contact Lens 集成
<a name="callmetadata-contactlens-integration"></a>

在 Connect Customer 中，与客户的每次互动都是 Connect 客户联系人。通过Contact Lens连接器进行的每个语音会话都会创建一个 Connect 客户联系人。连接器使用呼叫元数据中提供的字段创建 Connect Customer 联系人。通话元数据包括通话元数据中用于流式传输通话的座席用户 ID 和座席队列 ID。

您可以使用音频流会话的 SIP INVITE 中支持的 SIPREC 元数据参数向 Contact Lens 连接器提供座席用户 ID 和其他通话元数据。连接器解析以下呼叫元数据字段，并将此信息添加到 Connect 客户联系人。


| 通话状态字段 | SIPREC 元数据 | 值 | 如果未提供 | 
| --- | --- | --- | --- | 
| 座席用户 id | AmznConnectAgentUserId | Connect 客户代理用户 ID | 必填 | 
| 队列 id | AmznConnectQueueId | Connect 客户队列 ID | 可选。如果未提供，则使用 Connect Customer 实例的默认队列。 | 
| 参与者顺序 | AmznConnectParticipantOrder | 有效值：asc、desc | 可选。如果未提供，则使用升序。Connect Customer 使用标签对 SIPREC 直播进行排序。按标签顺序排列的第一个流是座席，第二个是呼叫方。 | 

联系人必须具有 Connect 客户代理用户 ID。 Contact Lens只有在提供 AgentID 时，才会开始捕获流式音频并生成通话录音和呼叫分析。

如果缺少 agentid，则 Connect Customer Contact Lens 连接器会话将终止。如果 Connect Customer Contact Lens 连接器未自动解析您的 SIPREC 元数据，并且未设置代理用户 ID，则可以使用以下字段创建流 lambda 并访问所有 SIP 和 SIPREC 元数据：


| 属性 | 说明 | JSONPath 引用 | 
| --- | --- | --- | 
| SIPREC 元数据 | 来自 SIP 事件的 SIPREC 元数据 | $.Media.Sip.SiprecMetadata | 
| SIP 标头 | 来自 SIP 事件的 SIP 标头。{SIP 标头名称} 是 SIP 事件中提供的 SIP 标头的名称。例如，“收件人”、“发件人”等。 | $。 Media.Sip.Headers。 {SIP 标头名称} | 

有关更多信息，请参阅 [电话呼叫元数据属性（呼叫属性）](connect-attrib-list.md#telephony-call-metadata-attributes)。

## 如何使用事件元数据
<a name="howto-correlate-eventscalls"></a>

Connect 客户发布 SIP、直播和联系活动。这些事件包括从通话的 SIPREC SIP INVITE 中收集的元数据。元数据包括 SIPREC 元数据、SIP 标头、fromNumber、toNumber 等。以下是您可以利用此事件元数据做的一些事情：

1. 您可以处理这些事件中的元数据，以确定您自己的呼叫唯一标识符，并将这些呼叫与您自己的系统关联起来。

1.  然后，您可以使用 [设置联系属性](set-contact-attributes.md) 块将您的呼叫唯一标识符添加到呼叫的联系属性中。

1.  您可以在 Connect Customer 管理网站中按自定义联系人属性进行搜索，以便在两个 Connect Customer 实例中查找第三方呼叫的联系人。

有关如何创建 Connect 客户流 Lambda 函数的信息，请参阅。[授予 Connect 客户访问您的 AWS Lambda 函数](connect-lambda-functions.md)有关您可以在流 Lambda 中访问的所有受支持的联系属性的列表，请参阅 [Connect Customer 中可用的联系人属性列表及其 jsonPath 参考文献](connect-attrib-list.md)。