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

Contact centers

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 /16 o más específico (IPv6 /48 o 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 devuelve 409.

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:

  1. Agregue una acción Sipputheader con el encabezado X-Call-ID y el valor de ContactID. CXone no envía un encabezado de id de llamada propio; ThunderPhone almacena este como el external_call_id de la llamada.
  2. Agregue una acción Sipputheader para cada otro valor que el agente deba conocer, como X-Skill configurado como support. Llega al prompt como {{sip_x_skill}}. Sipputheader acepta User-to-User, cualquier encabezado X- y la mayoría de los encabezados P-; 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 de ContactID.
  • Encabezado Authorization: Bearer sk_live_….
  • Lea handoff.summary y handoff.intent de 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 INVITE y su 2xx final, por lo que nada del BYE del agente llega al script.
  • NICE no documenta la aceptación de un REFER del 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.