Open in
Conectar desde Talkdesk
Envía llamadas de Talkdesk a un agente de ThunderPhone con Connect to Autopilot Voice y escálalas de vuelta con el ID de transferencia en UUI.
Tu flujo de Talkdesk Studio envía a quien llama al agente con el ID de interacción y UUI. Cuando quien llama necesita una persona, el agente escala con un REFER SIP a Talkdesk, y el ID de transferencia queda en una variable de Studio.
Antes de comenzar
- Un agente de ThunderPhone y una clave API de la organización.
- Una licencia de Talkdesk Conversation Orchestrator, que incluye el componente Conectar con Autopilot Voice de Studio en modo Flujo de voz externo (artículo de Talkdesk). Talkdesk lo factura por minuto mientras el agente mantiene la llamada.
1. Crea el endpoint SIP
Talkdesk solo documenta una lista de direcciones IP permitidas, así que crea un endpoint que acepte llamadas por dirección de origen:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'El artículo de Talkdesk indica que envía audio mediante SRTP, y "srtp": "optional"
acepta SRTP cuando Talkdesk lo ofrece. El artículo no indica si Talkdesk
requiere SRTP; si Talkdesk te dice que sí, establece srtp en required, lo que
rechaza llamadas sin él.
Obtén los rangos de señalización SIP de Talkdesk directamente de Talkdesk. Cada uno debe ser un rango IPv4 público de /16 o más específico (IPv6 /48 o más específico). Consulta
Plataformas que se autentican por IP de origen.
Talkdesk envía SIP desde la red de Twilio, cuyas direcciones comparten todos los clientes de Twilio,
por lo que la dirección del endpoint es lo que impide el acceso de otras personas que llaman: no
la publiques.
Conserva el sip_uri de la respuesta, por ejemplo
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Envía llamadas con contexto
En tu flujo de Studio, agrega Conectar con Autopilot Voice en modo Flujo de voz
externo y establece su destino en el sip_uri del endpoint con ;transport=tls agregado, por
ejemplo sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. El
endpoint rechaza llamadas por UDP, que es lo que usa SIP de Twilio a menos que se indique lo contrario.
Talkdesk envía:
X-Talkdesk-Interaction-Id, almacenado como elexternal_call_idde la llamada;User-to-User, codificado en hexadecimal, comobusiness_hours=open. Llega al prompt decodificado, como{{sip_uui}}.
La versión 2.1 del componente también puede enviar Encabezados definidos. La página de preferencias de Talkdesk los describe como JSON enviado mediante un WebSocket, así que confirma con Talkdesk si llegan como encabezados SIP antes de depender de ellos.
3. Recibe la llamada nuevamente
El agente escala la llamada con un REFER a la dirección de escalación de Talkdesk, con el
identificador de transferencia como UUI hexadecimal dentro de esa dirección, el único lugar donde Talkdesk lo lee.
Añade este número de transferencia (consulta
Añade el número de transferencia
y Encabezados dentro de la dirección de transferencia):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}La dirección es la indicada en el artículo de Talkdesk. La versión 2.1 del componente
lee autopilot_result=; la versión 1.7 lee escalate_to=, así que usa esa clave en la
versión 1.7. El REFER se ve así:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk guarda el valor en una variable de Studio. Para obtener el resumen y la intención, añade un paso de Ejecutar acción en una integración personalizada creada con Conexiones:
- Tipo de autenticación Clave de API, nombre del encabezado
Authorization, valorBearer sk_live_…. - Solicitud:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=seguido del identificador de la variable. También puedes consultar la llamada porexternal_call_idcon el identificador de interacción. - Crea rutas según
handoff.intenty muestrahandoff.summarya la persona que atiende la llamada.
Consulta Consulta una llamada transferida.
Pruébalo
Inicia una llamada mediante el flujo de Studio, pídele al agente que te comunique con una persona y verifica
que el flujo continúe después del componente con el identificador de transferencia en su
variable. Luego consulta la llamada con GET /v1/calls/{call_id}:
external_call_id debe ser el identificador de interacción de Talkdesk.
Límites
- Talkdesk lee como máximo 256 bytes de UUI y no permite valores separados por
|o;, así que envía un solo valor. El identificador de transferencia cabe. - Las API de Talkdesk no pueden leer la transcripción del agente. Usa la consulta de transferencia o
GET /v1/calls/{call_id}en su lugar.