Gatilho no N8N
Ir para notas que citam estaGatilho é 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.
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.