ThunderPhone v3 ya está disponible.Empieza por tu cuenta desde 2¢/min.Lee el anuncio

Contact centers

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

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

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.summary y handoff.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.