Como usar fluxos de trabalho agênticos com o ZoomMate
Os fluxos de trabalho agênticos permitem automatizar tarefas repetitivas usando uma linguagem simples e cotidiana, por meio de um canvas visual flexível baseado em nós. Você pode usar fluxos de trabalho de IA agêntica a partir de modelos ou de um construtor low-code para automatizar ações de várias etapas no Meetings, Chat, Docs e Tasks. Além de fontes e dados do Zoom, você pode se conectar a aplicativos de terceiros, o que permite recuperar dados e enviá-los para outras ferramentas de terceiros, como Google, Microsoft e Salesforce.
Quando você clica em Fluxos de trabalho na barra lateral, o recurso Fluxos de trabalho será aberto automaticamente, onde você pode descrever um fluxo de trabalho em linguagem natural. Você também pode acessar as seguintes opções relacionadas ao fluxo de trabalho, que são exibidas em Fluxo de trabalho na barra lateral.
Os fluxos de trabalho agênticos para o ZoomMate estão disponíveis para usuários pagos do ZoomMate e do AI Companion personalizado nos EUA. Os usuários gratuitos também podem acessar uma versão limitada deste recurso, com até 10 execuções por mês.
Tanto as execuções de teste durante a criação quanto as execuções após a publicação de fluxos de trabalho contam para o uso mensal. Os usuários pagos do ZoomMate e do AI Companion personalizado terão inicialmente execuções ilimitadas por tempo limitado.
Requisitos para usar fluxos de trabalho agênticos com o ZoomMate
Alguns recursos estão disponíveis em uma conta Zoom Workplace Pro, Zoom Workplace Pro Plus, Zoom Workplace Corporativo, Zoom Workplace Corporativo Plus, Zoom Workplace Empresarial, Zoom Workplace Empresarial Plus ou Pacote Empresarial
Navegadores compatíveis: Chrome, Edge, Safari ou Firefox (versões mais recentes)
O uso de nós de conectores de terceiros com tecnologia de IA, Enviar mensagem SMS, Enviar mensagem de voz e Rastreador da Web requer uma licença do ZoomMate e consome créditos do Zoom AI.
Como funciona a página inicial do fluxo de trabalho agêntico do ZoomMate
A página inicial do fluxo de trabalho agêntico do ZoomMate oferece um local de trabalho centralizado para descobrir, criar e gerenciar fluxos de trabalho automatizados. Na página inicial, você pode navegar por modelos de fluxo de trabalho pré-criados, organizar seus fluxos de trabalho existentes, monitorar a atividade do fluxo de trabalho e criar novas automações.
Aba Início
A aba Início serve como a página de destino principal para a descoberta de fluxos de trabalho. Ela exibe uma coleção de modelos de fluxo de trabalho prontos para uso que ajudam você a automatizar processos de negócios comuns sem criar fluxos de trabalho do zero.
Cada modelo inclui uma imagem de pré-visualização e um título para que você possa entender rapidamente sua finalidade antes de selecioná-lo. Os modelos também podem exibir os aplicativos ou as integrações que usam, permitindo que você identifique fluxos de trabalho que se conectam a serviços como Slack, Gmail, Salesforce ou Zoom.
Use a aba Início para:
Navegar pelos modelos de fluxo de trabalho recomendados.
Pesquisar modelos por nome.
Filtrar modelos por categoria de negócios.
Revisar os detalhes do modelo antes de criar um fluxo de trabalho.
Categorias de modelos
Abaixo da seção Pronto para uso, estão os filtros de categoria que ajudam a restringir a lista de modelos disponíveis.
As categorias disponíveis incluem:
Todos: exibe todos os modelos de fluxo de trabalho disponíveis.
Gerenciamento de reuniões: modelos para preparação de reuniões, resumos, ações de acompanhamento, agendamento e produtividade de reuniões.
Chat: modelos que automatizam mensagens, notificações e colaboração baseada em chat.
Vendas: modelos que integram informações de reuniões com sistemas de CRM e fluxos de trabalho de vendas.
Marketing: modelos criados para campanhas de marketing, conteúdo e interação com os clientes.
TI e Engenharia: modelos que automatizam processos técnicos, rastreamento de incidentes e tarefas de engenharia.
RH: modelos que dão suporte a recrutamento, integração, comunicação com funcionários e operações de RH.
Outros: modelos adicionais de fluxo de trabalho que não pertencem a uma categoria de negócios específica.
Selecionar uma categoria filtra imediatamente os modelos exibidos, facilitando encontrar fluxos de trabalho relevantes para seu caso de uso.
Pesquisar modelos
O campo Pesquisar modelos permite que você localize rapidamente modelos de fluxo de trabalho inserindo palavras-chave.
Por exemplo, você pode pesquisar por:
Resumo da reunião
Slack
Gmail
Salesforce
Lembretes
A lista de modelos é atualizada dinamicamente para exibir os resultados correspondentes.
Cartões de modelo
Cada modelo aparece como um cartão individual contendo:
Uma pré-visualização visual do fluxo de trabalho.
O nome do fluxo de trabalho.
Ícones de aplicativo ou integração compatíveis.
Selecionar um modelo abre seus detalhes, onde você pode revisar sua configuração antes de criar seu próprio fluxo de trabalho.
Os exemplos apresentados incluem:
Lembrete antes da reunião
Fluxo geral de preparação de reunião com notificação do Chat
Resumo de reunião para o Slack
Resumo de reunião para o Salesforce
Rastreador de ações pós-reunião
Resumo de reunião para o Gmail
Esses modelos oferecem pontos de partida que você pode personalizar para atender aos requisitos da sua organização.
Aba Meus fluxos de trabalho
A aba Meus fluxos de trabalho contém fluxos de trabalho que você já criou ou salvou.
O usuário também pode visualizar os fluxos de trabalho aplicados pela minha organização na aba Meus fluxos de trabalho:
Exiba todos os seus fluxos de trabalho.
Abra um fluxo de trabalho existente para editar.
Habilitar ou desabilitar fluxos de trabalho.
Revise as configurações do fluxo de trabalho.
Continue editando fluxos de trabalho criados a partir de modelos ou construídos do zero.
Esta aba funciona como sua biblioteca pessoal de fluxos de trabalho, permitindo que você gerencie todas as suas automações ativas e em rascunho em um único local.
Aba Registros de atividades
A aba Registros de atividades oferece visibilidade sobre o histórico de execução do fluxo de trabalho.
Use esta aba para monitorar a atividade do fluxo de trabalho, incluindo:
Registro de execução do fluxo de trabalho e status dos resultados.
Registros de processamento.
Registros de data e hora da execução.
Metadados de um fluxo de trabalho para solução de problemas.
Os registros de atividade ajudam administradores e proprietários de fluxo de trabalho a verificar se as automações estão sendo executadas conforme o esperado e a identificar problemas que possam exigir atenção.
Botão Criar
O botão + Criar permite que você crie um novo fluxo de trabalho.
Selecione Criar para começar a criar um fluxo de trabalho do zero ou escolha uma das seguintes opções
CUI (Fluxo de trabalho de IU conversacional): cria um fluxo de trabalho de IU conversacional.
Comece com um nó: crie do zero criando um novo fluxo de trabalho.
Importar fluxo de trabalho: importe um fluxo de trabalho existente para o local de trabalho.
Após criar um fluxo de trabalho, você pode configurar acionadores, ações, condições e aplicativos conectados para automatizar processos de negócios.
Descreva em detalhes a tarefa ou o processo que você deseja automatizar usando o fluxo de trabalho. Se exigir várias etapas, descreva cada etapa na sequência desejada para o fluxo de trabalho que você deseja criar.
Clique no ícone Enviar. O ZoomMate começará a projetar o fluxo de trabalho, além de fazer perguntas de esclarecimento para configurar nós no fluxo de trabalho. Assim que tiver todas as informações necessárias, o ZoomMate começará a criar o fluxo de trabalho.
(Opcional) Depois que o fluxo de trabalho for concluído, use a caixa de texto do painel lateral do ZoomMate para descrever os ajustes que você deseja fazer no fluxo de trabalho ou atualize manualmente o fluxo de trabalho.
Quando estiver satisfeito com o design inicial do fluxo de trabalho, na parte inferior da janela, clique em Executar para testar o fluxo de trabalho.
Continue fazendo alterações adicionais no fluxo de trabalho.
Clique em Implantar para salvar as alterações no fluxo e defini-lo como Ativo.
Em Fluxo de trabalho, clique em + Criar. O criador de fluxo de trabalho e o painel lateral do ZoomMate serão abertos.
Abaixo da caixa de bate-papo de descrição, clique em Iniciar com um nó e, em seguida, clique em Acionadores.
Na lista de acionadores do nó, selecione um acionador:
Iniciar manualmente: inicia o fluxo de trabalho quando você pressiona um botão.
Preencher um formulário: inicia o fluxo de trabalho quando os usuários enviam um formulário com campos obrigatórios.
Evento de reunião: inicia o fluxo de trabalho quando ocorrem eventos específicos de reunião do Zoom, como quando uma reunião começa ou termina.
Evento de chat em equipe: inicia o fluxo de trabalho quando ocorre um evento do Zoom Chat, como quando uma mensagem é recebida ou um emoji específico é usado.
Do webhook: inicia o fluxo de trabalho automaticamente com base em eventos externos ou atualizações do sistema, como o envio de um novo formulário, uma alteração de status do CRM ou um alerta de outro aplicativo, para que os processos permaneçam conectados e responsivos em todas as suas ferramentas.
Quando alguém clica no link: inicia o fluxo de trabalho quando alguém clica em um link.
Agendamento personalizado: inicia o fluxo de trabalho em uma data e hora agendadas.
Evento do Phone: inicia o fluxo de trabalho quando ocorre um evento do Zoom Phone, como uma chamada perdida, SMS recebido ou novo correio de voz.
Feed RSS: inicia o fluxo de trabalho quando um item do feed RSS é publicado. Observação: quando você passa o mouse sobre uma opção de acionador, um coach ou uma dica de ajuda aparece para explicar quando usar esse acionador.
Clique em um acionador para adicioná-lo ao canvas e expandir seu painel de configuração.
Configure os detalhes do acionador. Por exemplo, para um acionador de evento de reunião, configure:
Tipo de evento de reunião: quando a reunião terminar.
Quais reuniões monitorar: todas as minhas reuniões.
Deslocamentos de tempo: 0 min para acionar exatamente quando o evento acontecer ou um deslocamento negativo ou positivo para acionar antes ou depois do evento.
Acrescente nós e ações adicionais conforme necessário, como enviar um resumo para o Slack, salvar um documento no Zoom Canvas ou postar uma mensagem em um canal de chat. Observação: se um nó gerar uma variável, essa variável poderá ser arrastada ou solta dentro de outro nó de ação.
(Opcional) Em qualquer etapa, use a caixa de texto do painel lateral do ZoomMate para descrever os ajustes que você deseja fazer no fluxo de trabalho e permita que o ZoomMate atualize acionadores, ações ou parâmetros para você.
Quando estiver satisfeito com o design inicial do fluxo de trabalho, na parte inferior da janela, clique em Executar para testar o fluxo de trabalho.
Continue fazendo alterações adicionais no fluxo de trabalho.
Clique em Implantar para salvar as alterações no fluxo e defini-lo como Ativo.
Abaixo da caixa de bate-papo da descrição, clique em Escolher um modelo.
Navegue pelos modelos e selecione um modelo que corresponda à sua função ou caso de uso. Exemplos incluem:
Modelos de gerenciamento de reuniões, como:
Lembrete pré-reunião: antes do início da reunião, lembre-se do essencial, como o tópico, o horário de início e os principais participantes.
Fluxo geral de preparação para reuniões: prepara automaticamente para as próximas reuniões pesquisando documentos e chats relacionados.
Resumo de reunião para o Slack: gere um resumo de reunião abrangente com tecnologia de IA e envie-o para um canal do Slack.
Resumo da reunião para o Salesforce: captura automaticamente os resultados da reunião, gera resumos estruturados com as principais decisões, itens de ação SMART e tarefas de acompanhamento, e os salva como notas do Salesforce.
Modelos baseados em chat, como:
Resumo diário do Chat: receba um resumo diário da atividade do canal do Zoom Chat.
Boas-vindas e resumo do canal: quando um novo membro entrar em um canal, envie uma mensagem de boas-vindas e forneça um resumo das mensagens do canal nos últimos 3 dias.
Smart Message Categorizer & Responder: categoriza mensagens de canais e oferece assistência contextual de fluxo de trabalho ao pesquisar o histórico recente de conversas para fornecer respostas precisas e relevantes.
Acompanhar @menções no documento: captura detalhes das menções, incluindo registro de data e hora, usuário, resumo e link da mensagem, e os armazena em um Zoom Doc selecionado para facilitar o acompanhamento e a referência.
Modelos voltados para casos de uso de vendas, como:
Atualização automática de oportunidade do Salesforce: após uma reunião, atualize automaticamente uma oportunidade do Salesforce a partir do conteúdo da transcrição da reunião.
E-mail de acompanhamento automático: gera e envia automaticamente um e-mail de acompanhamento profissional após as reuniões usando os principais pontos de discussão, decisões e itens de ação extraídos por IA.
Preparação para reuniões de vendas com Salesforce e Zoom Canvas: prepare-se para reuniões de vendas pesquisando notas de clientes e oportunidades no Salesforce e documentos/chats/reuniões relacionados do Zoom.
Modelos voltados para casos de uso de marketing, como:
Gerador de resumo de conteúdo: cria um resumo de conteúdo de marketing a partir de gravações de reuniões, capturando detalhes da campanha, insights do público e resultados, e envia o resumo para o usuário atual por e-mail.
Resumo da campanha para partes interessadas: gera um resumo estruturado da campanha de marketing a partir de discussões relevantes de reuniões, destacando o status da campanha, os principais marcos, riscos e próximas etapas, e depois envia o resumo por e-mail para o usuário atual.
Voice of Customer Insights: analisa transcrições de reuniões para identificar pontos de dor, objeções e oportunidades de mensagens do cliente, depois gera e envia por e-mail insights práticos de Voice of Customer (VoC) para o usuário atual.
Modelos voltados para casos de uso de TI e Engenharia, como:
Resumo diário de tarefas do Jira para o Zoom Chat: busca automaticamente todas as tarefas atribuídas e não concluídas de um usuário no JIRA todas as manhãs e envia um resumo formatado pelo Zoom Chat para manter os usuários informados sobre seus itens de trabalho pendentes.
Criação automática de tickets do Jira: cria automaticamente tickets de bug do Jira quando os usuários reagem com um emoji de ticket no Chat. A IA extrai detalhes do problema do histórico da conversa, aloca o ticket aos usuários mencionados e publica uma mensagem de confirmação com os detalhes do ticket de volta no chat.
Modelos voltados para casos de uso de RH, como:
Consolidação de feedback de entrevista: compila o feedback pós-entrevista resumindo os pontos fortes do candidato, preocupações, evidências de apoio e próximas etapas recomendadas e, em seguida, atualiza os registros de recrutamento correspondentes.
Relatório de avaliação e registro de decisões sobre contratação: após uma reunião de análise de recrutamento, captura automaticamente decisões de contratação, incluindo se candidatos devem avançar para a próxima etapa, estender propostas, tratar de itens de acompanhamento de entrevistas, alocar proprietários responsáveis e acompanhar prazos associados.
Pacote inicial de integração de novos contratados: após uma reunião inicial de integração ou de sincronização, gera automaticamente um plano de integração de novos funcionários que descreve as tarefas da primeira semana, os contatos principais, os recursos de treinamento e os marcos de 30, 60 e 90 dias.
Modelos para outros casos de uso, como:
OpenAI News Auto-Publisher: monitora o feed RSS da OpenAI de hora em hora, resume artigos recém-publicados com os principais insights e publica atualizações formatadas com links clicáveis em um canal designado do Zoom.
Alertas de status de serviço do Zoom: monitora o feed RSS de status de serviço do Zoom e envia atualizações formatadas para um canal do Zoom, fornecendo notificações oportunas sobre incidentes de serviço, manutenções agendadas e alterações no status operacional.
Monitoramento de pedidos de comida: monitora discussões relacionadas a comida quando o grupo de pedidos é mencionado, atualiza o documento de requisitos com detalhes relevantes e gera mensagens de resposta aprimoradas para publicação no canal.
Clique em um modelo para abri-lo no construtor de fluxo de trabalho.
Revise os acionadores e ações pré-configurados e, em seguida, ajuste todos os campos (como canais, destinatários, aprovações de ação ou locais de armazenamento) conforme necessário.
(Opcional) Use a caixa de texto do ZoomMate no painel lateral para refinar o modelo, adicionar etapas ou alterar condições usando instruções em linguagem natural.
Como exportar ou importar um modelo de fluxo de trabalho
Clique em Importar fluxo de trabalho e depois clique no botão Escolher arquivo .
Selecione o arquivo .json e clique em Abrir.
Como usar o recurso de aprovação de ação dentro dos fluxos de trabalho
Em fluxos de trabalho, nós de ação que realizam operações de gravação confidenciais (por exemplo, atualizar uma Oportunidade do Salesforce ou criar um tíquete do Jira) permitem que os usuários revisem, editem e aprovem alterações antes que elas sejam executadas. Quando acionada, uma ação pendente aparece na aba ZoomMate ou Fluxos de trabalho para revisão do usuário.
Os usuários podem configurar os conjuntos de ferramentas do nó de raciocínio de IA para sempre solicitar aprovação (o padrão) ou sempre permitir as ações dos conjuntos de ferramentas sem confirmação. Para nós de ação (por exemplo, o nó Sairdo canal), os usuários podem selecionar se o nó permite a ação sem aprovação ou sempre solicita confirmação antes de prosseguir.
No menu de navegação, clique na aba Fluxos de trabalho.
Selecione Ações pendentes e clique em Configurações .
Clique em Preferências de notificação e habilite uma ou ambas as opções.
Notificações por e-mail: receba uma notificação por e-mail quando uma revisão for atribuída a você.
Insígnias de notificação no cliente: exibe insígnias de notificação e alertas para fluxos de trabalho no Zoom Workspace.
(Opcional) Ignorar tudo: ignore todas as notificações de ação pendentes.
Configurar fluxos de aprovação para nós de ação
Crie ou abra um fluxo de trabalho.
Adicione ou edite um nó de ação que utiliza o campo Aprovação de ação.
Em Aprovação de ação, selecione uma opção:
Sempre perguntar: o fluxo de trabalho não pode concluir a ação até que o usuário aprove a ação na aba ZoomMate ou Fluxos de trabalho.
Sempre permitir:o fluxo de trabalho será concluído automaticamente sem exigir aprovação adicional do usuário. Observação: este é o padrão para nós de ação que podem exigir aprovação. No entanto, se o administrador tiver habilitado a opção Permitir que usuários desabilitem a confirmação para ações confidenciais, você não poderá selecionar essa opção.
Salve o fluxo de trabalho.
Configurar fluxos de aprovação para o nó AI Reasoning
Crie ou abra um fluxo de trabalho.
Adicione ou edite o nó de Raciocínio de IA.
Em Conjuntos de ferramentas, ao lado do conjunto de ferramentas desejado (Zoom Tasks, Zoom Chat etc.), clique no ícone Configurações [ícone de engrenagem].
Ao lado da ação desejada, selecione uma opção:
Sempre perguntar: os usuários precisarão aprovar a ação no ZoomMate antes que o fluxo de trabalho possa continuar. Observação: este é o padrão para todas as ações associadas a um conjunto de ferramentas.
Sempre permitir: a ação será executada sem aprovação adicional. Observação: se o administrador tiver habilitado Permitir que usuários desabilitem a confirmação para ações confidenciais, você não poderá selecionar esta opção.
Se uma ação estiver configurada para Sempre solicitar confirmação ou Sempre perguntar, o nó de ação exigirá aprovação antes de continuar o fluxo de trabalho. Para aprovar a ação:
Inicie Fluxos de trabalho. Em Ações pendentes, serão listados os fluxos de trabalho que exigem aprovação antes de continuar.
Clique no fluxo de trabalho e revise o resultado.
(Opcional) Se você quiser evitar a aprovação manual desta ação em fluxos de trabalho futuros, defina a configuração de aprovação da ação como Sempre permitir. Caso contrário, selecione Permitir uma vez para aprová-la apenas para o fluxo de trabalho atual. Observação: se o administrador tiver habilitado a opção Permitir que usuários desabilitem a confirmação para ações confidenciais, você não poderá modificar isso.
(Opcional) Clique em Cancelarfluxo de trabalho para cancelar a ação e encerrar o fluxo de trabalho.
Clique em Aprovar e continuar para continuar o fluxo de trabalho com o resultado aprovado.
Em Fluxos de trabalho, clique em Meus fluxos de trabalho.
Na coluna Status, clique no botão de alternância do fluxo de trabalho desejado para Ativo (habilitado) ou Inativo (desabilitado). Observação: fluxos de trabalho com acionadores manuais não podem ser desabilitados.
Em Fluxo de trabalho, clique em Todos os fluxos de trabalho.
Use os filtros disponíveis para encontrar o fluxo de trabalho que deseja revisar ou atualizar:
Pesquise por nome do fluxo de trabalho
Filtre por intervalo de datas.
Filtre por tipo de acionador de fluxo
Clique em um nome de fluxo de trabalho para abri-lo.
No canto superior direito, clique no ícone Mais e clique em Compartilhar. Observação: um fluxo de trabalho deve ser implantado antes que possa ser compartilhado.
Insira o contato ou canal desejado com o qual você deseja compartilhar o fluxo de trabalho.
Clique em Enviar. O fluxo de trabalho será compartilhado com os usuários desejados, permitindo que eles exibam o fluxo de trabalho. Observação: os usuários não poderão editar o fluxo de trabalho e deverão salvar uma cópia do fluxo de trabalho para usá-lo e/ou modificá-lo.
Como exibir registros de atividades do fluxo de trabalho
Abaixo de Fluxo de trabalho, clique em Registros de atividades. Uma lista de registros de execução de fluxo de trabalho será exibida.
Use os filtros disponíveis para restringir a atividade:
Pesquise por nome do fluxo de trabalho.
Filtre por status, como concluído, com falha, em execução, pausado, tempo limite esgotado ou encerrado.
Filtre por intervalo de datas.
Revise as colunas para cada execução do fluxo de trabalho, como Nome, Última execução, Status e Ações.
(Opcional) Clique em uma execução específica ou nas ações associadas a ela para exibir detalhes, solucionar falhas ou executar novamente o fluxo de trabalho, se houver suporte.
Como conectar suas próprias ferramentas MCP para uso no nó de raciocínio de IA
Práticas recomendadas para a criação de fluxos de trabalho
Comece sem nenhuma integração, aproveitando os dados dentro do ecossistema Zoom.
Depois de concluir seu primeiro fluxo de trabalho com sucesso, passe para uma integração e expanda gradualmente.
Use Nós de IA para interpretar dados não estruturados antes de passá-los para sistemas de terceiros.
Sempre inclua um nó de notificação ou documentação para visibilidade.
Ao usar o nó de solicitação HTTP, sempre comece o URL com http:// ou https:// e restrinja os nomes de cabeçalho a letras, dígitos e aos caracteres - _ ..
Ative novas tentativas para pontos de extremidade não confiáveis e pareie-as com um valor padrão em caso de falha para que uma única chamada com falha não interrompa todo o fluxo de trabalho.
Armazene segredos como credenciais em vez de cabeçalhos simples, eles são criptografados e mascarados.
Use Validar para identificar erros de configuração e Testar para confirmar a conectividade antes de publicar um fluxo de trabalho que contém um nó de solicitação HTTP.
Para solicitações GET e HEAD, coloque os dados em parâmetros de consulta em vez de no corpo, já que o corpo é ignorado para esses métodos.
Como solucionar problemas de fluxos de trabalho
Problemas de autenticação e conexão com fluxos de trabalho
Problemas de autorização com integrações de terceiros
Se você estiver enfrentando problemas de autorização com integrações de terceiros:
Se os fluxos de trabalho continuarem solicitando autorização, mas nunca forem concluídos, tente desconectar e reconectar a integração nas configurações do fluxo de trabalho.
Problemas de visibilidade do conector do Salesforce podem ocorrer devido a alterações na configuração da fonte de dados.
Problemas de acionamento e execução
Evento do Team Chat não está acionando o fluxo de trabalho
Se você estiver enfrentando problemas com fluxos de trabalho que usam o acionador Evento de chat em equipe sem acionar corretamente, verifique se o fluxo de trabalho foi compartilhado com você usando nós de chat. Se o proprietário do fluxo de trabalho ainda tem as permissões de canal adequadas, pois os fluxos de trabalho podem ser desativados se o proprietário perder o acesso ou sair de um canal.
Fluxo de trabalho não aciona a partir do webhook
Se você estiver enfrentando problemas com fluxos de trabalho que usam o acionador Do webhook sem acionamento correto, confirme o seguinte:
Confirme se o sistema externo está enviando uma solicitação POST (não GET).
Confirme se o formato da carga útil corresponde às expectativas do fluxo de trabalho.
Confirme se o fluxo de trabalho está publicado e ativo.
Além do exposto acima, você também pode exibir os registros do fluxo de trabalho para verificar a solicitação que está sendo enviada via webhook.
Problemas nos nós de formulário e condição
Problemas com variáveis de formulário
Se você estiver enfrentando problemas com variáveis de formulário:
Variáveis de formulários em ramificações de casos switch talvez não estejam acessíveis fora dessa ramificação.
Para campos de seleção de usuário que mostram nomes duplicados, os endereços de e-mail não são exibidos no momento (defeito de design conhecido).
Problemas no nó de condição
Se você estiver enfrentando problemas com nós de condição:
Se os nós de condição retornarem "evaluationResult: null" e forem encerrados, tente ajustar o prompt para a avaliação do LLM.
Determinadas configurações de topologia podem não ser compatíveis; desconecte e reconecte as linhas se necessário.
Certifique-se de que o branch padrão esteja configurado corretamente.
Problemas relacionados a dados e variáveis
Erros relacionados a caracteres inválidos em nomes de campos
Se você encontrar problemas relacionados a nomes de campos, remova caracteres especiais, como pontos (.), dos nomes de campos (por exemplo, altere "jira.link" para "jiralink").
Problemas de dados ausentes ou incorretos
Se você encontrar problemas com dados ausentes ou incorretos:
Para dados de reunião que não estão carregando corretamente (o conteúdo parece incompleto), verifique se o tamanho do documento não está excedendo o limite de 20.000.000 de caracteres.
Verifique se as variáveis são passadas corretamente entre os nós e use o seletor de variáveis para garantir referências corretas.
Se os dados parecerem truncados ou ausentes, confirme se o fluxo de trabalho tem as permissões adequadas para acessar o conteúdo de origem.
Para valores vazios ou nulos, verifique se o acionador disparou corretamente e capturou os dados esperados: verifique os Registros de atividades.
Se os dados extraídos não corresponderem às expectativas, revise a configuração do nó Extrair dados e certifique-se de que o prompt especifique claramente quais informações capturar.
Para dados inconsistentes entre execuções do fluxo de trabalho, verifique se o formato do conteúdo de origem foi alterado ou se a lógica condicional precisa de ajustes.
Outros problemas específicos do nó
Envie mensagem de chat com base em falhas no nó
Se você estiver tendo problemas com fluxos de trabalho que utilizam os nós Responder a uma mensagem, Enviar uma mensagem para um canal, Enviar uma mensagem direta ou Enviar uma mensagem para a reunião, verifique o seguinte:
Se as tags de menção aparecerem como texto sem formatação em vez das menções formatadas habituais, o nó falhará.
Erros "Bad Request" (400) podem indicar problemas de permissão do canal ou formatação incorreta da mensagem.
Falha no nó de IA
Se o nó LLM estiver falhando/atingindo o tempo limite, verifique se os documentos referenciados não são muito grandes (o limite máximo de caracteres é 20.000.000).
Falha ao obter um nó de documento
Se o nó Obter um documento estiver falhando, verifique o seguinte:
Se você estiver recebendo "UNKNOWN_ERROR" ou enfrentando problemas de recuperação de dados, verifique se o tamanho do documento não está excedendo os limites.
Verifique se você tem as permissões de acesso adequadas ao documento.
Falha nos nós do Google Sheets
Se você estiver recebendo erros ao usar nós do Google Sheets, verifique o seguinte:
Para erros "Não foi possível analisar o intervalo" (por exemplo, "Sheet1!C18:C31"), verifique se o formato do intervalo da planilha está correto
Verifique se a planilha está devidamente autorizada e acessível.
Falha nos nós do Jira
Se você estiver recebendo erros ao usar nós do Jira, verifique o seguinte:
Para erros "Nenhuma operação com o nome 'set' encontrada", verifique a configuração de mapeamento de campos.
Alguns campos do Jira podem não ser compatíveis com entradas variáveis. Se um campo do Jira usar entradas variáveis, remova a entrada e teste se o fluxo de trabalho ainda falha.
Falha no nó de solicitação HTTP
Se você estiver recebendo erros ao usar o nó de solicitação HTTP, verifique o seguinte:
Se a validação bloquear você, confirme se o URL começa com http:// ou https:// e inclui um host, se o método é válido, se os nomes de cabeçalho usam apenas letras, dígitos e - _ . e se o tempo limite não é negativo.
Se o nó retornar um erro em vez de um corpo, a resposta poderá exceder o limite de 1 MB; respostas maiores que 1 MB são rejeitadas.
Para respostas 5xx repetidas, ative as novas tentativas (o número de tentativas e o intervalo são limitados a 5 cada) e defina um valor padrão em caso de falha para que o fluxo de trabalho possa continuar.
Se um URL público estiver inacessível, confirme se o proxy de saída no seu ambiente permite acesso externo à internet.
Se um placeholder como $userId não estiver sendo substituído, verifique se a variável existe e é produzida por um nó upstream.
Se o Teste relatar que o host está inacessível ou se você vir "test request limited," observe que o Teste tem taxa limitada a 50 chamadas a cada 5 minutos por usuário.