---
title: "Conectar a partir do Zoom Contact Center"
description: "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](/pt/guides/api-keys) 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](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- 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](/pt/guides/sip-addresses)):

```bash
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](/pt/guides/contact-centers/overview)),
com o endereço do SBC fornecido pela Zoom:

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
