---
title: "Conectarse desde NICE CXone"
description: "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](/es/guides/api-keys) 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](/es/guides/sip-addresses)):

```bash
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](/es/guides/contact-centers/overview)):

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
