---
title: Canal Zoom
slug: helper/canal-zoom
createdAt: 2026-11-19T14:26:40.547Z
---

Com o canal **Zoom**, as pessoas da sua empresa conversam com o assistente pelo **Zoom Team Chat**. O bot aparece no Team Chat com o nome do app, e cada pessoa que escreve para ele abre o próprio atendimento.

A conexão tem três partes: criar o app de chat no **Zoom App Marketplace**, conectar o canal aqui em **Canais** e voltar ao Zoom para informar o endereço do webhook e adicionar o app à conta. Nos prints, o contorno vermelho marca onde clicar, e o número segue a ordem dos itens de cada passo.

## O que você vai precisar

| No Zoom                                               | Campo em Canais    |
| ----------------------------------------------------- | ------------------ |
| Bot JID (Features → Surface → Team Chat Subscription) | Bot JID            |
| Client ID (Basic Information → App Credentials)       | Zoom Client ID     |
| Client Secret (Basic Information → App Credentials)   | Zoom Client Secret |
| Secret Token (Features → Access)                      | Zoom Secret Token  |

Basta um app, do tipo **General App**. O canal não usa um app *Server-to-Server OAuth*.

## Criar o app no Zoom

1. Em [marketplace.zoom.us](https://marketplace.zoom.us/), entre com a conta de admin e abra **Develop → Build App**.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mNZh4-Gd6pPW3Die67jrp_b5d102ef1802ca858099f0a45dd8163e.jpeg" size="190" alt="Develop → Build App" isUploading="false" initialPath="../images/b5d102ef1802ca858099f0a45dd8163e.jpeg" githubPath="images/b5d102ef1802ca858099f0a45dd8163e.jpeg" width="1902" height="200" darkWidth="1902" darkHeight="200" showCaption="false"}
2. Escolha **General App** (1) e clique em **Create** (2). Quando o Zoom perguntar como o app é gerenciado, escolha **Admin-managed**. Um app *User-managed* não serve: cada pessoa teria de instalá-lo.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/qpl2zZCLgXczsSZywkWXl_b87d5a8f575150d3c82255cfdcd43bc8.png" size="46" alt="General App → Create" isUploading="false" initialPath="../images/b87d5a8f575150d3c82255cfdcd43bc8.png" githubPath="images/b87d5a8f575150d3c82255cfdcd43bc8.png" width="462" height="435" darkWidth="462" darkHeight="435" showCaption="false"}
3. O app nasce com um nome como "General app 613". Troque o nome no lápis (1): é com ele que o bot aparece no Team Chat. Enquanto o app não for publicado, use sempre os valores da aba **Development** (2).

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/UXCiBEeTorqdBF0rNxAp2_9061e1bfffd85267b13736ca6826a789.png" size="145" alt="O nome do app é o nome do bot" isUploading="false" initialPath="../images/9061e1bfffd85267b13736ca6826a789.png" githubPath="images/9061e1bfffd85267b13736ca6826a789.png" width="1446" height="53" darkWidth="1446" darkHeight="53" showCaption="false"}

## Credenciais

1. Em **Basic Information → App Credentials**, copie o **Client ID** (1) e o **Client Secret** (2).

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/7u7fJKza1GBopZgsbNsfG_f6aee5d80254972476f88cb5d6caedf1.png" size="59" alt="Client ID e Client Secret" isUploading="false" initialPath="../images/f6aee5d80254972476f88cb5d6caedf1.png" githubPath="images/f6aee5d80254972476f88cb5d6caedf1.png" width="587" height="214" darkWidth="587" darkHeight="214" showCaption="false"}
2. Ainda em **Basic Information**, em **OAuth Information**, preencha o **OAuth Redirect URL** (1) e a **OAuth Allow Lists** (2) com o mesmo endereço https. É a página que abre depois que o admin autoriza o app; o canal não usa esse retorno, então qualquer endereço https serve, como [https://zoom.us](https://zoom.us/). O **OAuth URL** (3) é o link para adicionar o app à conta (passo 14).

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/3_Ztpd5q0exs3Q0kFJms6_667bd572625adf5cbb1781b23fa71b1c.jpeg" size="65" alt="Redirect URL, Allow Lists e OAuth URL" isUploading="false" initialPath="../images/667bd572625adf5cbb1781b23fa71b1c.jpeg" githubPath="images/667bd572625adf5cbb1781b23fa71b1c.jpeg" width="645" height="580" darkWidth="645" darkHeight="580" showCaption="false"}
3. Em **Features → Access** (1), copie o **Secret Token**. Com ele a plataforma confere a assinatura de cada mensagem que o Zoom envia. O item **Local Test** (2) é usado no passo 14.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/jQjAs8TLW725zRTRrDdXd_c2a283869484629eea3a79bc5c71342e.png" size="26" alt="Access e Local Test" isUploading="false" initialPath="../images/c2a283869484629eea3a79bc5c71342e.png" githubPath="images/c2a283869484629eea3a79bc5c71342e.png" width="255" height="470" darkWidth="255" darkHeight="470" showCaption="false"}

## Ligar o chat do bot

1. Em **Features → Surface** (1), selecione **Chat** (2).

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/lbMGHfK6J49qY6kuBFeDP_a30c18c45816130a8e415d571bb09508.jpeg" size="136" alt="Surface → Chat" isUploading="false" initialPath="../images/a30c18c45816130a8e415d571bb09508.jpeg" githubPath="images/a30c18c45816130a8e415d571bb09508.jpeg" width="1363" height="802" darkWidth="1363" darkHeight="802" showCaption="false"}
2. Na mesma tela, ligue a **Team Chat Subscription** e abra os detalhes dela. O Zoom só mostra o Bot JID depois de salvar um **Bot Endpoint URL**, e o endereço certo (o webhook do canal) só existe depois de conectar o canal na plataforma. Por isso, ponha por enquanto um endereço https provisório no **Bot Endpoint URL** (1), como [https://zoom.us](https://zoom.us/), e clique em **Save** (2). Ele é trocado no passo 13.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/vwiERgkkDCG-esFum5qMy_261e79092c0dc481c70b7d5905474dc2.png" size="57" alt="Bot Endpoint URL → Save" isUploading="false" initialPath="../images/261e79092c0dc481c70b7d5905474dc2.png" githubPath="images/261e79092c0dc481c70b7d5905474dc2.png" width="569" height="494" darkWidth="569" darkHeight="494" showCaption="false"}
3. Depois de salvar, a **Team Chat Subscription** (1) mostra o **Bot JID**. Copie-o (2): ele termina em @xmpp.zoom.us.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/OgKTY8RwQW6fpOsBQn8xD_8f769a8826ecc883d486159616315721.png" size="56" alt="Bot JID" isUploading="false" initialPath="../images/8f769a8826ecc883d486159616315721.png" githubPath="images/8f769a8826ecc883d486159616315721.png" width="560" height="241" darkWidth="560" darkHeight="241" showCaption="false"}
4. Em **Scopes** (1), confira se o **imchat\:bot** (2) está na lista. Ele entra sozinho com a Team Chat Subscription e é o único escopo de que o canal precisa.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/tGFz-YT70-iXUc8SyBdQh_00fa4a8c3ddf3bce9083438e9cc7f561.jpeg" size="123" alt="imchat" isUploading="false" initialPath="../images/00fa4a8c3ddf3bce9083438e9cc7f561.jpeg" githubPath="images/00fa4a8c3ddf3bce9083438e9cc7f561.jpeg" width="1229" height="600" darkWidth="1229" darkHeight="600" showCaption="false"}

## Conectar o canal na plataforma

1. Em **Canais**, no card **Zoom**, clique em **Conectar**. Escolha o assistente e preencha **Bot JID**, **Zoom Client ID**, **Zoom Client Secret** e **Zoom Secret Token**. Clique em **Testar conexão**: o esperado é *O Zoom autenticou o bot (token com o escopo imchat\:bot)*. Depois, clique em **Conectar**.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Xa5SnhRZQFS8Y_g9ZuDOS_397a48037c4314ec90981501037111ec.png" size="48" alt="Os quatro campos, Testar conexão e Conectar" isUploading="false" initialPath="../images/397a48037c4314ec90981501037111ec.png" githubPath="images/397a48037c4314ec90981501037111ec.png" width="480" height="735" darkWidth="480" darkHeight="735" showCaption="false"}
2. No card **Zoom**, clique em **Gerenciar** e copie o **endereço do webhook** da conexão.

   ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/X6i1V-NtAsCdvUjPgT3Pp_2795bb85198548ec98a29c27adba380a.png" size="60" alt="Copiar o endereço do webhook" isUploading="false" initialPath="../images/2795bb85198548ec98a29c27adba380a.png" githubPath="images/2795bb85198548ec98a29c27adba380a.png" width="600" height="342" darkWidth="600" darkHeight="342" showCaption="false"}

## Informar o webhook e adicionar o app

1. De volta ao Zoom, em **Features → Surface → Team Chat Subscription**, troque o endereço provisório do **Bot Endpoint URL** pelo endereço do webhook e clique em **Save** (o mesmo campo do passo 8).
2. Em **Local Test**, clique em **Add App Now** e autorize com a conta de admin (ou abra o **OAuth URL** do passo 5). Depois de autorizar, o navegador vai para o endereço de retorno do passo 5: o app já foi adicionado à conta.

## Testar

1. No Zoom Workplace instalado no **Windows, Mac, Linux ou celular**, abra o **Team Chat**, procure o bot pelo nome do app e mande "oi". O assistente responde, e a conversa aparece no **Atendimento** como canal Zoom.

## O que o bot mostra no Zoom

| O assistente manda                    | No Zoom aparece                                              |
| ------------------------------------- | ------------------------------------------------------------ |
| Texto com negrito, itálico ou tachado | O texto com a formatação                                     |
| Menu de até 3 opções                  | Botões. Depois do clique, …                                  |
| Menu com mais opções                  | Lista suspensa numerada. …                                   |
| Imagem, vídeo, áudio ou documento     | Cartão com o nome e o ícone do arquivo e o link para abri-lo |
| Localização                           | O nome em negrito, o endereço e o link Abrir no mapa         |
| Contato                               | 👤 nome e 📞 telefone                                        |
| Link                                  | Texto clicável                                               |

- O Zoom não deixa o bot enviar o arquivo em si: vai um cartão com o link para abri-lo.
- Digitar o número ou o nome da opção também vale. Nesse caso o cartão do menu não fica marcado.

## Quem pode falar com o bot

- Todas as pessoas da conta Zoom em que o app foi adicionado. Cada uma abre o próprio atendimento, e as respostas voltam para quem escreveu.
- Enquanto o app estiver em **Draft** (não publicado), só funciona para quem é usuário **da mesma conta Zoom** em que ele foi criado: a conta da empresa no Zoom, onde o admin adiciona as pessoas (Admin → Gerenciamento de usuários → Usuários). Não é o domínio do e-mail: duas pessoas com e-mail da empresa podem estar em contas Zoom diferentes, se cada uma criou a sua. O domínio só leva a pessoa para a conta da empresa se o admin ligar os domínios associados (*Associated Domains*). Para liberar o app a outra conta, o Zoom exige o *Beta Test* ou a publicação do app, as duas com aprovação dele.
- O Zoom entrega ao bot só o texto da mensagem. Emoji sozinho, formatação e link com texto personalizado chegam vazios ou sem formatação: oriente as pessoas a escrever em texto simples.
- Arquivos e imagens enviados ao bot não chegam: o Zoom não repassa arquivos a chatbots.
