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

Contact centers

Conectarse desde Genesys Cloud

Envía llamadas de Genesys Cloud a un agente de ThunderPhone mediante un troncal de BYOC Cloud con el ID de conversación y UUI, y recíbelas de vuelta con la transferencia en UUI.

El flujo de Architect envía a quien llama al agente a través de una troncal BYOC Cloud, con el id de conversación y cualquier UUI que configures. Cuando quien llama necesita hablar con una persona, el agente envía un REFER de SIP, Genesys retoma la llamada y el id de transferencia llega en la UUI de la llamada.

Antes de comenzar

  • Un agente de ThunderPhone y una clave de API de la organización.
  • Genesys Cloud con BYOC Cloud y una troncal externa (tipo BYOC Carrier o PBX) con estas configuraciones activadas (configuración de la troncal externa):
    • Encabezados de conversación, para que Genesys envíe su id de conversación en x-inin-cnv. Está desactivado de forma predeterminada.
    • Transferencia de UUI, con tipo de encabezado User-To-User y codificación Hex.
    • Retomar y transferir, para que Genesys acepte el REFER del agente.

1. Crea el endpoint SIP

Genesys responde a un desafío Digest, así que usa un endpoint estándar:

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": "Genesys Cloud"}'

Guarda de inmediato el password de la respuesta; se muestra una sola vez. En la troncal:

ConfiguraciónValor
Servidor SIPsip.thunderphone.com, puerto 5061
ProtocoloTLS
Autenticación Digestel username y el password del endpoint
CódecsPCMU, PCMA o G.722

Coloca la troncal en una ruta saliente de tu sitio cuyo plan de numeración cubra la dirección que marca el flujo.

2. Envía llamadas con contexto

En tu flujo de Architect:

  1. De forma opcional, agrega una acción Establecer datos UUI con contexto para el agente, como account=12345. Genesys recomienda 128 caracteres o menos.
  2. Agrega una acción Transferir a número con el sip_uri del endpoint, por ejemplo sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys envía el id de conversación en x-inin-cnv. ThunderPhone lo almacena como el external_call_id de la llamada. La UUI llega al prompt decodificada, como {{sip_uui}}.

Los encabezados personalizados de la troncal son estáticos en Genesys, así que coloca los valores por llamada en la UUI. Genesys reserva para sí los prefijos de encabezados x-inin, x-genesys, x-pcv y x-gcv.

3. Recupera la llamada

El agente transfiere con un REFER a una dirección en Genesys, con el id de transferencia como UUI hexadecimal dentro de esa dirección. Agrega este número de transferencia (consulta Agregar el número de transferencia y Encabezados dentro de la dirección de transferencia):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Reemplaza la dirección por una que enrute de vuelta a la cola o al flujo que debe atender a quien llama; confirma su formato con Genesys. El REFER tiene este aspecto:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Con Retomar y transferir activado, Genesys retoma la llamada desde la troncal y la enruta a esa dirección. Genesys documenta que la UUI entrante llega a Call.UUIData; no lo documenta para una recuperación, así que confirma con Genesys, o en una llamada de prueba, que el flujo que recibe a quien llama encuentre allí el id de transferencia. Para obtener el resumen y la intención, llama a la búsqueda de transferencia con una Acción de datos de llamada en una integración de Acciones de datos de servicios web:

  • Solicitud: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= seguido del id de Call.UUIData.
  • Credenciales: tu clave de API, enviada como Authorization: Bearer sk_live_….
  • Salida: asigna handoff.summary y handoff.intent a variables del flujo.

Consulta Buscar una llamada transferida.

Pruébalo

Llama a un número que llegue al flujo, pídele al agente que te comunique con una persona y verifica que Genesys lleve la llamada a la dirección que configuraste. En ese flujo, verifica que Call.UUIData contenga el id de transferencia como texto (si muestra dígitos hexadecimales, verifica que la codificación UUI del troncal sea Hex). Luego abre la llamada con GET /v1/calls/{call_id}: external_call_id debe ser el id de la conversación.

Límites

  • La acción Obtener encabezados SIP lee solo el INVITE inicial, por lo que no puede leer nada del REFER del agente. La transferencia llega a Genesys solo mediante UUI.
  • Genesys descarta toda la UUI cuando una llamada incluye más de un encabezado UUI.
  • La dirección de transferencia se limita a 254 caracteres, por lo que una UUI larga se recorta para ajustarse. Un id de transferencia siempre cabe.