O que é um trigger
Trigger é o componente que inicia uma automação quando ocorre a condição configurada. Essa condição pode ser um horário, uma chamada recebida de outro serviço ou uma ação manual, e o início cria uma execução do workflow com a entrada disponível naquele momento.
No n8n, um formulário pode enviar uma chamada para o Webhook Node, enquanto um relatório diário pode começar com o Schedule Trigger. Ambos iniciam workflows, mas você configura e verifica cada entrada de uma forma diferente.
De onde vem o início da automação
O trigger manual permite executar o fluxo sob comando, o que é útil durante a construção e os testes. O agendado acompanha um horário ou intervalo, como a emissão de um resumo às oito da manhã, e depende do fuso configurado para interpretar esse horário.
Um trigger de aplicativo pode receber notificações do serviço ou consultar periodicamente se apareceu alguma mudança. Essa consulta é chamada de polling, e o intervalo entre consultas influencia quanto tempo você espera até a automação reconhecer uma novidade.
Já o webhook recebe uma chamada enviada pela origem. Nesse caso, além de configurar o Node, você precisa cadastrar o endereço correto no serviço que fará o envio e conferir o tipo de evento que ele está autorizado a comunicar.
Receber a chamada não valida o cadastro
A autenticação da chamada responde se o remetente apresentou a credencial exigida. Ela não confirma que o email de uma inscrição está preenchido ou que o código da turma existe, pois essas verificações pertencem ao processo que você está automatizando.
O trigger pode oferecer filtros e controles de entrada, mas você precisa configurá-los e conhecer seus limites. Os campos que determinam a criação de um cadastro devem passar pela validação de entrada prevista no workflow.
Teste e produção precisam ser conferidos separadamente
O Webhook Node do n8n disponibiliza endereços distintos para teste e produção. Uma chamada que funcionou enquanto você aguardava um evento no editor não comprova que o serviço externo esteja usando a URL de produção ou que a versão correta do workflow esteja publicada.
No agendamento, a conferência inclui o fuso horário e a publicação do workflow, conforme a versão do n8n usada no ambiente. Acionar o restante do fluxo manualmente testa o processamento, mas não demonstra que o trigger iniciará a execução no próximo horário previsto.
Como investigar uma execução que não começou
Compare o horário e o identificador do evento na origem com os registros disponíveis no n8n. Verifique o endereço chamado, a resposta recebida pelo remetente e os filtros do trigger antes de concluir que o processamento falhou depois da entrada.
Se a origem repetir a entrega, uma nova execução pode começar para a mesma ocorrência. A deduplicação e a idempotência ajudam a tratar essa repetição quando enviar duas mensagens ou criar dois cadastros seria um resultado incorreto.
Dúvidas frequentes
Perguntas frequentes sobre Trigger
- Trigger e webhook são sinônimos?
- Não. Um webhook pode ser usado como trigger, mas também existem triggers manuais, agendados e baseados em consultas periódicas a um serviço.
- O trigger valida todos os campos recebidos?
- Não automaticamente. Autenticação, leitura do corpo e filtros disponíveis não substituem a conferência dos campos exigidos pelo processo. Essa conferência precisa ser configurada.
- Um teste manual comprova que o agendamento funciona?
- Não. O teste pode verificar as etapas seguintes, mas o agendamento depende de sua configuração, do fuso horário e da disponibilidade do workflow para executar automaticamente.
- Receber o mesmo evento duas vezes pode iniciar duas execuções?
- Sim, conforme o trigger e o serviço de origem. A automação precisa tratar repetições quando elas puderem duplicar cadastros, mensagens ou outros efeitos.
Para continuar
Recursos relacionados
Documentação
n8n: Webhook Node
URLs de teste e produção, autenticação e resposta às chamadas.
Abrir recursoDocumentação
n8n: Schedule Trigger
Configuração de horários e fuso para execuções agendadas.
Abrir recursoAplicação na formação
n8n Experts
Triggers definem pontos de entrada do workflow e precisam de configuração compatível com a origem das ocorrências.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.