---
title: "Conéctate desde Microsoft Dynamics 365"
description: "Envía llamadas de Dynamics 365 Contact Center y Copilot Studio a un agente de ThunderPhone a través de tu SBC con encabezados X y consulta la transferencia del agente mediante HTTP."
---

Dynamics 365 Contact Center envía a quien llama al agente a través de tu
controlador de borde de sesión (SBC), con hasta cinco encabezados X, incluido el
id de conversación. Cuando el agente termina, cuelga, tu SBC devuelve a quien
llama a Dynamics 365 y un nodo de Solicitud HTTP obtiene la transferencia.

## Antes de empezar

- Un agente de ThunderPhone y una [clave de API](/es/guides/api-keys) de la organización.
- El canal de voz de Dynamics 365 Contact Center, conectado mediante
  **Enrutamiento directo** de Azure Communication Services a un SBC que administras
  ([requisitos del SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  un SBC compatible con un certificado público, TLS 1.2 en el puerto 5061 y SRTP
  hacia Microsoft.
- **Compatibilidad con encabezados X de SIP** en el nodo **Transferir conversación**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Confirma que esté disponible en tu entorno.

Dynamics 365 solo transfiere a un número de teléfono y Microsoft autentica
Enrutamiento directo mediante certificado, no mediante contraseña. Tu SBC se sitúa entre
Microsoft y ThunderPhone y convierte ese número en la dirección SIP del agente.

## 1. Crea el punto de conexión SIP

La llamada llega a ThunderPhone desde tu SBC, así que crea un punto de conexión estándar
para que lo use el SBC:

```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"}'
```

Guarda de inmediato la `password` de la respuesta; se muestra una sola vez y
tu SBC responde con ella al desafío de ThunderPhone. Si tu SBC no puede realizar
autenticación digest, crea el punto de conexión con `auth` establecido en `ip_allowlist` y
la dirección pública de tu SBC; consulta
[Plataformas que autentican por IP de origen](/es/guides/sip-addresses).

## 2. Envía llamadas con contexto

1. Elige un número de teléfono para el agente en tu SBC, como `+14155550188`.
2. En el SBC, enruta las llamadas a ese número al `sip_uri` del punto de conexión, por
   ejemplo `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, mediante TLS en el puerto
   `5061`. ThunderPhone encuentra el punto de conexión mediante la parte de usuario
   (`agent-12-jhxmginwjx`), que debe estar tanto en el URI de solicitud como en el
   encabezado `To`. Transmite los encabezados X sin cambios.
3. En Copilot Studio, agrega un nodo **Transferir conversación** con
   **Transferencia a número de teléfono externo** a ese número, y agrega los encabezados X:
   - `X-Call-ID`: el id de conversación de Dynamics 365. Ningún encabezado de Microsoft lo incluye,
     así que agrégalo aquí; ThunderPhone lo almacena como el
     `external_call_id` de la llamada. Confirma en Copilot Studio qué variable contiene el
     id de conversación.
   - Hasta cuatro más, como `X-Customer-Tier`.

Microsoft envía como máximo cinco encabezados X, con nombres de hasta 64 caracteres y
valores de hasta 256, usando letras, dígitos y `= ; . ! % * _ + ~ -`. Escribe
el prefijo en minúsculas como `x-`; ThunderPhone compara los nombres de encabezado sin distinguir
mayúsculas de minúsculas, por lo que `x-customer-tier` llega al prompt como `{{sip_x_customer_tier}}`.

Si en su lugar creas la llamada con Automatización de llamadas de Azure Communication Services,
`AddSipX` escribe nombres `X-MS-Custom-` de forma predeterminada. Pasa
`SipHeaderPrefix.X` para que `X-Call-ID` conserve su nombre
([contexto personalizado](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Recupera la llamada

El agente devuelve la llamada: se despide y cuelga. Agrega este número de
transferencia (consulta
[Agregar el número de transferencia](/es/guides/contact-centers/overview)):

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

Devolver a quien llama a Dynamics 365 es tarea de tu SBC. Microsoft
documenta una forma de entrada para una llamada con contexto: una llamada nueva a través del SBC a un
número registrado en Dynamics 365, con UUI cuyas claves coincidan con las variables de contexto
que configuraste en **Flujos de trabajo → Configuración avanzada**
([transferencia de IVR de terceros](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Coordina con tu proveedor de SBC cómo llega quien llama a ese número cuando
ThunderPhone cuelga y transporta el id de conversación que enviaste en `X-Call-ID`
para que el flujo pueda encontrar la llamada.

Luego, recupera la transferencia con un nodo **Solicitud HTTP** de Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  seguido del id de conversación.
- Encabezado `Authorization: Bearer sk_live_…`.
- Analiza la respuesta en una variable y usa `handoff.summary` y
  `handoff.intent`.

Consulta [Buscar una llamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Pruébalo

Llama a un número de Dynamics 365 que llegue al nodo de transferencia, pídele al agente
que te comunique con una persona y verifica que quien llama regrese a Dynamics 365. Luego abre la
llamada con `GET /v1/calls/{call_id}`: `sip_headers` debería incluir `x-call-id`, y
`external_call_id` debería ser el id de conversación. Si la llamada nunca llega al
agente y los registros de tu SBC muestran SIP `404`, su URI de solicitud o encabezado `To`
no incluye la parte de usuario del endpoint.

## Límites

- Se requiere un SBC. Microsoft no puede marcar una dirección SIP ni responder a un desafío
  digest.
- Microsoft envía como máximo cinco encabezados X y conserva solo los primeros cinco en una
  llamada entrante. Dynamics 365 acepta como máximo 128 caracteres de UUI.
- Microsoft no documenta la lectura de encabezados en un `BYE`, por lo que la transferencia
  solo regresa mediante la búsqueda.
