Open in
Conectarse desde NICE CXone
Envía llamadas de NICE CXone a un agente de ThunderPhone desde un script de Studio con el ContactID en un encabezado SIP y consulta la transferencia del agente cuando el script continúe.
Su script de CXone Studio realiza una llamada al agente con encabezados SIP que incluyen el id del contacto y cualquier otro contexto. Cuando el agente termina, cuelga y una acción de API REST en el script obtiene la transferencia.
Antes de comenzar
- Un agente de ThunderPhone y una clave de API de organización.
- Un grupo de troncales SIP de CXone que acepte encabezados personalizados. Su representante de cuenta de NICE debe activar esta configuración antes de que CXone los envíe.
1. Cree el endpoint SIP
Placecall marca un número de teléfono mediante un grupo de troncales de CXone, no una dirección SIP.
NICE no documenta las credenciales SIP para este servicio, y la integración de CXone de otro proveedor de IA
usa TLS con una lista de IP permitidas. Por lo tanto, cree un endpoint
ip_allowlist con el número que marcará el script como número de marcación entrante (consulte
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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: los rangos de señalización SIP de su clúster de CXone, proporcionados por NICE. 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á Placecall, escrito de la forma en que CXone 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: esto devuelve409.
Las direcciones de CXone se comparten entre todos sus clientes, por lo que cualquier otro cliente de CXone que marque el número llegará a su agente. Cuando elija el número, elija uno largo que nadie adivinaría (hasta 15 dígitos), asegúrese de que CXone lo envíe a ThunderPhone en lugar de a la red telefónica y no lo publique.
2. Envíe llamadas con contexto
En su script de Studio, antes de Placecall:
- Agregue una acción Sipputheader con el encabezado
X-Call-IDy el valor deContactID. CXone no envía un encabezado de id de llamada propio; ThunderPhone almacena este como elexternal_call_idde la llamada. - Agregue una acción Sipputheader para cada otro valor que el agente deba conocer,
como
X-Skillconfigurado comosupport. Llega al prompt como{{sip_x_skill}}. Sipputheader aceptaUser-to-User, cualquier encabezadoX-y la mayoría de los encabezadosP-; NICE recomienda valores de 256 caracteres o menos.
Luego use Placecall para llamar a ese número mediante un grupo de troncales que lo envíe a
sip.thunderphone.com con el número tanto en el URI de solicitud como en el encabezado To.
El endpoint acepta TLS (puerto 5061) o TCP (puerto 5060) y rechaza
UDP. NICE no documenta el transporte de la troncal, así que asegúrese de que no sea
UDP.
3. Recupere la llamada
CXone lee encabezados SIP solo en el INVITE y en su respuesta final, por lo que el
agente devuelve la llamada: se despide y cuelga, y su script vuelve a atender a
quien llama. Agregue este número de transferencia (consulte
Agregue el número de transferencia):
{"name": "NICE CXone", "action": "return"}NICE no documenta que un script continúe después de Placecall cuando finaliza la
llamada realizada. En cambio, las integraciones de CXone de otros proveedores de IA señalan al script
mediante la API Signal de CXone (POST /interactions/{contactId}/signal) antes de
colgar; ThunderPhone no la llama. Confirme con NICE cómo su script
recupera a quien llama y, luego, obtenga la transferencia con una acción de API REST:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=seguido deContactID.- Encabezado
Authorization: Bearer sk_live_…. - Lea
handoff.summaryyhandoff.intentde la respuesta para enrutar el contacto.
Consulte Busque una llamada transferida.
Pruébalo
Llama a un número que ejecute el script, pídele al agente a una persona y verifica que
el script continúe y que la acción de la API REST devuelva la transferencia. Si la llamada
nunca llega al agente, verifica el número que envía CXone, que su dirección de origen
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 incluir x-call-id y
external_call_id debería ser igual a ContactID.
Límites
- CXone envía y lee encabezados solo en el
INVITEy su2xxfinal, por lo que nada delBYEdel agente llega al script. - NICE no documenta la aceptación de un
REFERdel agente. - La acción de la API REST agota el tiempo de espera después de 10 segundos de forma predeterminada (como máximo, menos de 90) y lee respuestas de hasta 32 KB.