Digite para filtrar os verbetes do Glossário.

    Automação e integrações · n8n Experts

    O que é Trigger?

    Trigger inicia uma automação por horário, evento ou ação manual. Entenda a relação com webhooks, polling e validação dos campos recebidos no n8n.

    Também chamado de: gatilho, disparador

    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

    Aplicaçã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
    Capa da formação n8n Experts

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano