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

Contact centers

Conectar a partir do Genesys Cloud

Envie chamadas do Genesys Cloud para um agente do ThunderPhone por meio de um tronco BYOC Cloud com o ID da conversa e UUI, e retorne-as com a transferência em UUI.

Seu fluxo do Architect envia quem liga ao agente por um tronco BYOC Cloud, com o ID da conversa e qualquer UUI que você definir. Quando quem liga precisa falar com uma pessoa, o agente envia um REFER SIP, o Genesys recupera a chamada, e o ID de transferência chega na UUI da chamada.

Antes de começar

  • Um agente do ThunderPhone e uma chave de API da organização.
  • Genesys Cloud com BYOC Cloud e um tronco externo (tipo BYOC Carrier ou PBX) com estas configurações ativadas (configurações de tronco externo):
    • Cabeçalhos de conversa, para que o Genesys envie o ID da conversa em x-inin-cnv. Essa opção fica desativada por padrão.
    • Passagem de UUI, com tipo de cabeçalho User-To-User e codificação Hex.
    • Recuperar e transferir, para que o Genesys aceite o REFER do agente.

1. Crie o endpoint SIP

O Genesys responde a uma solicitação de autenticação digest, então use um endpoint padrão:

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": "Genesys Cloud"}'

Armazene imediatamente o password da resposta; ele é exibido apenas uma vez. No tronco:

ConfiguraçãoValor
Servidor SIPsip.thunderphone.com, porta 5061
ProtocoloTLS
Autenticação digesto username e o password do endpoint
CodecsPCMU, PCMA ou G.722

Coloque o tronco em uma rota de saída do seu site cujo plano de numeração cubra o endereço discado pelo fluxo.

2. Envie chamadas com contexto

No seu fluxo do Architect:

  1. Opcionalmente, adicione uma ação Definir dados UUI com contexto para o agente, como account=12345. O Genesys recomenda 128 caracteres ou menos.
  2. Adicione uma ação Transferir para número com o sip_uri do endpoint, por exemplo, sip:agent-12-jhxmginwjx@sip.thunderphone.com.

O Genesys envia o ID da conversa em x-inin-cnv. O ThunderPhone o armazena como o external_call_id da chamada. A UUI chega ao prompt decodificada, como {{sip_uui}}.

Os cabeçalhos personalizados do tronco são estáticos no Genesys, então coloque os valores por chamada na UUI. O Genesys reserva os prefixos de cabeçalho x-inin, x-genesys, x-pcv e x-gcv para uso próprio.

3. Recupere a chamada

O agente transfere com um REFER para um endereço no Genesys, com o ID de transferência como UUI hexadecimal dentro desse endereço. Adicione este número de transferência (consulte Adicionar o número de transferência e Cabeçalhos dentro do endereço de transferência):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Substitua o endereço por um que encaminhe de volta para a fila ou o fluxo que deve receber quem liga; confirme o formato com o Genesys. O REFER tem esta aparência:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Com Recuperar e transferir ativado, o Genesys recupera a chamada do tronco e a encaminha para esse endereço. O Genesys documenta que a UUI de entrada chega em Call.UUIData; ele não documenta isso para uma recuperação, então confirme com o Genesys, ou em uma chamada de teste, que o fluxo que recebe quem liga encontra o ID de transferência ali. Para obter o resumo e a intenção, faça a consulta da transferência com uma Ação de dados de chamada em uma integração Web Services Data Actions:

  • Solicitação: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= seguido pelo ID de Call.UUIData.
  • Credenciais: sua chave de API, enviada como Authorization: Bearer sk_live_….
  • Saída: mapeie handoff.summary e handoff.intent para variáveis do fluxo.

Consulte Consultar uma chamada transferida.

Teste

Ligue para um número que alcance o fluxo, peça ao agente uma pessoa e verifique se o Genesys encaminha a chamada para o endereço que você definiu. Nesse fluxo, verifique se Call.UUIData contém o ID de transferência como texto (se ele mostrar dígitos hexadecimais, verifique se a codificação UUI do tronco está em Hex). Em seguida, abra a chamada com GET /v1/calls/{call_id}: external_call_id deve ser o ID da conversa.

Limites

  • A ação Obter cabeçalhos SIP lê apenas o INVITE inicial, portanto não consegue ler nada do REFER do agente. A transferência chega ao Genesys apenas por UUI.
  • O Genesys descarta todos os dados UUI quando uma chamada contém mais de um cabeçalho UUI.
  • O endereço de transferência é limitado a 254 caracteres, portanto uma UUI longa é cortada para caber. Um ID de transferência sempre cabe.