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

Contact centers

Conectar a partir do Zoom Contact Center

Envie chamadas do Zoom Contact Center para um agente de voz do ThunderPhone com um conector de voicebot de terceiros e transfira-as de volta para um agente humano com um SIP REFER.

Um widget Bot no seu fluxo do Zoom Contact Center envia quem liga ao agente com o SID da chamada do Zoom. Quando quem liga precisa de uma pessoa, o agente envia um REFER SIP ao endereço de agente humano do Zoom, e seu fluxo obtém a transferência pelo SID da chamada.

Antes de começar

  • Um agente do ThunderPhone e uma chave de API da organização.
  • Um App geral do Zoom Marketplace, gerenciado pelo seu administrador e disponibilizado para o Contact Center, com um conector para o widget Bot (guia de voicebot de terceiros do Zoom).
  • Um tronco SIP do Zoom para o provedor do bot. A equipe de ISV do Zoom o cria em etapas (descoberta, um tronco de homologação e, depois, produção), e o Nome da empresa do app deve corresponder exatamente ao registro do tronco. Essa configuração começa com o suporte do ThunderPhone e o Zoom, não apenas na sua conta do Zoom.

1. Crie o endpoint SIP

O conector do Zoom disca um número de 15 dígitos que começa com 999, não um endereço SIP. Salvar o conector gera esse número. O tronco do Zoom usa TLS 1.2 na porta 5061 com SRTP para áudio e é incluído na lista de permissões pelas sub-redes do Zoom, em vez de uma senha. Portanto, crie um endpoint ip_allowlist com o número do conector como número de discagem e SRTP obrigatório (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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: as sub-redes de sinalização SIP do Zoom, fornecidas pelo Zoom. Cada uma deve ser uma faixa IPv4 pública de /16 ou mais específica (IPv6 /48 ou mais específica).
  • dial_in_numbers: o número do conector exatamente como o Zoom o envia, sem um +.
  • srtp: required, pois o tronco do Zoom sempre usa SRTP.

Os endereços do Zoom são compartilhados por todos os clientes, portanto qualquer outro cliente do Zoom que discar o número chegará ao seu agente. O Zoom atribui o número; não o publique.

2. Envie chamadas com contexto

Adicione um widget Bot ao seu fluxo e associe-o ao conector. Peça à equipe de ISV do Zoom para apontar o tronco para sip.thunderphone.com, TLS na porta 5061, com o número do conector tanto no URI da solicitação quanto no cabeçalho To. O endpoint recusa UDP, portanto verifique se o tronco não recorre a ele.

O Zoom envia:

  • X-ZOOM-Call-Sid, armazenado como o external_call_id da chamada. A própria página de mapeamento de dados do Zoom não o lista; a integração do Zoom de outro provedor de IA o documenta, portanto verifique-o na sua primeira chamada de teste.
  • X-ZOOM-DNIS, o número que quem liga discou, como {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, a URL estática do conector.

3. Recupere a chamada

O agente envia um REFER para o endereço do atendente humano no SBC da Zoom. Adicione este número de transferência (consulte Adicionar o número de transferência), com o endereço do SBC fornecido pela Zoom:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

O guia da Zoom descreve duas formas de um bot transmitir contexto: um POST para a URL estática do conector antes do REFER (eventos voicebot_metadata e similares) e cabeçalhos SIP mapeados em Entrada do bot. O ThunderPhone não envia dados para a URL estática. O guia da Zoom não informa se ela lê cabeçalhos mapeados de um REFER; se quiser testar, adicione headers, como "X-Handoff-Id": "{{handoff_id}}", à entrada e verifique em uma chamada de teste. Confirme também com a Zoom que ela aceita um REFER sem um POST de metadados antes dele.

Para obter a transferência sem depender de nenhum dos dois, faça com que seu fluxo a consulte após o widget de bot, usando um widget de Chamada HTTP ou Script:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= seguido pelo SID da chamada.
  • Cabeçalho Authorization: Bearer sk_live_….
  • Use handoff.summary e handoff.intent para encaminhar quem liga e informar o atendente que recebe a chamada.

A Zoom não publica documentação detalhada por campo para esses widgets, portanto, confirme na sua conta que o widget pode enviar um cabeçalho Authorization. Consulte Consultar uma chamada transferida.

Teste

Ligue para um número que chegue ao widget de bot, peça ao agente para falar com uma pessoa e verifique se quem liga chega a um atendente humano e se o widget retorna a transferência. Em seguida, abra a chamada com GET /v1/calls/{call_id}: sip_headers deve listar x-zoom-call-sid, e external_call_id deve corresponder ao SID da chamada usado pelo seu fluxo.

Limites

  • O ThunderPhone não envia dados para a URL estática do conector; portanto, a Zoom recebe a transferência por meio da consulta ou pelos cabeçalhos mapeados, caso seu teste mostre que a Zoom os lê do REFER.
  • O tronco SIP é criado pela equipe de ISV da Zoom, portanto você não pode configurá-lo ou testá-lo por conta própria.