Open in
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
- Escolha um número de telefone para o agente no seu SBC, como
+14155550188. - No SBC, encaminhe chamadas para esse número ao
sip_urido endpoint, por exemplosip:agent-12-jhxmginwjx@sip.thunderphone.com, por TLS na porta5061. 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çalhoTo. Repasse os cabeçalhos X sem alterações. - 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 oexternal_call_idda 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.summaryehandoff.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.