Tipos de gatilho (Triggers)

O nó Trigger define quando o fluxo será iniciado. Tipos disponíveis:

Palavra-chave (keyword)

O fluxo inicia quando o cliente envia uma mensagem contendo a palavra-chave configurada.

  • Exemplo: Palavra-chave "cardápio" → cliente envia "Quero ver o cardápio" → fluxo inicia

Primeira mensagem (first_message)

O fluxo inicia automaticamente quando um novo contato envia a primeira mensagem. Ideal para boas-vindas.

Qualquer mensagem (any_message)

O fluxo inicia em qualquer mensagem recebida (quando não há outro fluxo ativo). Use com cuidado.

Webhook (webhook)

O fluxo é disparado via chamada HTTP externa. Útil para integrações com sistemas externos.

Campanha UTM (utm_campaign)

O fluxo inicia quando a conversa tem dados UTM correspondentes. Configure filtros por:

  • Campanha (utm_campaign)
  • Fonte (utm_source)
  • Meio (utm_medium)

Campos vazios = curinga (aceita qualquer valor). Pelo menos um campo deve ser preenchido.

Agendado (schedule)

Disponível em fluxos do tipo Agendada (flow_type = 'scheduled'). O gatilho dispara em horário programado (intervalo regular ou expressão cron). Não é reativo a mensagens — é proativo. Configurado pelo ScheduleConfigDialog ao clicar no nó Trigger de uma automação agendada. Use junto com requestNode + loopNode para buscar dados externos e processar em lote. Veja "Automações agendadas" para detalhes.

Ativando o gatilho

Após criar e salvar o fluxo, vá na lista de automações e clique em "Ativar" para associar o gatilho a uma conta WhatsApp.