Zoom
Criar e administrar reuniões e gravações no Zoom.
O que faz
Integre o Zoom aos seus fluxos. Crie, liste, atualize e exclua reuniões do Zoom. Consulte detalhes, convites, gravações e participantes das reuniões. Gerencie as gravações na nuvem de forma automatizada.
Quando usar: Use quando o seu fluxo precisar criar e administrar reuniões e gravações no Zoom.
Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Zoom ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Para configurar o gatilho
- Copie a URL do webhook acima.
- Acesse o Zoom Marketplace e crie ou abra um app Webhook-only ou um app geral com Event Subscriptions ativado (eventos de reunião ou de gravação, conforme a necessidade). Webhooks no nível da conta podem exigir a aprovação de um administrador.
- Copie o Secret Token na página Features do seu app do Zoom e cole no campo Token secreto acima.
- Clique em "Salvar configuração" acima para ativar o gatilho.
- Vá em Features > Event Subscriptions e clique em Add Event Subscription.
- Dê um nome à assinatura e cole a URL do webhook no campo Event notification endpoint URL.
- Clique em Validate para verificar o endpoint.
- Clique em Add Events e selecione o tipo de evento meeting.started.
- Salve a assinatura de eventos no Zoom.
Operações
| Operação | O que faz |
|---|---|
| Criar reunião | Cria reunião com o bloco Zoom. |
| Listar reuniões | Lista reuniões com o bloco Zoom. |
| Obter reunião | Obtém reunião com o bloco Zoom. |
| Atualizar reunião | Atualiza reunião com o bloco Zoom. |
| Excluir reunião | Exclui reunião com o bloco Zoom. |
| Obter convite da reunião | Obtém convite da reunião com o bloco Zoom. |
| Listar gravações | Lista gravações com o bloco Zoom. |
| Obter gravações da reunião | Obtém gravações da reunião com o bloco Zoom. |
| Excluir gravação | Exclui gravação com o bloco Zoom. |
| Listar participantes de reuniões realizadas | Lista participantes de reuniões realizadas com o bloco Zoom. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Criar reunião · Listar reuniões · Obter reunião · Atualizar reunião · Excluir reunião · Obter convite da reunião · Listar gravações · Obter gravações da reunião · Excluir gravação · Listar participantes de reuniões realizadas
- Padrão:
- Criar reunião
Conta do Zoom
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Zoom
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
ID do usuário
Obrigatório conforme a operaçãoInforma o identificador exato do recurso na plataforma conectada.
- Aparece em:
- Criar reunião, Listar reuniões, Listar gravações
- Exemplo:
- id-do-recurso
Reunião
Obrigatório conforme a operaçãoSelecione a reunião do Zoom.
- Aparece em:
- Obter reunião, Atualizar reunião, Excluir reunião, Obter convite da reunião, Obter gravações da reunião, Excluir gravação, Listar participantes de reuniões realizadas
- Exemplo:
- (escolha na lista do campo)
ID da reunião
Obrigatório conforme a operaçãoEm campos adicionaisInforme o ID da reunião.
- Aparece em:
- Obter reunião, Atualizar reunião, Excluir reunião, Obter convite da reunião, Obter gravações da reunião, Excluir gravação, Listar participantes de reuniões realizadas
- Exemplo:
- id-do-recurso
Tópico
Obrigatório conforme a operaçãoTema da reunião.
- Aparece em:
- Criar reunião
- Exemplo:
- Tema da reunião
Tópico
Tema da reunião (opcional).
- Aparece em:
- Atualizar reunião
- Exemplo:
- 2026-09-15
Tipo de reunião
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar reunião, Atualizar reunião
- Opções:
- Agendada · Instantânea · Recorrente (sem horário fixo) · Recorrente (com horário fixo)
- Padrão:
- Agendada
Data e hora de início
Define a data, o horário ou a programação usada pela operação.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- 09:00
Duração (minutos)
Define por quanto tempo a execução deve aguardar.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- 30
Fuso horário
Em campos adicionaisDefine a data, o horário ou a programação usada pela operação.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- 09:00
Senha
Em campos adicionaisDado protegidoSenha da reunião.
- Aparece em:
- Criar reunião, Atualizar reunião
- Padrão:
- Segredo protegido
Pauta
Em campos adicionaisPauta da reunião.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- Pauta da reunião
Vídeo do anfitrião
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- false
Vídeo dos participantes
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- false
Entrar antes do anfitrião
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- false
Silenciar ao entrar
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- false
Sala de espera
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Criar reunião, Atualizar reunião
- Exemplo:
- false
Gravação automática
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar reunião, Atualizar reunião
- Opções:
- Nenhum · Local · Nuvem
- Padrão:
- Nenhum
Filtro por tipo de reunião
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Listar reuniões
- Opções:
- Agendada · Ao vivo · Próximas · Próximas reuniões · Reuniões anteriores
- Padrão:
- Agendada
Itens por página
Em campos adicionaisQuantidade de resultados (máx. 300).
- Aparece em:
- Listar reuniões, Listar gravações, Listar participantes de reuniões realizadas
- Exemplo:
- 10
Token da página
Em campos adicionaisToken da próxima página.
- Aparece em:
- Listar reuniões, Listar gravações, Listar participantes de reuniões realizadas
- Exemplo:
- Token da próxima página
Data inicial
Em campos adicionaisDefine a data, o horário ou a programação usada pela operação.
- Aparece em:
- Listar gravações
- Exemplo:
- cliente@exemplo.com
Data final
Em campos adicionaisDefine a data, o horário ou a programação usada pela operação.
- Aparece em:
- Listar gravações
- Exemplo:
- 2026-09-15
ID da gravação
Em campos adicionaisID de um arquivo de gravação específico (opcional).
- Aparece em:
- Excluir gravação
- Exemplo:
- id-do-recurso
Tipo de exclusão
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Excluir gravação
- Opções:
- Mover para a lixeira · Excluir permanentemente
- Padrão:
- Mover para a lixeira
ID da ocorrência
Em campos adicionaisPara reuniões recorrentes.
- Aparece em:
- Obter reunião, Excluir reunião
- Exemplo:
- id-do-recurso
Enviar e-mail de cancelamento
Em campos adicionaisAtiva ou desativa este comportamento.
- Aparece em:
- Excluir reunião
- Exemplo:
- false
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <zoom.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<zoom.success> | boolean | Indica se a operação foi concluída com sucesso. |
<zoom.meeting> | json | Dados da reunião (create_meeting, get_meeting). |
<zoom.meetings> | json | Lista de reuniões (list_meetings). |
<zoom.invitation> | string | Texto do convite da reunião (get_meeting_invitation). |
<zoom.recording> | json | Dados da gravação (get_meeting_recordings). |
<zoom.recordings> | json | Lista de gravações (list_recordings). |
<zoom.participants> | json | Lista de participantes (list_past_participants). |
<zoom.pageInfo> | json | Informações de paginação. |
Exemplo de uso
Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.
- Operação
- Criar reunião
- Conta do Zoom
- (escolha a conta conectada)
- ID do usuário
- id-do-recurso
- Tópico
- Tema da reunião
- Tipo de reunião
- Agendada
- Data e hora de início
- 09:00
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <zoom.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- ArquivoEnviar um documento pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- ÁudioEnviar um áudio pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Botões de açãoEnviar pelo WhatsApp (Z-API) uma mensagem com botões de abrir link, ligar ou copiar código.
- Catálogo e opçõesConsultar a instância Z-API ou enviar catálogo, botões de resposta e lista de opções.
- ContatoEnviar um cartão de contato pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Copiar mensagem · TelegramCopiar mensagem usando a conexão Telegram deste workspace.