Open in
Conectar a partir do NICE CXone
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 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):
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/16ou mais específico (IPv6/48ou 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 retorna409.
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:
- Adicione uma ação Sipputheader com o cabeçalho
X-Call-IDe o valor deContactID. O CXone não envia um cabeçalho de ID de chamada próprio; o ThunderPhone armazena este como oexternal_call_idda chamada. - Adicione uma ação Sipputheader para cada outro valor que o agente deve conhecer,
como
X-Skilldefinido comosupport. Ele chega ao prompt como{{sip_x_skill}}. O Sipputheader aceitaUser-to-User, qualquer cabeçalhoX-e a maioria dos cabeçalhosP-; 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):
{"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 deContactID.- Cabeçalho
Authorization: Bearer sk_live_…. - Leia
handoff.summaryehandoff.intentna resposta para encaminhar o contato.
Consulte Buscar uma chamada repassada.
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
INVITEe em seu2xxfinal, portanto nada noBYEdo agente chega ao script. - A NICE não documenta a aceitação de um
REFERdo 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.