Um gatilho é o bloco que decide quando uma automação começa. É a primeira peça de todo fluxo e, na prática, a decisão mais determinante: o resto — quais emails saem, com que esperas, com que ramificações — pode ser mudado a qualquer momento, mas um gatilho mal escolhido faz o fluxo simplesmente nunca rodar, sem dar erro em lugar nenhum. Este documento é a referência dos cinco gatilhos do arrobaMail e das condições de comportamento. A mecânica geral de um fluxo está em automações.
Os cinco gatilhos
Na paleta do editor de automação, a categoria Gatilhos tem cinco blocos:
| Gatilho | Dispara quando… | Precisa de | Guia passo a passo |
|---|---|---|---|
| Inscrição | um contato confirma o cadastro em uma lista | uma lista e um formulário de inscrição | boas-vindas por formulário |
| Cancelamento de inscrição | um contato sai de uma lista | uma lista | — |
| Abertura de e-mail | um contato abre uma campanha enviada | uma campanha já enviada | aberturas e cliques |
| Clique em e-mail | um contato clica em uma campanha (opcionalmente, em um link específico) | uma campanha já enviada | aberturas e cliques |
| Evento personalizado | seu sistema registra um evento pela API | o contato já na lista + uma chamada HTTP | disparar pela API |
Três deles são os que iniciam conversas: Inscrição, Evento personalizado e Abertura/Clique. O de cancelamento serve para o contrário — fechar bem: uma mensagem de despedida, uma pesquisa de saída, ou marcar o contato no seu sistema.
Inscrição
Dispara quando alguém confirma o cadastro na lista que você escolher.
Essa nuance da confirmação é a origem de quase todas as dúvidas sobre "não dispara". O arrobaMail protege as listas com double opt-in: a pessoa preenche o formulário, recebe um email de confirmação e só ao confirmar entra no fluxo. Entre o envio do formulário e o início existe, portanto, um passo que depende da pessoa.
Duas consequências práticas:
- Contatos adicionados à mão não disparam. Ficam ativos na lista, mas não houve inscrição real, então o gatilho não os enxerga.
- Cadastros feitos pelo seu sistema também não. Se o seu backend cadastra contatos pela API, esse opt-in "visível" nunca acontece. Para esse caso existe o evento personalizado.
Cancelamento de inscrição
Dispara quando um contato sai de uma lista. É o gatilho menos usado e o mais subestimado: um cancelamento é informação valiosa, e um fluxo curto — uma mensagem agradecendo o tempo compartilhado, ou oferecendo reduzir a frequência em vez de sair de vez — recupera mais gente do que se imagina.
Use-o também para tarefas internas: avisar o seu CRM, marcar o contato ou disparar uma pesquisa de saída de uma única pergunta.
Abertura de e-mail e Clique em e-mail
Disparam quando um contato abre ou clica em uma campanha. Ao configurá-los você escolhe qual campanha: o comportamento é medido sobre um envio concreto, não sobre "qualquer email".
O gatilho de clique permite ainda escolher qual link. Se deixar a seleção de links vazia, dispara com qualquer um; se escolher um, só esse. Isso habilita fluxos bem refinados: em uma campanha com "ver planos", "ler o caso" e "falar com vendas", cada clique revela uma intenção distinta e pode iniciar uma conversa distinta.
Os dois sinais não valem o mesmo:
- A abertura é um sinal fraco. Diz "o assunto me chamou a atenção". Além disso, os recursos de proteção de privacidade de alguns clientes de email podem pré-carregar imagens e registrar aberturas que não foram humanas.
- O clique é um sinal forte. A pessoa foi até o link: há intenção.
Regra prática: abertura para lógicas suaves (tom, ordem das mensagens), clique para decisões importantes (mandar uma oferta, avisar vendas).
Evento personalizado
É o mais flexível dos cinco, e o que transforma o arrobaMail em algo que qualquer sistema pode operar. Sua aplicação registra um evento com uma chamada HTTP e o fluxo começa. Na prática é um gatilho no estilo webhook de entrada.
Tem dois campos de configuração:
- Nome do evento — um identificador fixo, sem espaços, em minúsculas (
compra_confirmada,trial_expirado). Funciona como contrato: tem que coincidir exatamente com o que o seu sistema disparar. - Valor (opcional) — um filtro fino. Com ele, um mesmo evento pode disparar fluxos diferentes conforme o valor que trouxer.
O endpoint que o painel monta é:
GET /v3/api/events/record?eventName=NOME&email=[SUBSCRIBER_EMAIL]&listid=[LIST_ID]
Duas regras que evitam a maioria dos problemas:
- O evento dispara, não cria. O contato precisa já existir na lista. Primeiro o cadastro, depois o evento.
- Chame a partir do seu backend, nunca do navegador. Se o disparo sair do front, qualquer pessoa pode ler a URL — com o seu
listid— e iniciar fluxos para endereços arbitrários.
Você também pode anexar campos temporários com prefixo pf_ (pf_order_id, pf_total) que viajam com o evento e são usados dentro do email sem serem salvos no contato.
Condições de comportamento
Abertura e clique aparecem também entre as Condições, e ali fazem algo diferente: não iniciam um fluxo, e sim ramificam um que já está rodando. Depois de um email e uma espera, a condição pergunta "abriu?" ou "clicou?" e manda o contato por um caminho ou por outro.
A regra para escolher entre gatilho e condição é uma única pergunta: a pessoa já está dentro do fluxo? Se não estiver, gatilho. Se já estiver, condição.
E um aviso de desenho: coloque sempre uma espera antes da condição. Perguntar "clicou?" dez minutos depois do envio manda quase todo mundo pelo caminho do "não", simplesmente porque ainda não leram o email. Um dia é o mínimo razoável; dois ou três, o habitual.
Variáveis disponíveis nos emails do fluxo
Dentro dos emails de uma automação você pode inserir dados do contato e do evento. A sintaxe leva chave tripla e o sinal $:
{{{$sus_campo}}}— dados salvos do assinante ({{{$sus_name}}},{{{$sus_email}}}). O nome do campo faz match exato com o que está salvo na lista, maiúsculas incluídas.{{{$pf_campo}}}— campos temporários que chegaram com um evento personalizado ({{{$pf_order_id}}}). Não são salvos no contato: existem só para aquele envio.
Se o dado faltar, a variável resolve vazia. Defina um valor padrão para os campos que usar em saudações, ou você vai enviar um "Olá ,".
Erros frequentes e como reconhecê-los
Quase todos os "a automação não funciona" caem nesta lista, por ordem de frequência:
- O fluxo está em Rascunho. Ele salva, parece certo e não processa ninguém. É a causa número um.
- O gatilho aponta para outra lista que não a do formulário ou a do cadastro. Não há erro visível: simplesmente ninguém entra.
- O contato não confirmou (gatilho Inscrição) ou não existia na lista (evento personalizado).
- O nome do evento não coincide caractere por caractere com o que o seu sistema dispara.
- A condição é avaliada cedo demais, sem espera antes.
A forma mais rápida de diagnosticar é a contagem de inscritos do painel da automação: anote, provoque o disparo e olhe de novo. Se não se moveu, o sinal não chegou; se se moveu e o email não saiu, o problema está mais adiante no fluxo.
Continue lendo
- Automações — como se compõe um fluxo: ações, esperas, condições e lógica.
- Formulários de inscrição — de onde vêm os cadastros que disparam «Inscrição».
- Conectar o arrobaMail aos seus sistemas — o panorama completo de integração, incluindo a API v3.