---
title: "Conéctate desde Five9"
description: "Envía llamadas de Five9 a un agente de voz de ThunderPhone mediante SIP con AI Agent Connect y recíbelas de vuelta con encabezados de enrutamiento que lee tu script de IVR."
---

El script de IVR de Five9 envía a quien llama al agente con los detalles de la
llamada de Five9. Cuando el agente termina, cuelga con encabezados de enrutamiento en el SIP
`BYE`, que el script lee en variables de llamada para enrutar a quien llama.

## Antes de comenzar

- Un agente de ThunderPhone y una [clave de API](/es/guides/api-keys) de la organización.
- El complemento **AI Agent Connect** de Five9. Five9 lo limita a proveedores de IA que ha
  acreditado, y el equipo de implementación de Five9 lo configura: importa la
  plantilla de script de IVR del proveedor, crea las variables de llamada y dirige el
  módulo **Transferencia a terceros** del script al proveedor. ThunderPhone aún no
  está en la lista de proveedores acreditados de Five9: consulta con tu equipo de cuenta de Five9 o con
  soporte de ThunderPhone antes de planificar en función de ello.

## 1. Crea el endpoint SIP

El módulo de Transferencia a terceros de Five9 marca un número de teléfono, no una dirección SIP,
y las integraciones de Five9 de otros proveedores autentican a Five9 por dirección de origen
en lugar de una contraseña. Por lo tanto, crea un endpoint `ip_allowlist` con el número
que Five9 marcará como número de acceso telefónico (consulta
[Plataformas que marcan un número de teléfono](/es/guides/sip-addresses)):

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: los rangos de señalización SIP de tus centros de datos de Five9,
  proporcionados por Five9. Cada uno debe ser un rango IPv4 público de `/16` o más específico
  (IPv6 `/48` o más específico).
- `dial_in_numbers`: el número que marcará el script de Five9, escrito de la forma en que
  Five9 lo envía. No tiene que ser un número de teléfono real. No puede estar ya
  en uso en ThunderPhone, como número de teléfono o en otro endpoint: eso devuelve
  `409`.

Las direcciones de Five9 se comparten entre todos sus clientes, por lo que cualquier otro cliente de Five9
que marque el número llegará a tu agente. Cuando elijas el
número, selecciona uno largo que nadie pueda adivinar (hasta 15 dígitos), asegúrate de que
Five9 lo envíe a ThunderPhone en lugar de sacarlo a la red telefónica, y
no lo publiques.

## 2. Envía llamadas con contexto

Pide al equipo de implementación de Five9 que:

- Envíe la llamada desde el módulo **Transferencia a terceros** a
  `sip:+14155550188@sip.thunderphone.com`, con el número tanto en el URI de solicitud
  como en el encabezado `To`. El módulo toma el número, con el dominio SIP del proveedor
  en un encabezado.
- La envíe mediante TLS (puerto 5061) o TCP (puerto 5060). El endpoint rechaza UDP,
  y Five9 no publica qué transporte utiliza, así que asegúrate de que no sea
  UDP.
- Active **Volver después de llamada de terceros**, para que el script continúe cuando el
  agente cuelgue (Five9 permite hasta 3,600 segundos en la llamada de terceros).

La guía de Five9 enumera los valores que envía (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` y otros), no los nombres de sus
encabezados. Las integraciones de Five9 de otros proveedores de IA los documentan en la conexión
como `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
y `X-AgentID`; verifícalos en tu primera llamada de prueba. Cada uno llega al prompt como una variable, como
`{{sip_x_callcampaign}}`. `X-CallID` se almacena como el
`external_call_id` de la llamada.

## 3. Recibe la llamada de vuelta

El agente devuelve la llamada: se despide y cuelga, y el `BYE` incluye los
cuatro encabezados que lee el script de Five9. Añade este número de transferencia (consulta
[Añade el número de transferencia](/es/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` y `X-RouteValue` indican al script a dónde enviar a quien llama,
  en este caso a la habilidad Support. Los valores que otros proveedores documentan para `X-RouteType` incluyen
  `SkillTransfer`, `PhoneTransfer`, `Hangup` y `DispositionOnly`; acuerda los
  valores con quien mantenga el script. Para varios destinos, añade un
  retorno por destino con un nombre y `X-RouteValue` diferentes.
- `X-RouteReason` incluye la etiqueta de intención del agente, como `billing_dispute`.
- `X-CustomMetaData` incluye el id de transferencia. El `BYE` también lo incluye como
  `X-TP-Handoff-Id`, que Five9 no lee.

El script de Five9 asigna los cuatro encabezados a variables de llamada. Para el
resumen del agente, haz que el script llame a la consulta de transferencia con un módulo **Query** de IVR:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` seguido de
`call.call_id`, con un perfil de autorización que envíe
`Authorization: Bearer` y tu clave de API. Consulta
[Buscar una llamada transferida](/api-reference/calls#look-up-a-handed-off-call).

## Pruébalo

Llama al script de IVR, pídele al agente hablar con una persona y verifica que el script
enrute a quien llama con las variables de llamada completadas. Si la llamada nunca llega al
agente, verifica que el número en el URI de solicitud y el encabezado `To` coincida con el
número de acceso, que la dirección de origen de Five9 esté en `allowed_source_cidrs` y
que la llamada haya llegado por TCP o TLS. Luego abre la llamada con
`GET /v1/calls/{call_id}`: `sip_headers` debería mostrar `x-callid`, y
`external_call_id` debería coincidir con `call.call_id` en Five9.

## Límites

- La guía de Five9 documenta los datos de enrutamiento en el `BYE` y no menciona
  aceptar un `REFER`, por lo que la devolución es una transferencia en frío realizada por el script.
- Five9 lee `X-RouteType`, `X-RouteValue`, `X-RouteReason` y
  `X-CustomMetaData`, no `User-to-User`. ThunderPhone envía cada valor de encabezado
  con un máximo de 256 bytes.
- Five9 recomienda mantener los encabezados personalizados en alrededor de diez para evitar la
  fragmentación de paquetes.
