Open in
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-Usery codificación Hex. - Retomar y transferir, para que Genesys acepte el
REFERdel agente.
- Encabezados de conversación, para que Genesys envíe su id de conversación en
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ón | Valor |
|---|---|
| Servidor SIP | sip.thunderphone.com, puerto 5061 |
| Protocolo | TLS |
| Autenticación Digest | el username y el password del endpoint |
| Códecs | PCMU, 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:
- De forma opcional, agrega una acción Establecer datos UUI con contexto para el agente, como
account=12345. Genesys recomienda 128 caracteres o menos. - Agrega una acción Transferir a número con el
sip_uridel endpoint, por ejemplosip: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 deCall.UUIData. - Credenciales: tu clave de API, enviada como
Authorization: Bearer sk_live_…. - Salida: asigna
handoff.summaryyhandoff.intenta 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
INVITEinicial, por lo que no puede leer nada delREFERdel 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.