Configurar Gatilhos
Gatilhos definem quando e como usuarios entram em uma jornada. A configuracao correta do gatilho e essencial para que a jornada funcione como esperado.
Tipos de Gatilhos
Gatilho por Evento (Action Trigger)
O tipo mais comum. A jornada inicia quando o usuario realiza um evento especifico.
Configuracao:
- Selecione o no Action Trigger no inicio
- Escolha o evento na lista
- Configure filtros opcionais
- Defina regras de entrada
Eventos disponiveis:
- Eventos customizados criados no modulo de Eventos
- Eventos do sistema (cadastro, login, etc.)
- Eventos de engajamento (email aberto, clicado)
Exemplo:
Evento: "Carrinho Abandonado"
Filtros:
- valor_total > 50
- itens_quantidade >= 2
Gatilho por Segmento (Segment Entry)
A jornada inicia quando o usuario entra em um segmento.
Configuracao:
- Selecione o no Segment Entry
- Escolha o segmento/audiencia
- Configure frequencia de verificacao
Modos de verificacao:
| Modo | Descricao | Uso |
|---|---|---|
| Tempo real | Verifica a cada evento | Segmentos simples |
| Batch diario | Verifica uma vez por dia | Segmentos complexos |
| Batch horario | Verifica a cada hora | Equilibrio |
Exemplo:
Segmento: "Usuarios Inativos 30+ dias"
Verificacao: Batch diario as 08:00
Filtros de Evento
Refine quais ocorrencias do evento disparam a jornada.
Filtros por Propriedade
Filtre baseado nas propriedades do evento:
Evento: "Compra Realizada"
Filtros:
- categoria = "eletronicos"
- valor >= 500
- metodo_pagamento != "boleto"
Operadores Disponiveis
| Operador | Descricao | Tipos |
|---|---|---|
= | Igual | Todos |
!= | Diferente | Todos |
> | Maior que | Numeros |
>= | Maior ou igual | Numeros |
< | Menor que | Numeros |
<= | Menor ou igual | Numeros |
contem | Contem texto | Strings |
comeca_com | Inicia com | Strings |
termina_com | Termina com | Strings |
esta_em | Esta na lista | Todos |
nao_esta_em | Nao esta na lista | Todos |
existe | Propriedade existe | Todos |
nao_existe | Propriedade nao existe | Todos |
Combinando Filtros
Use AND e OR para logica complexa:
(categoria = "eletronicos" OR categoria = "informatica")
AND
valor >= 200
AND
cliente_novo = true
Regras de Entrada
Frequencia de Entrada
Controle quantas vezes um usuario pode entrar na jornada.
Opcoes:
Uma vez (lifetime):
Usuario entra apenas uma vez na vida
Ideal para: Onboarding, primeiro cadastro
Uma vez por periodo:
Usuario entra no maximo X vezes em Y dias
Ideal para: Promocoes, reengajamento
Sempre:
Usuario entra toda vez que dispara o evento
Ideal para: Transacionais, confirmacoes
Cooldown (Intervalo Minimo)
Tempo minimo entre entradas do mesmo usuario:
Cooldown: 24 horas
Usuario dispara evento as 10:00 → Entra
Usuario dispara evento as 15:00 → Ignorado
Usuario dispara evento as 11:00 (dia seguinte) → Entra
Entrada Multipla
Se o usuario ja esta na jornada e dispara o evento novamente:
| Opcao | Comportamento |
|---|---|
| Ignorar | Nao faz nada, usuario continua onde esta |
| Reiniciar | Remove da posicao atual e comeca do zero |
| Paralelo | Cria nova instancia em paralelo |
Entradas paralelas podem causar multiplos envios. Use com cautela e sempre com limites.
Condicoes de Qualificacao
Alem do evento, voce pode exigir condicoes adicionais.
Verificar Segmento
Evento: "Visita Pagina Produto"
Condicao: Usuario deve estar no segmento "Lead Qualificado"
Verificar Propriedade do Usuario
Evento: "Login"
Condicao: usuario.plano = "premium"
Verificar Historico
Evento: "Carrinho Abandonado"
Condicao: Nao recebeu email de carrinho nos ultimos 3 dias
Janela de Tempo
Limite quando o gatilho esta ativo.
Dias da Semana
Gatilho ativo: Segunda a Sexta
Eventos no fim de semana sao ignorados ou enfileirados
Horario
Gatilho ativo: 08:00 - 20:00
Eventos fora do horario aguardam na fila
Periodo Especifico
Gatilho ativo: 01/12/2024 a 31/12/2024
Campanha sazonal de Natal
Priorizacao de Jornadas
Quando um usuario pode entrar em multiplas jornadas:
Prioridade
Defina ordem de prioridade:
Jornada "Carrinho VIP": Prioridade 1
Jornada "Carrinho Normal": Prioridade 2
Usuario VIP abandona carrinho → Entra apenas em "Carrinho VIP"
Exclusao Mutua
Jornadas que nao podem ser executadas juntas:
Jornada "Promocao A" exclui "Promocao B"
Usuario qualificado para ambas → Entra apenas na primeira
Testando Gatilhos
Modo de Teste
- Ative o modo de teste na jornada
- Dispare o evento manualmente ou via API
- Verifique se o usuario entrou
- Acompanhe o fluxo no debug
Simulacao
1. Clique em "Simular Entrada"
2. Selecione um usuario de teste
3. Simule o evento com propriedades
4. Veja se passaria nos filtros
Logs de Entrada
Acesse os logs para ver:
- Quantos usuarios entraram
- Quantos foram filtrados
- Motivos de rejeicao
Exemplos Praticos
Onboarding
Gatilho: Evento "Cadastro Concluido"
Frequencia: Uma vez (lifetime)
Condicao: Nenhuma
Carrinho Abandonado
Gatilho: Evento "Carrinho Abandonado"
Frequencia: Uma vez por 7 dias
Cooldown: 24 horas
Filtro: valor_total >= 50
Condicao: Nao esta em jornada de promocao ativa
Reengajamento
Gatilho: Segmento "Inativos 30 dias"
Verificacao: Diaria as 10:00
Frequencia: Uma vez por 90 dias
Upsell
Gatilho: Evento "Compra Realizada"
Frequencia: Uma vez por 30 dias
Filtro: categoria = "basico"
Condicao: Usuario nao e premium
Boas Praticas
E mais facil afrouxar regras do que lidar com usuarios que entraram incorretamente.
Descreva claramente nas anotacoes da jornada a logica do gatilho para referencia futura.
Se muitos usuarios estao sendo filtrados, revise se os criterios estao corretos.
Sempre teste o gatilho com usuarios de teste antes de ativar para toda a base.