Open in
Conectar a partir do Five9
Envie chamadas do Five9 para um agente do ThunderPhone por SIP com o AI Agent Connect e receba-as de volta com cabeçalhos de roteamento lidos pelo seu script de URA.
O script de URA do Five9 encaminha quem liga ao agente com os detalhes da
chamada do Five9. Quando o agente termina, ele encerra a chamada com cabeçalhos
de roteamento no SIP BYE, que o script lê em variáveis da chamada para
encaminhar quem liga.
Antes de começar
- Um agente ThunderPhone e uma chave de API da organização.
- O complemento AI Agent Connect do Five9. O Five9 o limita a provedores de IA que credenciou, e a equipe de implementação do Five9 o configura: ela importa o modelo de script de URA do provedor, cria as variáveis da chamada e aponta o módulo Transferência para Terceiros do script para o provedor. O ThunderPhone ainda não está na lista de credenciados do Five9: consulte sua equipe de conta do Five9 ou o suporte do ThunderPhone antes de planejar com base nisso.
1. Crie o endpoint SIP
O módulo de Transferência para Terceiros do Five9 disca um número de telefone,
não um endereço SIP, e as integrações do Five9 de outros provedores autenticam
o Five9 pelo endereço de origem, e não por uma senha. Portanto, crie um
endpoint ip_allowlist com o número que o Five9 discará como um número de
discagem 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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: os intervalos de sinalização SIP dos seus data centers do Five9, fornecidos pelo Five9. Cada um deve ser um intervalo IPv4 público de/16ou mais restrito (IPv6/48ou mais restrito).dial_in_numbers: o número que o script do Five9 discará, escrito da forma como o Five9 o envia. Ele 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 Five9 são compartilhados por todos os seus clientes, portanto qualquer outro cliente do Five9 que discar o número chegará ao seu agente. Ao escolher o número, escolha um longo que ninguém adivinharia (até 15 dígitos), garanta que o Five9 o envie ao ThunderPhone em vez de encaminhá-lo para a rede telefônica e não o publique.
2. Envie chamadas com contexto
Peça à equipe de implementação do Five9 para:
- Enviar a chamada do módulo Transferência para Terceiros para
sip:+14155550188@sip.thunderphone.com, com o número tanto na URI de solicitação quanto no cabeçalhoTo. O módulo recebe o número, com o domínio SIP do provedor em um cabeçalho. - Enviá-la por TLS (porta 5061) ou TCP (porta 5060). O endpoint recusa UDP, e o Five9 não informa qual transporte usa; portanto, garanta que não seja UDP.
- Ativar Retornar após chamada de terceiros, para que o script continue quando o agente encerrar a chamada (o Five9 permite até 3.600 segundos na chamada de terceiros).
O guia do Five9 lista os valores que ele envia (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name e outros), mas não os
nomes dos cabeçalhos. As integrações do Five9 de outros provedores de IA os
documentam no tráfego como X-CallANI, X-CallDNIS, X-CallID,
X-CallSessionID, X-CallCampaign e X-AgentID; verifique-os na sua primeira
chamada de teste. Cada um chega ao prompt como uma variável, como
{{sip_x_callcampaign}}. X-CallID é armazenado como o
external_call_id da chamada.
3. Receba a chamada de volta
O agente devolve a chamada: ele se despede e encerra a chamada, e o BYE contém
os quatro cabeçalhos que o script do Five9 lê. Adicione este número de transferência (consulte
Adicionar o número de transferência):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeeX-RouteValueinformam ao script para onde enviar quem liga, neste caso, a habilidade Support. Os valores que outros provedores documentam paraX-RouteTypeincluemSkillTransfer,PhoneTransfer,HangupeDispositionOnly; combine os valores com quem mantém o script. Para vários destinos, adicione um retorno por destino com um nome eX-RouteValuediferentes.X-RouteReasoncontém o rótulo da intenção do agente, comobilling_dispute.X-CustomMetaDatacontém o ID da transferência. OBYEtambém o contém comoX-TP-Handoff-Id, que o Five9 não lê.
O script do Five9 mapeia os quatro cabeçalhos para variáveis da chamada. Para o
resumo do agente, faça o script chamar a consulta de transferência com um módulo de URA Consulta:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= seguido de
call.call_id, com um Perfil de autorização que envie
Authorization: Bearer e sua chave de API. Consulte
Consultar uma chamada transferida.
Teste
Ligue para o script de URA, peça ao agente para transferir para uma pessoa e verifique se o script
encaminha quem liga com as variáveis da chamada preenchidas. Se a chamada nunca chegar ao
agente, verifique se o número no URI da solicitação e no cabeçalho To corresponde ao
número de discagem, se o endereço de origem do Five9 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-callid, e
external_call_id deve corresponder a call.call_id no Five9.
Limites
- O guia do Five9 documenta dados de roteamento no
BYEe não menciona a aceitação de umREFER, portanto a devolução é uma transferência fria pelo script. - O Five9 lê
X-RouteType,X-RouteValue,X-RouteReasoneX-CustomMetaData, nãoUser-to-User. O ThunderPhone envia cada valor de cabeçalho com no máximo 256 bytes. - O Five9 recomenda manter cerca de dez cabeçalhos personalizados para evitar a fragmentação de pacotes.