ThunderPhone v3 já está no ar.Contrate online, a partir de 2¢/min.Leia o anúncio

Contact centers

Conectar a partir do Microsoft Dynamics 365

Envie chamadas do Contact Center do Dynamics 365 e do Copilot Studio a um agente do ThunderPhone pelo seu SBC com cabeçalhos X e consulte a transferência do agente por HTTP.

O Dynamics 365 Contact Center envia quem liga ao agente pelo seu controlador de borda de sessão (SBC), com até cinco cabeçalhos X, incluindo o ID da conversa. Quando o agente termina, ele encerra a chamada, seu SBC retorna quem liga ao Dynamics 365, e um nó de Solicitação HTTP obtém a transferência.

Antes de começar

  • Um agente do ThunderPhone e uma chave de API da organização.
  • O canal de voz do Dynamics 365 Contact Center, conectado pelo Roteamento Direto do Azure Communication Services a um SBC que você opera (requisitos do SBC): um SBC compatível com certificado público, TLS 1.2 na porta 5061 e SRTP em direção à Microsoft.
  • Suporte a cabeçalhos SIP X no nó Transferir conversa (Copilot Studio). Confirme se ele está disponível no seu ambiente.

O Dynamics 365 transfere apenas para um número de telefone, e a Microsoft autentica o Roteamento Direto por certificado, não por senha. Seu SBC fica entre a Microsoft e o ThunderPhone e transforma esse número no endereço SIP do agente.

1. Crie o endpoint SIP

A chamada chega ao ThunderPhone pelo seu SBC, então crie um endpoint padrão para o SBC usar:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Dynamics 365 SBC"}'

Armazene imediatamente a password da resposta; ela é exibida uma única vez, e seu SBC responde ao desafio do ThunderPhone com ela. Se o seu SBC não puder usar autenticação digest, crie o endpoint com auth definido como ip_allowlist e o endereço público do seu SBC; consulte Plataformas que autenticam por IP de origem.

2. Envie chamadas com contexto

  1. Escolha um número de telefone para o agente no seu SBC, como +14155550188.
  2. No SBC, encaminhe chamadas para esse número ao sip_uri do endpoint, por exemplo sip:agent-12-jhxmginwjx@sip.thunderphone.com, por TLS na porta 5061. O ThunderPhone localiza o endpoint pela parte do usuário (agent-12-jhxmginwjx), que deve estar tanto na URI de solicitação quanto no cabeçalho To. Repasse os cabeçalhos X sem alterações.
  3. No Copilot Studio, adicione um nó Transferir conversa com Transferência para número de telefone externo para esse número e adicione os cabeçalhos X:
    • X-Call-ID: o ID da conversa do Dynamics 365. Nenhum cabeçalho da Microsoft o inclui, então adicione-o aqui; o ThunderPhone o armazena como o external_call_id da chamada. Confirme no Copilot Studio qual variável contém o ID da conversa.
    • Até mais quatro, como X-Customer-Tier.

A Microsoft envia no máximo cinco cabeçalhos X, com nomes de até 64 caracteres e valores de até 256, usando letras, dígitos e = ; . ! % * _ + ~ -. Ela grava o prefixo em minúsculas como x-; o ThunderPhone compara nomes de cabeçalho sem diferenciar maiúsculas de minúsculas, portanto x-customer-tier chega ao prompt como {{sip_x_customer_tier}}.

Se você criar a chamada com a Automação de Chamadas do Azure Communication Services em vez disso, AddSipX grava nomes X-MS-Custom- por padrão. Passe SipHeaderPrefix.X para que X-Call-ID mantenha seu nome (contexto personalizado).

3. Devolva a chamada

O agente devolve a chamada: despede-se e desliga. Adicione este número de transferência (consulte Adicionar o número de transferência):

{"name": "Dynamics 365", "action": "return"}

Trazer quem liga de volta para o Dynamics 365 é responsabilidade do seu SBC. A Microsoft documenta uma forma de entrada para uma chamada com contexto: uma nova chamada pelo SBC para um número registrado no Dynamics 365, com UUI cujas chaves correspondem às variáveis de contexto configuradas em Fluxos de trabalho → Configurações avançadas (transferência de URA de terceiros). Defina com o fornecedor do seu SBC como quem liga chega a esse número quando o ThunderPhone desliga e transmita o ID da conversa que você enviou em X-Call-ID para que o fluxo possa localizar a chamada.

Em seguida, busque a transferência com um nó Solicitação HTTP do Copilot Studio:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= seguido pelo ID da conversa.
  • Cabeçalho Authorization: Bearer sk_live_….
  • Analise a resposta em uma variável e use handoff.summary e handoff.intent.

Consulte Consultar uma chamada transferida.

Teste

Ligue para um número do Dynamics 365 que alcance o nó de transferência, peça ao agente para falar com uma pessoa e verifique se quem liga volta para o Dynamics 365. Em seguida, abra a chamada com GET /v1/calls/{call_id}: sip_headers deve listar x-call-id, e external_call_id deve ser o ID da conversa. Se a chamada nunca chegar ao agente e seu SBC registrar SIP 404, a URI da solicitação ou o cabeçalho To não contém a parte de usuário do endpoint.

Limites

  • Um SBC é obrigatório. A Microsoft não pode discar um endereço SIP nem responder a um desafio de digest.
  • A Microsoft envia no máximo cinco cabeçalhos X e mantém apenas os primeiros cinco em uma chamada recebida. O Dynamics 365 aceita no máximo 128 caracteres de UUI.
  • A Microsoft não documenta a leitura de cabeçalhos em um BYE, portanto a transferência só retorna pela consulta.