---
title: "Conectar a partir do NICE CXone"
description: "Envie chamadas do NICE CXone para um agente do ThunderPhone a partir de um script do Studio com o ContactID em um cabeçalho SIP e consulte a transferência do agente quando o script continuar."
---

Seu script do CXone Studio faz uma chamada para o agente com cabeçalhos SIP que carregam
o ID do contato e qualquer outro contexto. Quando o agente termina, ele desliga, e
uma ação de API REST no script busca o repasse.

## Antes de começar

- Um agente do ThunderPhone e uma [chave de API](/pt/guides/api-keys) da organização.
- Um grupo de tronco SIP do CXone que aceite cabeçalhos personalizados. Seu representante
  de conta da NICE precisa ativar essa configuração antes que o CXone os envie.

## 1. Crie o endpoint SIP

O Placecall disca um número de telefone por um grupo de tronco do CXone, não um endereço SIP.
A NICE não documenta as credenciais SIP para isso, e a integração com CXone de outro
provedor de IA usa TLS com uma lista de permissão de IPs. Portanto, crie um endpoint
`ip_allowlist` com o número que o script discará como número de entrada (consulte
[Plataformas que discam um número de telefone](/pt/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`: os intervalos de sinalização SIP do seu cluster CXone,
  fornecidos pela NICE. Cada um deve ser um intervalo IPv4 público de `/16` ou mais
  específico (IPv6 `/48` ou mais específico).
- `dial_in_numbers`: o número que o Placecall discará, escrito da forma como o
  CXone o envia. Não precisa ser um número de telefone real. Ele não pode já estar
  em uso no ThunderPhone, como número de telefone ou em outro endpoint: isso retorna
  `409`.

Os endereços do CXone são compartilhados por todos os clientes, portanto qualquer outro
cliente do CXone que discar o número chegará ao seu agente. Ao escolher o número,
escolha um número longo que ninguém adivinharia (até 15 dígitos), certifique-se de que
o CXone o envie para o ThunderPhone em vez de encaminhá-lo para a rede telefônica e
não o publique.

## 2. Envie chamadas com contexto

No seu script do Studio, antes de **Placecall**:

1. Adicione uma ação **Sipputheader** com o cabeçalho `X-Call-ID` e o valor de
   `ContactID`. O CXone não envia um cabeçalho de ID de chamada próprio; o ThunderPhone
   armazena este como o `external_call_id` da chamada.
2. Adicione uma ação **Sipputheader** para cada outro valor que o agente deve conhecer,
   como `X-Skill` definido como `support`. Ele chega ao prompt como
   `{{sip_x_skill}}`. O Sipputheader aceita `User-to-User`, qualquer cabeçalho `X-` e
   a maioria dos cabeçalhos `P-`; a NICE recomenda valores de 256 caracteres ou menos.

Em seguida, use **Placecall** para esse número, por um grupo de tronco que o envie para
`sip.thunderphone.com` com o número tanto no URI da solicitação quanto no cabeçalho `To`.
O endpoint aceita TLS (porta 5061) ou TCP (porta 5060) e recusa UDP, e a NICE não
documenta o transporte do tronco, portanto verifique se não é UDP.

## 3. Recupere a chamada

O CXone lê cabeçalhos SIP somente no `INVITE` e em sua resposta final, então o
agente devolve a chamada: ele se despede e desliga, e seu script retoma quem liga.
Adicione este número de transferência (consulte
[Adicionar o número de transferência](/pt/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

A NICE não documenta que um script continua após o Placecall quando a chamada realizada
termina. As integrações com CXone de outros provedores de IA, em vez disso, sinalizam o
script pela API Signal do CXone (`POST /interactions/{contactId}/signal`) antes de
desligar; o ThunderPhone não a chama. Confirme com a NICE como seu script retoma quem
liga e, em seguida, busque o repasse com uma ação de **API REST**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  seguido de `ContactID`.
- Cabeçalho `Authorization: Bearer sk_live_…`.
- Leia `handoff.summary` e `handoff.intent` na resposta para encaminhar o
  contato.

Consulte [Buscar uma chamada repassada](/api-reference/calls#look-up-a-handed-off-call).

## Teste

Ligue para um número que executa o script, peça ao agente uma pessoa e verifique se
o script continua e se a ação da API REST retorna a transferência. Se a chamada
nunca chegar ao agente, verifique o número enviado pelo CXone, se o endereço de
origem está em `allowed_source_cidrs` e se a chamada ocorreu por TCP ou TLS. Em seguida, abra a
chamada com `GET /v1/calls/{call_id}`: `sip_headers` deve listar `x-call-id`, e
`external_call_id` deve ser igual ao `ContactID`.

## Limites

- O CXone envia e lê cabeçalhos apenas no `INVITE` e em seu `2xx` final, portanto
  nada no `BYE` do agente chega ao script.
- A NICE não documenta a aceitação de um `REFER` do agente.
- A ação da API REST expira após 10 segundos por padrão (no máximo, menos de 90)
  e lê respostas de até 32 KB.
