Open in
Conéctate desde Microsoft Dynamics 365
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 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): 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). 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:
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.
2. Envía llamadas con contexto
- Elige un número de teléfono para el agente en tu SBC, como
+14155550188. - En el SBC, enruta las llamadas a ese número al
sip_uridel punto de conexión, por ejemplosip:agent-12-jhxmginwjx@sip.thunderphone.com, mediante TLS en el puerto5061. 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 encabezadoTo. Transmite los encabezados X sin cambios. - 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 elexternal_call_idde 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).
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):
{"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).
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.summaryyhandoff.intent.
Consulta Buscar una llamada transferida.
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.