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

Contact centers

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 /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):

{
  "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.

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.