---
title: "Conectar a partir do Microsoft Dynamics 365"
description: "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](/pt/guides/api-keys) 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](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  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](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  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:

```bash
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](/pt/guides/sip-addresses).

## 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](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 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](/pt/guides/contact-centers/overview)):

```json
{"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](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
