As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Forneça metadados de chamadas para integração ao Contact Lens
No Amazon Connect, cada interação com um cliente é um contato do Amazon Connect. Cada sessão de voz que passa pelo conector do Contact Lens cria um contato do Amazon Connect. O conector cria um contato do Amazon Connect usando os campos fornecidos nos metadados da chamada. Os metadados da chamada incluem o ID de usuário do atendente e o ID da respectiva fila para a chamada transmitida nos respectivos metadados.
Você pode fornecer o ID de usuário do atendente e outros metadados da chamada ao conector do Contact Lens usando parâmetros de metadados SIPREC aceitos no SIP INVITE da sessão de streaming de áudio. O conector analisa os seguintes campos de metadados da chamada e adiciona essas informações ao contato do Amazon Connect.
| Campo de estado da chamada | Metadados SIPREC | Valor | Se não for fornecido |
| --- | --- | --- | --- |
| ID de usuário do atendente | AmznConnectAgentUserId | ID de usuário do atendente do Amazon Connect | Obrigatório |
| ID da fila | AmznConnectQueueId | ID de fila do Amazon Connect | Opcional. Se não for fornecido, a fila padrão da instância do Amazon Connect será usada. |
| Ordem de participantes | AmznConnectParticipantOrder | Valores válidos: asc, desc | Opcional. Se não for fornecida, a ordem crescente será usada. O Amazon Connect classifica os fluxos do SIPREC usando rótulos. O primeiro fluxo na ordem dos rótulos é o atendente e o segundo é o chamador. |
Um contato deve ter um ID de usuário do atendente do Amazon Connect. O Contact Lens começa a capturar o áudio transmitido e a gerar gravação e a analytics da chamada somente quando o agentId é fornecido.
Se o agentid estiver ausente, a sessão do conector do Amazon Connect Contact Lens será encerrada. Se seus metadados do SIPREC não tiverem sido analisados automaticamente pelo conector do Amazon Connect Contact Lens e o ID de usuário do atendente não estiver definido, você poderá criar um lambda de fluxo e acessar todos os metadados SIP e SIPREC usando os seguintes campos:
| Atributo | Description | JSONPath Referência |
| --- | --- | --- |
| Metadados SIPREC | Metadados SIPREC do evento SIP | $.Media.Sip. SiprecMetadata |
| Cabeçalho SIP | Cabeçalho SIP do evento SIP. {SIP header name} é o nome do cabeçalho SIP fornecido no evento SIP. Por exemplo, “Para”, “De” e outros. | $.Media.Sip.Headers.{SIP header name} |
Para obter mais informações, consulte [Atributos de metadados de chamada telefônica (atributos de chamada)](connect-attrib-list.md#telephony-call-metadata-attributes).
## Como usar metadados de eventos
O Amazon Connect publica eventos SIP, de streaming e de contato. Esses eventos incluem os metadados coletados do SIPREC SIP INVITE das chamadas. Os metadados incluem os metadados SIPREC, cabeçalhos SIP, fromNumber, toNumber e outros. Veja algumas ações que você pode realizar com esses metadados de eventos:
1. Você pode processar os metadados nesses eventos para determinar seu próprio identificador exclusivo para as chamadas e correlacioná-las com o seu próprio sistema.
1. Depois, você pode adicionar seu identificador exclusivo da chamada aos respectivos atributos de contato usando o bloco [Set contact attributes (Definir atributos do contato)](set-contact-attributes.md).
1. Você pode pesquisar por atributos de contato personalizados no site do Connect Customer administrador para encontrar o contato para a chamada de terceiros nas duas instâncias do Amazon Connect.
Para acessar informações sobre como criar funções do Lambda de fluxo do Amazon Connect, consulte [Conceda ao Amazon Connect acesso às suas AWS Lambda funções](connect-lambda-functions.md). Para ver uma lista de todos os atributos de contato aceitos que você pode acessar em seu fluxo do Lambda, consulte [Lista de atributos de contato disponíveis no Amazon Connect e suas JSONPath referências](connect-attrib-list.md).