Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Gatilho no N8N

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Gatilho é o nó que inicia a execução de um fluxo no N8N quando um evento acontece, e é o ponto de partida obrigatório de toda automação: sem ele não existe nada para disparar os nós seguintes.

Escolher o gatilho não é uma decisão de conveniência. Ele define o formato da entrada que chega ao fluxo, se a execução é síncrona ou não, e se existe algum tipo de autenticação no caminho. Um fluxo que recebe uma mensagem de chat trabalha com um objeto simples de texto e identificador de sessão; um fluxo que recebe uma requisição HTTP precisa tratar e estruturar o corpo que vier; um fluxo agendado não tem entrada externa nenhuma e precisa buscar sozinho o que vai processar.

Os tipos disponíveis e para que servem

  • Manual. Aciona o fluxo por um botão. Serve para teste e depuração, não para uma automação que precisa rodar sozinha.
  • Chat. Abre uma aba de conversa dentro da própria ferramenta e entrega ao fluxo a mensagem do usuário junto com um identificador de sessão. É o caminho mais curto para testar um agente conversacional antes de existir uma interface de verdade.
  • Webhook. Expõe um endereço HTTP que qualquer sistema externo pode chamar. Aceita métodos como GET, POST e DELETE e qualquer corpo de requisição, e pode ser configurado para responder só quando o último nó terminar, devolvendo o que aquele nó produziu. Tem um endereço de teste, usado durante a construção, e um de produção, que só passa a valer quando o fluxo é ativado.
  • E-mail. Dispara a partir de mensagens recebidas em uma caixa, com filtro por remetente ou aceitando qualquer um. Verifica a caixa em intervalos curtos, o que o torna a base de uma Automação de Triagem de E-mails com Agentes.
  • Alteração de arquivo. Dispara quando um arquivo ou documento monitorado muda.
  • Evento de ferramenta. Dispara a partir de eventos de um serviço integrado; o catálogo de eventos depende inteiramente da ferramenta escolhida.
  • Agendamento. Dispara em dias, horários ou intervalos definidos — a cada minuto, uma vez por semana, uma vez por mês.

O gatilho como leitura do ambiente

Em automação tradicional, o gatilho é só o pavio: alguém ou algo acende e o fluxo corre. No contexto de agentes, ele ganha outra leitura — é a forma como o agente percebe o ambiente. Um horário que chega, uma mensagem que aparece num canal, um arquivo que foi alterado numa pasta: cada um desses é um sensor. Enxergar assim muda o desenho do fluxo, porque a pergunta deixa de ser como ligar a automação e passa a ser o que esse Agente de IA precisa observar para agir na hora certa.

O webhook exige mais preparo que os outros

Diferente do gatilho de chat, testar um webhook depende de uma ferramenta externa de requisições HTTP e de um endereço alcançável por quem vai chamar. Quando a instância roda na própria máquina, esse endereço não existe na internet, e é aí que entra Exposição de N8N Local com Túnel Cloudflare. Alguns provedores impõem restrições adicionais: uma autorização de conta de e-mail configurada num console externo pode exigir que a URL de retorno seja o próprio endereço local, e rejeita qualquer endereço que pareça público.