Open in
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-Usere codificação Hex. - Recuperar e transferir, para que o Genesys aceite o
REFERdo agente.
- Cabeçalhos de conversa, para que o Genesys envie o ID da conversa em
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ção | Valor |
|---|---|
| Servidor SIP | sip.thunderphone.com, porta 5061 |
| Protocolo | TLS |
| Autenticação digest | o username e o password do endpoint |
| Codecs | PCMU, 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:
- Opcionalmente, adicione uma ação Definir dados UUI com contexto para o agente, como
account=12345. O Genesys recomenda 128 caracteres ou menos. - Adicione uma ação Transferir para número com o
sip_urido 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 deCall.UUIData. - Credenciais: sua chave de API, enviada como
Authorization: Bearer sk_live_…. - Saída: mapeie
handoff.summaryehandoff.intentpara 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
INVITEinicial, portanto não consegue ler nada doREFERdo 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.