Open in
Conéctate desde Five9
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 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):
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/16o más específico (IPv6/48o 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 devuelve409.
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 encabezadoTo. 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):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeyX-RouteValueindican al script a dónde enviar a quien llama, en este caso a la habilidad Support. Los valores que otros proveedores documentan paraX-RouteTypeincluyenSkillTransfer,PhoneTransfer,HangupyDispositionOnly; acuerda los valores con quien mantenga el script. Para varios destinos, añade un retorno por destino con un nombre yX-RouteValuediferentes.X-RouteReasonincluye la etiqueta de intención del agente, comobilling_dispute.X-CustomMetaDataincluye el id de transferencia. ElBYEtambién lo incluye comoX-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.
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
BYEy no menciona aceptar unREFER, por lo que la devolución es una transferencia en frío realizada por el script. - Five9 lee
X-RouteType,X-RouteValue,X-RouteReasonyX-CustomMetaData, noUser-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.