---
title: "Conectar desde Talkdesk"
description: "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](/es/guides/api-keys) 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](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  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:

```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": "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](/es/guides/sip-addresses).
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 el `external_call_id` de la llamada;
- `User-to-User`, codificado en hexadecimal, como `business_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](/es/guides/contact-centers/overview)
y [Encabezados dentro de la dirección de transferencia](/es/guides/call-transfers)):

```json
{
  "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`, valor
  `Bearer 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 por
  `external_call_id` con el identificador de interacción.
- Crea rutas según `handoff.intent` y muestra `handoff.summary` a la persona que atiende
  la llamada.

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

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