Open in
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/16ou mais específica (IPv6/48ou 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 oexternal_call_idda 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.summaryehandoff.intentpara 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.