Gatilhos de automação

Um gatilho decide quando uma automação inicia uma execução. Esta página lista todos os gatilhos disponíveis em cada contexto, o que os dispara, as opções deles e a chave que você usa para cada um na API.

Como os gatilhos funcionam

• Um gatilho por automação no painel. Selecione o gatilho no canvas e altere-o em Trigger type. Pela API, as automações dos contextos Contact e Email podem ter vários gatilhos, desde que todos se conectem à mesma primeira etapa. As automações do contexto Event têm exatamente um.
• A automação precisa estar em execução. Os gatilhos de automações em rascunho, pausadas ou interrompidas são ignorados. Eventos anteriores ao início de uma automação não iniciam execuções depois.
• As execuções começam em segundos. O Emailit capta os novos eventos a cada poucos segundos.

Filtros

Contact updated e todos os gatilhos de e-mail aceitam um filtro opcional, em Filter events (optional). Cada regra compara um campo do evento com um valor:

• Operadores: Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with e Ends with. Greater than e Less than comparam números. Os demais comparam texto e diferenciam maiúsculas de minúsculas.
• Modo de correspondência: All rules match ou Any rule matches.

Pela API, um filtro é { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } no config.filter do gatilho, com match definido como all ou any. Os campos são caminhos dentro do objeto do evento, por exemplo to ou link.url.

Gatilhos de contato

Added to audience

Dispara quando alguém é adicionado a uma lista de contatos pelo painel (Add subscriber, Add to audience, Add contact com listas), pela API (Adicionar um inscrito, ou Criar um contato com audiences) ou com a ação em massa Add to audience. Adicionar de novo alguém que se descadastrou também o dispara.

Ele não dispara para contatos adicionados por uma importação de arquivo, por uma inscrição pela URL de inscrição ou pela etapa Add to audience ou Create contact de outra automação, e reativar Subscribed para um inscrito existente também não conta.

Removed from audience

Dispara quando um inscrito é excluído: Delete na página da lista, Remove from audience, Excluir um inscrito ou uma atualização de contato cuja lista audiences deixa a lista de fora. Excluir um contato o dispara uma vez para cada lista em que o contato estava. Descadastrar não o dispara, porque a pessoa continua na lista.

Contact updated

Dispara sempre que um contato é atualizado no painel ou pela API, incluindo as ações em massa Unsubscribe e Resubscribe. O filtro pode verificar os valores atuais de Email, First name, Last name, Unsubscribed e dos campos personalizados, e os valores anteriores deles, listados como Previous email, Previous first name e assim por diante. Os valores anteriores só estão presentes para os campos que mudaram.

Por exemplo, para reagir quando um contato passa para o plano pro, adicione duas regras com All rules match: custom_fields.plan Equals pro e Previous plan (previous.custom_fields.plan) Not equals pro.

Date anniversary

Escolha um Date field, um campo personalizado do tipo data, como um aniversário. Uma vez por dia, o Emailit inicia uma execução para cada contato cuja data tenha o mês e o dia de hoje, em UTC. O ano não importa, então um contato com 1990-04-12 recebe uma execução todo dia 12 de abril. Cada automação processa até 10.000 contatos por dia.

Gatilhos de contato só pela API

A API também aceita contact.visits_url, contact.on_purchase e contact.on_event, mas nada os dispara ainda.

Gatilhos de e-mail

Os gatilhos de e-mail disparam para os e-mails do seu workspace: tudo o que você envia pela API ou por SMTP, os e-mails de campanhas e de automações e, para Email received, os e-mails recebidos. Cada execução se refere a um e-mail.

O editor também lista Email accepted, Email scheduled, Email attempted e Email rejected. As automações com esses gatilhos ainda não podem ser salvas, então escolha um dos gatilhos acima. Pela API, você também pode usar email.canceled, que dispara quando um e-mail agendado ou na fila é cancelado.

Gatilhos de evento

Por enquanto, as automações do contexto Event só podem ser criadas pela API.

Manual trigger

Chame o endpoint de disparo de uma automação em execução, com um objeto payload opcional:

curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'

O endpoint retorna { "message": "Automation trigger dispatched." }, ou 422 se a automação não estiver em execução. As etapas podem ler o payload como {{payload.email}}, {{payload.plan}} e assim por diante. O Emailit adiciona automation_id ao payload.

system.manual também funciona como gatilho em automações dos contextos Contact e Email criadas pela API. Inclua contact_id (um ID con_) ou email_id no payload para executar a automação para esse contato ou e-mail.

Dados disponíveis para as etapas

As configurações das etapas, como o destinatário de Send email ou os valores de Edit contact, podem incluir variáveis que são preenchidas em cada execução:

Os templates de e-mail enviados por Send email usam o Temple com os mesmos dados. Consulte Etapas.

Veja também