Gatilhos disponíveis

Gatilhos (ou triggers) são os eventos que disparam automações. Cada automação escuta um único gatilho — quando o evento acontece, a automação avalia condições e (se passar) executa as ações configuradas.

Esse artigo lista todos os gatilhos suportados, com casos de uso e configurações específicas de cada um.

Eventos de mensagens

Mensagem recebida (message_received)

Quando dispara: cliente envia mensagem em qualquer canal (WhatsApp, Instagram, site).

Configurações específicas:

• Canal: filtra por whatsapp, instagram, web_chat, ou "todos".
• Instância de WhatsApp: filtra por número específico (se canal = WhatsApp).

Casos de uso:

• Detectar palavra-chave e responder com info específica.
• Enviar webhook pra sistema externo a cada mensagem.
• Aplicar tag automaticamente baseado em conteúdo da mensagem.

⚠️ Atenção: esse gatilho é muito frequente — em conta com 100+ mensagens/dia, dispara 100+ vezes. Use condições pra filtrar.

Nova conversa (conversation_created)

Quando dispara: primeira mensagem do cliente que abre uma conversa nova no CRM.

Configurações específicas:

• Canal: filtra por canal.

Casos de uso:

• Mensagem de boas-vindas pra cliente novo.
• Atribuição automática a vendedor.
• Criar lead vinculado se ainda não existir.

💡 Dica: dispara uma vez por conversa nova — não toda mensagem. Diferente do message_received.

Eventos de lead

Lead criado (lead_created)

Quando dispara: lead novo entra no CRM (manual, importação, formulário, auto-criação WhatsApp/Instagram, Lead Ads).

Configurações específicas:

• Origem (source): filtra por canal de origem.
• Pipeline: filtra por funil específico.

Casos de uso:

• Atribuir vendedor automaticamente baseado em origem.
• Mandar email/WhatsApp de boas-vindas.
• Adicionar tags iniciais (ex: "novo-mes", "campanha-X").
• Enviar webhook pra sistema externo (ex: Mailchimp pra email marketing).

Lead movido de etapa (lead_stage_changed)

Quando dispara: lead muda de etapa no funil (drag-drop no kanban, edição manual, automação anterior).

Configurações específicas:

• Etapa de destino: filtra pra disparar só quando lead chega numa etapa específica.
• Pipeline: filtra por funil.

Casos de uso:

• Lead chegou em "Proposta enviada" → criar tarefa de follow-up.
• Lead chegou em "Aguardando pagamento" → enviar webhook pro.
• Lead chegou em "Onboarding" → inscrever em sequência de boas-vindas.

Lead ganho (lead_won)

Quando dispara: lead vai pra etapa marcada como is_won=true (cria registro Sale).

Casos de uso:

• Mensagem de agradecimento pelo cliente.
• Inscrever em sequência de upsell / pós-venda.
• Enviar webhook pra ERP / sistema fiscal.
• Notificar equipe (gerente, comissionado) via WhatsApp.
• Adicionar tag cliente-ativo.

Lead perdido (lead_lost)

Quando dispara: lead vai pra etapa is_lost=true (cria registro LostSale).

Casos de uso:

• Inscrever em sequência de reativação (3 meses depois, manda "Voltou a considerar?").
• Adicionar tag revisitar-em-X-meses.
• Enviar webhook pra CRM externo (informar perda).
• Pedir feedback NPS sobre experiência.

Eventos de tarefa

Tarefa criada (task_created)

Quando dispara: tarefa nova é criada no CRM (manual, automação, etapa obrigatória, auto-stage).

Casos de uso:

• Notificar atendente atribuído via WhatsApp ("Você tem nova tarefa: X").
• Adicionar tag de prioridade conforme tipo da tarefa.

Tarefa próxima do vencimento (task_due_soon)

Quando dispara: tarefa pendente está N horas/dias antes de vencer (configuração interna).

Casos de uso:

• Lembrar atendente: "Sua tarefa 'Ligar pro João' vence em 2h".
• Auto-cancelar tarefas há muito sem ação.

Eventos por data

Data / Aniversário (date_field)

Quando dispara: cron diário às 08:00 verifica datas dos leads e dispara quando bate.

Configurações específicas:

• Campo de data: birthday (campo nativo) ou campo personalizado tipo data (cf:42).
• Dias de antecedência: 0 = no próprio dia, 7 = 1 semana antes, etc.
• Repetir anualmente: para aniversários (ex: birthday), marque true. Pra datas únicas, false.

Casos de uso:

• "Mandar mensagem de feliz aniversário no dia" — birthday, days=0, repeat_yearly=true.
• "7 dias antes do aniversário do contrato, enviar lembrete" — cf:contrato_renovacao, days=7.
• "30 dias após criação do lead, mandar mensagem" — campo data customizado.

💡 Dica: combina muito bem com template HSM pra Cloud API — clientes que não conversam há meses (janela 24h fechada) só recebem template aprovado.

Recorrente (recurring)

Quando dispara: em horário e frequência configurada (semanal ou mensal).

Configurações específicas:

• Tipo de recorrência: weekly ou monthly.
• Dia(s) da semana ou mês: [1, 3, 5] (segunda, quarta, sexta) ou dias do mês.
• Horário de envio: HH:MM (ex: 09:00).

Casos de uso:

• "Toda segunda às 9h, enviar webhook com leads novos da semana".
• "Todo dia 1 do mês às 8h, criar tarefa pra cada vendedor 'Revisar pipeline'".

Tabela completa de gatilhos

Como o gatilho dispara

Tecnicamente, cada gatilho é disparado por um evento específico no sistema:

• Lead criado: hook LeadObserver::created.
• Lead movido: hook em Lead::update quando stage_id muda.
• Lead ganho/perdido: hook quando entra em etapa is_won/is_lost.
• Mensagem recebida: webhook WhatsApp/Instagram/site.
• Conversa criada: criação de WhatsappConversation/InstagramConversation/WebsiteConversation.
• Tarefa criada: hook TaskObserver::created.
• Date field / Recurring: cron diário automations:process-date-triggers.

Tudo automático — você não precisa se preocupar com como dispara, só configurar o quê acontece.

Múltiplas automações com mesmo gatilho

Você pode ter várias automações ouvindo o mesmo gatilho (lead_created, por exemplo). Cada uma processa independente:

• Automação A: lead criado + source=whatsapp → atribui pro Pedro.
• Automação B: lead criado + tag=vip → manda email pro gerente.
• Automação C: lead criado → webhook pra Mailchimp.

Todas as 3 disparam quando lead novo entra. Sem conflito.

Encadear automações

Não há "quando uma automação termina, dispara outra" oficialmente — mas você pode usar:

• Tag como gancho: automação A adiciona tag vip-novo. Automação B tem gatilho lead_updated ou condição lead_tag contains vip-novo.
• Etapa como gancho: automação A move pra etapa "Qualificado". Automação B tem gatilho lead_stage_changed + filtro nessa etapa.

Funciona como sistema de eventos encadeados.

Limitações conhecidas

• Sem gatilho lead_updated genérico — só mudança de etapa.
• Sem gatilho de "campo customizado mudou" — depende do que mudou.
• Sem condição "OU" explícita entre múltiplas condições — só AND.
• Sem agendamento de "horário do dia" na maioria dos triggers — exceto date_field e recurring.

Pra cenários complexos, considere combinar automações ou usar webhook pra processamento externo.

Próximos passos

• Pra entender cada ação, veja Ações de mensagem/mover/tarefa.
• Pra refinar quando dispara, veja Condições e filtros.

Artigos relacionados

• Criar automação
• Condições e filtros
• Automações por data
• Ações de mensagem, mover, tarefa