Usando webhook de saída com zoom

Para usar o recurso de bate-papo do Zoom, você precisa configurar um aplicativo de bate-papo chamado Outgoing Webhooks que permite que você envie informações e receba notificações nos endpoints que você especificar.

Pré-requisitos para usando Saída Webhook

• Você deve estar familiarizado com o processo de envio de solicitações HTTP POST usando um token e um endpoint

• No Zoom App Marketplace, o Outgoing Webhook Chat foi pré-aprovado para inclusão
  Observação: Seu administrador do Zoom poderá ajudá-lo se o aplicativo não tiver sido pré-aprovado.

Como instalar Webhook de saída do Zoom App Marketplace

1. Faça login com sua conta Zoom para acessar o Zoom App Marketplace.

2. Pesquise Webhook de saída na caixa de pesquisa no canto superior direito da tela para localizar o aplicativo em seu dispositivo.

3. Encontre o aplicativo Outgoing Webhook nos resultados da pesquisa e clique nele para abri-lo.

4. Adicione o item ao seu carrinho.

5. Clique em Autorizar depois de confirmar que o aplicativo precisa das permissões necessárias.
   O aplicativo Zoom Chat irá notificá-lo assim que o processo for concluído, enviando uma notificação.
   Observação: o cliente de área de trabalho Zoom instalará automaticamente o aplicativo de bate-papo Outgoing Webhook para você, caso seu administrador o tenha instalado em o servidor Zoom.

Como usar o aplicativo Webhook de saída

Configurar o aplicativo Webhook de saída

1. O cliente de desktop do Zoom pode ser acessado fazendo login.

2. Você encontrará a guia Bate-papo no lado esquerdo da tela.

3. Localizado em BOTS no lado esquerdo da página, você encontrará o chatbot que lida com os webhooks recebidos.
   Também é possível acessar o canal de chat de sua preferência.

4. Envie uma mensagem digitando conectar e enviando-a. Se você navegou para um canal diferente de Outgoing, será necessário digitar o comando /trigger connect se você navegou para outro canal.
   Uma mensagem de sucesso de conexão será enviado para você pelo aplicativo de chat e um link será fornecido para você configurar o webhook.

5. O link pode ser encontrado clicando aqui.
   Ao abrir a página da Web, você verá várias configurações que podem ser alteradas:

   • Nome do canal: O canal no qual você iniciará o comando “conectar” será este.

   • Trigger Word(s): Selecione os comandos que você gostaria que seus pontos de extremidade recebessem da linha de comando. Por exemplo: o payload está configurado para enviar a você uma mensagem que diz “trigger fazer create ticket” que contém a palavra “create ticket”.

   • URL(s): Você precisará inserir seus comandos de palavra de gatilho (um por linha) para recebê-los.

   • Token: haverá um token incorporado na carga do seu endpoint que será enviado pelo Zoom. Para verificar se a solicitação foi originada do seu chat do Zoom, você pode usar este método.

   • URL de retorno de chamada: neste cenário, os gatilhos serão enviados de volta ao canal de bate-papo do Zoom para respondê-los. O token junto com isso deve ser usado em conjunto um com o outro

6. Por favor Clique no Botão Salvar.

Envie mensagens personalizadas para o Zoom Chat

Se o seu sistema for acionado, ele enviará uma mensagem formatada de volta ao usuário por meio do bate-papo do Zoom em resposta ao acionador. Uma mensagem no aplicativo de bate-papo pode ser de nove tipos, incluindo uma mensagem, uma ação, um campo, uma seleção, um anexo ou uma seção.

Além de escolher o tipo de mensagem que deseja enviar, você também pode especificar o estilo e a funcionalidade de sua mensagem. Recomendamos que você leia nosso artigo sobre como personalizar mensagens no Marketplace para obter mais informações.

Comandos disponíveis

Listar todos os comandos disponíveis

Uma lista de comandos está disponível digitando help no canal de bate-papo 1:1 Outgoing Webhook ou digitando /trigger help em seu canal Zoom Chat.

Novo Conexão

Se você preferir usar o Zoom Chat, digite /trigger connect no grupo Zoom Chat desejado para gerar uma nova conexão por meio do canal de bate-papo Webhook de saída 1:1 ou /connection no grupo Zoom Chat desejado. Crie a configuração clicando no link.

Visualizar Configurações

Configure (all) é o comando a ser digitado no canal de chat Webhook de saída 1:1 ou /trigger configure (all) a ser digitado no canal Zoom Chat se você deseja receber uma lista de suas configurações junto com o link para modificar cada um.

Fazer Comando

No canal de bate-papo Webhook de saída 1:1, você pode digitar do + (suas palavras de gatilho configuradas) + (Shift+Enter) + (seu texto desejado) ou /trigger do + (suas palavras de gatilho configuradas) + (Shift+Enter) + (Seu texto desejado) para enviar uma mensagem e ter o payload enviado às suas URLs configuradas digitando do + (suas palavras de ativação configuradas) + (Shift+Enter) + (seu texto desejado). Os dados serão enviados pelo aplicativo de chat.

desconectar

No canal de bate-papo Webhook de saída 1:1, digite desconectar ou /trigger desconectar no canal de bate-papo Zoom que você deseja remover assinatura to remova a assinatura do canal de bate-papo atual no canal de bate-papo Webhook de saída 1:1. Para confirmar, clique no botão OK.

Desconectar todas as assinaturas

Para remover a assinatura do canal de bate-papo atual, digite /trigger desconecte tudo no canal de bate-papo do Zoom desejado ou /trigger desconecte tudo no canal de bate-papo Webhook de saída 1:1 para cancelar a assinatura desse canal. Para confirmar, clique no botão OK.

Como desinstalar o aplicativo de bate-papo Webhook de saída

1. O Zoom Marketplace pode ser acessado após fazer login na sua conta Zoom.

2. Nos resultados da pesquisa por Webhook de saída, selecione o aplicativo e clique nele ou nelesanage da lista de aplicativos, clique no link Adicionar aplicativos dentro do aplicativo.

3. Na seção Webhook de saída, clique no botão Remover.

4. Clique no botão Remover depois de confirmar a caixa de diálogo.

A equipe de suporte do Zoom está disponível para fornecer assistência adicional, se necessário.