ThunderPhone v3 já está no ar.Contrate online, a partir de 2¢/min.Leia o anúncio

Contact centers

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 /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):

{"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.

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.