本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
提供通话元数据以进行 Contact Lens 集成
在 Amazon Connect 中，与客户的每一次交互就是一次 Amazon Connect 联系。通过 Contact Lens 连接器传入的每个语音会话会创建一个 Amazon Connect 联系。连接器使用通话元数据中提供的字段创建 Amazon Connect 联系。通话元数据包括通话元数据中用于流式传输通话的座席用户 ID 和座席队列 ID。
您可以使用音频流会话的 SIP INVITE 中支持的 SIPREC 元数据参数向 Contact Lens 连接器提供座席用户 ID 和其他通话元数据。连接器解析以下通话元数据字段，并将此信息添加到 Amazon Connect 联系。
| 通话状态字段 | SIPREC 元数据 | 值 | 如果未提供 |
|---|---|---|---|
| 座席用户 id | AmznConnectAgentUserId |
Amazon Connect 座席用户 id | 必需 |
| 队列 id | AmznConnectQueueId |
Amazon Connect 队列 id | 可选。如果未提供，则使用 Amazon Connect 实例的默认队列。 |
| 参与者顺序 | AmznConnectParticipantOrder |
有效值：asc、desc |
可选。如果未提供，则使用升序。Amazon Connect 使用标签对 SIPREC 流进行分类。按标签顺序排列的第一个流是座席，第二个是呼叫方。 |
一个联系必须具有一个 Amazon Connect 座席用户 ID。只有在提供了座席 ID 时，Contact Lens 才开始捕获流式传输音频并生成通话录音和通话分析。
如果缺少座席 ID，则 Amazon Connect Contact Lens 连接器会话将终止。如果 Amazon Connect Contact Lens 连接器未自动解析您的 SIPREC 元数据，并且未设置座席用户 ID，则您可以使用以下字段创建流 lambda 并访问所有 SIP 和 SIPREC 元数据：
| 属性 | 描述 | JSONPath 引用 |
|---|---|---|
| SIPREC 元数据 | 来自 SIP 事件的 SIPREC 元数据 | $.Media.Sip.SiprecMetadata |
| SIP 标头 | 来自 SIP 事件的 SIP 标头。{SIP 标头名称} 是 SIP 事件中提供的 SIP 标头的名称。例如，“收件人”、“发件人”等。 | $.Media.Sip.Headers.{SIP 标头名称} |
有关更多信息，请参阅电话呼叫元数据属性（呼叫属性）。
如何使用事件元数据
Amazon Connect 发布 SIP、流和联系事件。这些事件包括从通话的 SIPREC SIP INVITE 中收集的元数据。元数据包括 SIPREC 元数据、SIP 标头、fromNumber、toNumber 等。以下是您可以利用此事件元数据做的一些事情：
-
您可以处理这些事件中的元数据，以确定您自己的呼叫唯一标识符，并将这些呼叫与您自己的系统关联起来。
-
然后，您可以使用 设置联系属性 块将您的呼叫唯一标识符添加到呼叫的联系属性中。
-
您可以在 Amazon Connect 管理网站中按自定义联系属性进行搜索，在两个 Amazon Connect 实例中找到第三方通话的联系。
有关如何创建 Amazon Connect 流 Lambda 函数的信息，请参阅允许 Amazon Connect 访问您的 AWS Lambda 功能。有关您可以在流 Lambda 中访问的所有受支持的联系属性的列表，请参阅 Amazon Connect 中可用的联系人属性列表及其 JSONPath 参考文献。
