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

Contact centers

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 /16 ou mais restrito (IPv6 /48 ou 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 retorna 409.

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çalho To. 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-RouteType e X-RouteValue informam ao script para onde enviar quem liga, neste caso, a habilidade Support. Os valores que outros provedores documentam para X-RouteType incluem SkillTransfer, PhoneTransfer, Hangup e DispositionOnly; combine os valores com quem mantém o script. Para vários destinos, adicione um retorno por destino com um nome e X-RouteValue diferentes.
  • X-RouteReason contém o rótulo da intenção do agente, como billing_dispute.
  • X-CustomMetaData contém o ID da transferência. O BYE também o contém como X-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 BYE e não menciona a aceitação de um REFER, portanto a devolução é uma transferência fria pelo script.
  • O Five9 lê X-RouteType, X-RouteValue, X-RouteReason e X-CustomMetaData, não User-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.