Sumário
- O que é automação de e-mails?
- Acesso e disponibilidade
- Criar seu fluxo de trabalho
- Acionadores Comportamentais
- Eventos externos (Webhooks)
- Salvar e publicar fluxos de trabalho
- Criar um fluxo de trabalho a partir de um modelo
- Ejemplos de flujos de trabajo
- Estatísticas da automação
- Links de cancelamento de inscrição em e-mails de automação
- Gerenciar um fluxo de trabalho existente
O que é automação de e-mails?
As automações ajudam a enviar mensagens personalizadas no momento certo para seu público sem precisar gerenciar cada envio manualmente. Usando acionadores predefinidos, você pode criar fluxos de trabalho que respondem automaticamente às ações dos seus contatos, reduzindo as tarefas manuais e melhorando a jornada do cliente.
Os fluxos de trabalho automatizados são flexíveis, eficientes e criados para ajudar você a se conectar com o seu público no momento certo, sem despesas extras.
O editor de automação visual do Mailjet simplifica a criação e o gerenciamento de seus fluxos de trabalho. A tela intuitiva de arrastar e soltar permite criar jornadas de cliente com facilidade. Você pode ampliar para ter uma visão detalhada, reorganizar os blocos conforme sua estratégia evoluir e criar jornadas que crescem com sua empresa.
Acesso e disponibilidade
- A automação está disponível exclusivamente para os planos Premium 15.000 e superiores.
- Se você fizer downgrade para um plano sem suporte a automação, todos os fluxos de trabalho ativos serão pausados automaticamente.
Criar seu fluxo de trabalho
Para começar, navegue até Automações na navegação do Mailjet e selecione "Criar um fluxo de trabalho".
No builder, escolha o tipo de e-mails que o fluxo de automação enviará: Marketing ou Transacionais.
Em seguida, use os blocos no painel à direita para criar a jornada do seu cliente. Embora nosso objetivo seja enfatizar a "jornada", faremos referência a "fluxo de trabalho" quando for apropriado no contexto.
Cada bloco permite acionar uma ação, aguardar um evento ou aplicar uma condição ao fluxo de trabalho.
Bloco Iniciar
O Bloco Iniciar determina quais critérios o seu contato precisa atender para entrar no fluxo de trabalho. Você determinará os critérios selecionando um tipo de acionador e configurando seu público.
- Opções de acionamento do fluxo de trabalho.
- Evento Assinatura: aciona o fluxo de trabalho quando os contatos se inscrevem em uma, várias ou todas as listas de contatos.
- Evento Atualização da Propriedade do Contato (APC): aciona o fluxo de trabalho quando uma propriedade de contato é atualizada.
-
Acionador comportamental (OPEN/CLICK): Aciona quando o contato abre um e-mail ou clica em um link — com filtros opcionais por Campanhas, Tags e Remetentes.
Para mais detalhes sobre Acionadores Comportamentais, acesse a seção “ Acionadores Comportamentais ” deste artigo. -
Evento externo (Webhook): Dispare um fluxo quando o seu sistema (site, app, CRM, etc.) enviar um evento para o Mailjet via API. Você pode selecionar um ou mais qualificadores de webhook (os “nomes” dos eventos) para definir quais eventos externos podem iniciar o fluxo.
Para mais detalhes sobre webhooks, vá para a seção « Eventos externos (Webhooks) » deste artigo.
- Segmentar seu público (opcional)
- Selecione ou crie um segmento a partir de seus segmentos existentes.
- Criar um filtro personalizado: segmente seu público-alvo criando um segmento disponível somente no fluxo de trabalho. Observação: os segmentos de filtro personalizado não estarão disponíveis em sua lista de segmentação ou ao enviar uma campanha.
Exemplo de configurações de Bloco Iniciar:
- O contato assinou qualquer lista de contatos e está localizado na França.
- Contatos que se inscreveram na lista de contatos "Newsletter".
- Contatos que assinaram "Newsletter" ou "Promoções" e pertencem a um segmento "Usuário engajado".
- Comportamental (OPEN): o contato abre um e-mail da campanha “Spring_Sale_2026” ou “VIP_Offers”.
- Comportamental (CLICK): o contato clica em um link com as tags
pricingouupgradeem qualquer campanha. - Comportamental (OPEN + Remetentes): o contato abre um e-mail enviado de
news@mail.example.comouoffers@mail.example.com. - Comportamental (CLICK + Campanhas + Tags): o contato clica em um link com as tags
shoesousneakersnas campanhas “Summer_Catalog” ou “Back_To_School”. - Evento externo (Webhook): O contato aciona o evento externo
purchase_completed.
Após configurar o Bloco Iniciar para definir quais critérios o público deve atender para entrar no fluxo de trabalho, você começará a projetar a jornada do cliente.
Bloco Enviar E-mail
Envia automaticamente um email predefinido aos contatos quando eles chegam a esta etapa do workflow.
- Editar design: Personalize o conteúdo do seu modelo de email.
- Nome da campanha: Insira um nome para identificar sua campanha.
- Dados do webhook: A opção Usar dados do webhook permite que o bloco Enviar um email utilize os dados recebidos de um webhook de entrada ou de um evento externo. Isso permite personalizar o email com os valores enviados no payload do webhook, e não apenas com as propriedades padrão do contato.
👉Exemplo: usar dados de um webhook
Imagine que você tenha uma loja online. Sempre que um cliente conclui uma compra, seu site envia uma solicitação HTTP POST para o endpoint do webhook do Mailjet Workflows. Esse evento aciona a ação correspondente no seu workflow de automação.
O webhook envia dados como estes:
{
"Tag": "purchase_completed",
"contactMail": "localpart@domainpart.tld",
"Data": {
"Variables": {
"firstname": "John",
"product_name": "Running Shoes",
"order_number": "ORD-45821",
"delivery_date": "25 June",
"discount_code": "THANKYOU10"
}
}
}
Sua automação poderia ser:
Evento externo/webhook recebido → Enviar um email
No bloco Enviar um email, ative a opção Usar dados do webhook.
https://api.mailjet.com/V3/REST/workflow2/event ao processar esse bloco específico Enviar um email.No conteúdo do bloco Enviar um email, você pode usar a linguagem de modelos do Mailjet (https://documentation.mailjet.com/hc/pt-br/articles/16886347025947-Mailjet-Templating-Language) e, especificamente, as variáveis do tipo var. Os valores de substituição dessas variáveis são enviados por meio da chamada para https://api.mailjet.com/V3/REST/workflow2/event:
Olá {{var:firstname:""}},
Agradecemos pelo seu pedido {{var:order_number:""}}.
Você comprou: {{var:product_name:"seu produto"}}
A data estimada de entrega é {{var:delivery_date:"em breve"}}.
Aqui está um desconto para seu próximo pedido: {{var:discount_code:""}}
O destinatário receberia:
Olá John, Agradecemos pelo seu pedido ORD-45821. Você comprou: Running Shoes. A data estimada de entrega é 25 June. Aqui está um desconto para seu próximo pedido: THANKYOU10
Sem a opção Usar dados do webhook, o email usaria apenas os dados padrão do contato já armazenados no Mailjet, como as propriedades do contato, que podem ser recuperadas por meio de variáveis do tipo data, e não por variáveis do tipo var. Não seria possível usar valores temporários do webhook, como o número do pedido, o nome do produto ou o código de desconto.
👉Definição do endpoint
Os eventos do webhook são enviados para o seguinte endpoint:
POST /v3/REST/workflow2/event
Campos do payload
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ContactID |
Opcional | Integer | O ID do contato para o evento. É necessário fornecer pelo menos ContactID ou ContactMail. |
ContactMail |
Opcional | String | O endereço de email do contato para o evento. É necessário fornecer pelo menos ContactID ou ContactMail. |
Tag |
Obrigatório | String | O nome do evento. Esse valor deve corresponder ao nome do evento usado no gatilho do workflow. |
Data |
Opcional | Object | Um objeto que contém dados adicionais da mensagem que podem ser reutilizados posteriormente em um bloco Enviar um email do workflow. |
Se o objeto Data for incluído no payload do evento, os dados serão armazenados temporariamente no estado do workflow do contato. Depois, eles poderão ser usados por um bloco Enviar um email posterior no mesmo workflow.
Esses dados são removidos do estado do workflow após serem usados ou quando o contato sai do workflow.
Campos disponíveis no objeto Data
O objeto Data pode incluir campos compatíveis com a API Send do Mailjet.
| Campo | Obrigatório | Tipo | Descrição |
|---|---|---|---|
From |
Opcional | Object | Define o endereço de email e o nome do remetente. O objeto contém duas propriedades: Email e Name. |
Variables |
Opcional | Object | Define variáveis que podem ser usadas para personalizar o conteúdo do email. As variáveis devem ser fornecidas como pares de chave e valor, por exemplo: { "firstname": "John" }. |
CustomID |
Opcional | String | Adiciona um ID personalizado à mensagem. |
EventPayload |
Opcional | String | Adiciona um payload à mensagem. O payload pode usar qualquer formato padrão, como JSON, XML ou CSV. |
TrackOpens |
Opcional | String | Ativa ou desativa o rastreamento de aberturas desta mensagem. Valores permitidos: account_default, enabled e disabled. Valor padrão: account_default. |
TrackClicks |
Opcional | String | Ativa ou desativa o rastreamento de cliques desta mensagem. Valores permitidos: account_default, enabled e disabled. Valor padrão: account_default. |
TemplateErrorDeliver |
Opcional | Boolean | Quando definido como true, a mensagem é entregue mesmo que seja detectado um erro na linguagem de modelos. Quando definido como false, a entrega é interrompida caso seja detectado um erro de modelo. Esse campo só pode ser usado quando a linguagem de modelos está ativada. Valor padrão: false. |
TemplateErrorReporting |
Opcional | Object | Define o destinatário que deve receber uma cópia do email com a mensagem de erro caso ocorra um problema com o modelo. O objeto contém Email e Name. |
Exemplo de payload
{
"ContactMail": "john@example.com",
"Tag": "purchase_completed",
"Data": {
"Variables": {
"firstname": "John",
"product_name": "Running Shoes",
"order_number": "ORD-45821",
"delivery_date": "25 June",
"discount_code": "THANKYOU10"
},
"TrackOpens": "enabled",
"TrackClicks": "account_default",
"CustomID": "order-confirmation-ORD-45821"
}
}
Neste exemplo:
-
ContactMailidentifica o contato que deve entrar no workflow. -
Tagdefine o nome do evento usado para acionar o workflow. -
Variablescontém valores temporários que podem ser usados em um bloco Enviar um email posterior. -
TrackOpensativa o rastreamento de aberturas desta mensagem. -
TrackClicksusa as configurações de rastreamento definidas na conta do Mailjet. -
CustomIDadiciona um identificador personalizado à mensagem.
Para usar no email os valores do objeto Variables, ative a opção Usar dados do webhook no bloco Enviar um email.
Em seguida, você pode fazer referência a essas variáveis no modelo de email usando a linguagem de modelos do Mailjet, por exemplo:
Olá {{var:firstname:""}},
Agradecemos pelo seu pedido {{var:order_number:""}}.
Você comprou: {{var:product_name:"seu produto"}}
A data estimada de entrega é {{var:delivery_date:"em breve"}}.
Aqui está seu código de desconto: {{var:discount_code:""}}
Bloco Gerenciar Contato nas Listas
Permite gerenciar seus contatos em listas específicas:
- Assinar uma lista: adiciona e faz o contato assinar uma lista selecionada.
- Adicionar a uma lista e assinar novamente: adiciona o contato e faz ele assinar novamente, se já estiver presente.
- Adicionar a uma lista sem assinar: adiciona o contato sem alterar o status da assinatura.
- Cancelar assinatura de uma lista: remove a assinatura do contato da lista selecionada.
- Excluir de uma lista: remove completamente o contato da lista selecionada.
Bloco Atualização de Propriedade de Contato
Permite atualizar as propriedades existentes dos seus contatos:
- Selecione a propriedade do contato que você deseja atualizar entre as propriedades disponíveis (p.ex., idade, cidade, data de nascimento).
- Defina o novo valor a ser aplicado.
Bloco Condição
Ao usar o Bloco Condição, você pode avaliar o contato em relação a critérios para determinar em qual rota do fluxo de trabalho ele entrará, selecionando um segmento.
- Os critérios para a condição são definidos por segmentos ou filtros personalizados
- Os contatos que não atenderem a nenhuma condição passarão por um caminho padrão de "fallback".
Exemplo:
Uma condição pode ser aplicada para determinar se o contato engajou recentemente, criando um filtro usando "Abriu um e-mail nos últimos X dias". Se o destinatário tiver aberto um e-mail enviado nos últimos X dias, ele sairá do fluxo de trabalho. Se ele não tiver aberto nenhum, receberá um novo e-mail.
Bloco Evento
O Bloco Evento aguarda a ocorrência de um evento para o contato avançar no fluxo de trabalho. Para configurar o Bloco Evento, selecione
Tipos de eventos
- Assinatura em lista — adicionado/inscrito em uma lista.
- Atualização de propriedade do contato — um valor é alterado.
- Comportamental: OPEN — o contato abre um e-mail (pode ser filtrado).
-
Comportamental: CLICK — o contato clica em um link (pode ser filtrado).
Para mais detalhes sobre Acionadores Comportamentais, acesse a seção “ Acionadores Comportamentais ” deste artigo. -
Evento externo (Webhook) — o fluxo fica pausado até que o seu sistema envie um evento externo correspondente (qualificador de webhook) para esse contato.
Para mais detalhes sobre webhooks, vá para a seção « Eventos externos (Webhooks) » deste artigo.
Configurar o cronômetro de fallback: isso garante que o contato não fique preso no fluxo de trabalho porque o evento nunca ocorreu.
Bloco Cronômetro
Esse bloco permite determinar quando o contato passará para a próxima etapa da jornada, configurando um temporizador de atraso, um filtro de data personalizado ou um cronômetro de propriedade de data.
- O Cronômetro de Atraso permite que você atrase a próxima etapa do fluxo de trabalho em minutos, horas ou dias.
- O Cronômetro de Data Personalizada atrasará a próxima etapa com base em uma data definida. Depois de selecionar a data, você determinará se deseja que seja uma ocorrência única ou que ocorra de forma anual/mensal recorrente.
- O Cronômetro de Propriedade de Data permite atrasar a próxima etapa com base em uma data da propriedade do contato (p.ex., aniversário).
Se você quiser mais precisão quanto ao momento em que o e-mail será enviado, todos os três tipos de cronômetro permitem especificar a que hora você deseja que o e-mail seja enviado e em que dias da semana você deseja enviar o e-mail.
Bloco Sair
O Bloco Sair representa o fim de um fluxo de trabalho para um contato. Um fluxo de trabalho pode ter muitos Blocos Sair para cada caminho representado no fluxo de trabalho, e cada bloco de saída permite determinar se o contato deve ter permissão para voltar ao fluxo de trabalho se corresponder novamente aos critérios de acionamento do Bloco Iniciar.
Acionadores Comportamentais
Os acionadores comportamentais permitem criar fluxos de automação avançados com base no comportamento dos seus contatos: abertura de um e-mail ou clique em um link. Esses dois eventos estão disponíveis nos blocos Inicial e Evento do construtor de automação.
Filtros disponíveis
Você pode aplicar quatro tipos de filtros — usar um ou combinar vários.
👉 Filtrar por Campanhas
Aguarde um evento (OPEN/CLICK) em e-mails de campanhas específicas. É possível selecionar até 10 campanhas por filtro de evento, combinando quaisquer dos tipos abaixo:
-
Campanhas de marketing (Newsletters) – Enviadas pelo app ou via
/v3/REST/campaigndraft. - Campanhas transacionais – Mensagens enviadas pela Send API v3.1 usando um nome CustomCampaign (estatísticas agregadas sob esse nome).
- Campanhas de fluxo – Campanhas emitidas por blocos Enviar e-mail na automação (do fluxo atual ou de outros fluxos publicados).
- Campanhas personalizadas – Nomes futuros de campanhas transacionais; adicione-os agora como texto livre.
👉 Filtrar por Tags
Tags são cadeias ASCII personalizadas (máx. 64 caracteres) sem espaços e caracteres especiais (exceto sublinhado _); a tag não pode ser apenas _. Você pode adicionar até 10 tags por filtro de evento.
- OPEN — Aguardar aberturas em e-mails associados a tags específicas.
- CLICK — Aguardar cliques em links associados a tags específicas.
Como as tags de OPEN são aplicadas
-
Editor (UI) – No editor de e-mail, acesse Settings > Tags e adicione uma ou mais tags (comprimento combinado ≤ 255 caracteres).
-
Send API v3 – Use o cabeçalho
Mj-WorkflowTagscom uma lista separada por vírgulas (ex.:tag1,tag2).
{
"Messages": [
{
"FromEmail": "sender@example.com",
"FromName": "Your Mailjet Pilot",
"Recipients": [{ "Email": "user@example.com", "Name": "Passenger 1" }],
"Mj-WorkflowTags": "tag1,tag2,tag8",
"Subject": "Your email flight plan!",
"Text-Part": "Welcome to Mailjet!",
"HTML-Part": "<h3>Welcome to <a href="https://www.mailjet.com/?mj-workflow-tags=tag4,tag5">Mailjet</a></h3>"
}
]
}-
Send API v3.1 – Use a propriedade
WorkflowTagscom uma lista separada por vírgulas.
{
"SandboxMode": false,
"Messages": [
{
"From": { "Email": "sender@example.com", "Name": "Your Mailjet Pilot" },
"Sender": { "Email": "sender@example.com", "Name": "Your Mailjet Co-pilot" },
"To": [{ "Email": "user@example.com", "Name": "Passenger 1" }],
"WorkflowTags": "tag1,tag2",
"Subject": "Your email flight plan!",
"TextPart": "Welcome to Mailjet!",
"HTMLPart": "<h3>Welcome to <a href="https://www.mailjet.com/?mj-workflow-tags=tag4,tag5">Mailjet</a></h3>",
"Priority": 2,
"CustomCampaign": "test-send-api-tag-1"
}
]
}Como as tags de CLICK são aplicadas
-
Editor (UI) – Ao adicionar um link a um texto ou botão, defina as tags no modal do link (comprimento combinado ≤ 255 caracteres).
-
HTML personalizado via APIs (v3 ou v3.1) – adicione você mesmo as tags a cada link usando um parâmetro de consulta:
mj-workflow-tags=tag1,tag2
mj-workflow-tags durante o redirecionamento, de modo que os destinatários não o veem na URL final.👉 Filtrar por Remetentes
Aguarde um OPEN/CLICK em e-mails enviados de endereços de remetente específicos. Você pode escolher até 10 remetentes por filtro de evento (de qualquer remetente da sua chave de API).
Combinar filtros
Você pode usar um único filtro (Campanhas, Tags ou Remetentes) ou combinar vários.
- Ao escolher vários itens dentro do mesmo tipo de filtro (por exemplo, várias campanhas), você indica “qualquer um serve”. (Isso é um OU.)
- Quando você combina diferentes tipos de filtro (por exemplo, Campanhas e Tags), você indica “todos os tipos escolhidos devem coincidir ao mesmo tempo”. (Isso é um E.)
🔎Exemplo (evento CLICK):
Você escolhe as campanhas A ou B e as tags X ou Y.
O fluxo só é acionado quando alguém clica em um link que:
- está na Campanha A ou na Campanha B
E
- esse link possui a tag X ou a tag Y.
Notas (Acionadores Comportamentais)
- Pelo menos um filtro é obrigatório.
- Máximos por filtro: 10 campanhas, 10 tags, 10 remetentes.
-
Formato das tags: somente ASCII; ≤ 64 caracteres cada; sem espaços; apenas
_permitido como caractere especial; a tag não pode ser apenas_. - Limite total de comprimento no editor: comprimento combinado de todas as tags ≤ 255 caracteres.
- Rastreamento obrigatório: os acionadores OPEN e CLICK exigem rastreamento de aberturas/cliques ativado na sua conta e nos e-mails; caso contrário, os eventos não serão disparados.
- Links do sistema excluídos (CLICK): descadastro, saída do fluxo e outros links do sistema não são considerados no filtro de campanhas.
-
Limpeza de URL:
mj-workflow-tagsé removido durante o redirecionamento (com o rastreamento de cliques ativado), permanecendo invisível para os destinatários.
Eventos externos (Webhooks)
Os eventos externos permitem que você dispare ou continue um fluxo de automação com base em ações que acontecem fora do Mailjet, como:
uma compra concluída
um teste iniciado
uma assinatura renovada
lembrete de carrinho abandonado
Diferentemente dos webhooks da Event API do Mailjet (em que o Mailjet envia eventos de e-mail para o seu servidor), este recurso é o inverso: o seu sistema envia um evento para o Mailjet para avançar um contato em um fluxo.
Conceitos-chave
Qualificador do webhook: O “nome do evento” que você escolhe no builder (por exemplo
purchase_completed). A sua chamada de API deve enviar o mesmo qualificador para que o Mailjet possa associá-lo ao bloco Start/Event.Correspondência do contato: O evento externo é vinculado a um contato específico (normalmente pelo endereço de e-mail). Se o qualificador e o contato não corresponderem ao que o bloco está aguardando, nada acontece.
👉 Como funciona no bloco Start
Selecione O contato dispara um evento externo
Adicione um ou mais qualificadores de webhook (estes são os eventos externos que podem iniciar o fluxo).
(Opcional) Adicione um segmento/filtro personalizado para restringir quem pode entrar.
Implemente a chamada de API no seu sistema usando o snippet de código mostrado no builder.
👉 Como funciona no bloco Event
Use o bloco Event quando um contato já estiver dentro de um fluxo e você quiser aguardar uma ação externa:
Adicione um bloco Event.
Selecione Evento externo (Webhook) como o tipo de evento.
Escolha o(s) qualificador(es) de webhook que o fluxo deve escutar.
(Opcional) Adicione um segmento/filtro personalizado para restringir quem pode entrar.
Configure o temporizador de fallback: isso garante que um contato nunca fique preso no fluxo indefinidamente, caso o evento nunca ocorra.
Exemplo de caso de uso: Enviar um e-mail → aguardar purchase_completed por até 3 dias → se sim, enviar “Obrigado”; se não, enviar um lembrete.
Disparar o evento externo (chamada de API)
Quando a ação externa acontecer no seu sistema, envie uma solicitação POST para o endpoint external-event do Mailjet usando a mesma chave de API do fluxo.
curl -X POST "https://api.mailjet.com/V3/REST/workflow2/event" -H "Content-Type: application/json"
-d '{ "Tag": "$tag_Name", "contactMail": "$Email_Of_Existing_Contact" }'
-u "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE"No corpo da solicitação:
envie o qualificador de webhook selecionado (nome do evento)
envie o identificador do contato (normalmente o e-mail do contato)
Boas práticas
Mantenha os qualificadores consistentes e descritivos (por exemplo,
trial_started,plan_upgraded,invoice_paid).Use uma convenção de nomes controlada (minúsculas + underscores).
Sempre configure um temporizador de fallback em blocos Event para evitar contatos “presos”.
Registre a chamada de API de saída e a resposta do nosso servidor no seu sistema (código de status + payload) para facilitar o troubleshooting.
Checklist de troubleshooting
Se o fluxo não iniciar (ou o contato não avançar além de um bloco Event):
Confirme se o qualificador na chamada de API corresponde exatamente ao qualificador selecionado no bloco.
Confirme se você está usando a chave de API correta (a que pertence ao fluxo).
Confirme se o contato existe na sua audiência do Mailjet e se o identificador corresponde (por exemplo, o mesmo endereço de e-mail).
Se este for um bloco Event, confirme se o contato já chegou a esse bloco (e não saiu do fluxo).
Respostas da API e erros comuns
👉 404 — O contato não existe
O que você verá
HTTP/2 404
content-type: application/json; charset=utf-8
{"Code":"","Message":"The requested resource does not exist","Status":404,"Details":null}
Significado
O Mailjet não encontrou o contato referenciado na sua solicitação (por exemplo, o e-mail do contato não está presente nos contatos da sua chave de API).
Como corrigir
Confirme se o contato existe na sua audiência do Mailjet antes de enviar o evento.
Verifique se você está usando a conta / chave de API correta (aquela em que o contato está armazenado).
Revise o valor enviado em
contactMail(erros de digitação, espaços extras, domínio incorreto).
👉 204 — O Mailjet recebeu sua solicitação com sucesso
Uma resposta 204 significa que o Mailjet recebeu sua solicitação com sucesso, mas não retorna um corpo de resposta. Um 204 não indica de forma confiável se uma ação do fluxo foi disparada.
O que você verá
HTTP/2 204
Significado
A) Solicitação recebida e a ação do fluxo foi disparada
Isso acontece quando o evento corresponde a tudo o que o fluxo espera:
o contato existe e é identificável por
contactMailo qualificador do webhook (
Tag) corresponde a um qualificador selecionado no bloco Start ou Evento contato atende a quaisquer filtros adicionais dos blocos Start/Event (pertencimento ao segmento, condições etc.)
O que fazer
Verifique a progressão do contato na UI de Automação (por exemplo, o contato avançou além do bloco Start/Event ou entrou na próxima etapa).
Se a próxima etapa do fluxo enviar um e-mail, confirme se a mensagem aparece no histórico/atividade do contato.
B) Solicitação recebida, mas nenhuma ação do fluxo foi disparada
Um 204 também pode ocorrer quando a solicitação é válida, mas não corresponde às condições da automação, por exemplo:
o qualificador (
Tag) não corresponde aos qualificadores selecionados no blocoo contato não corresponde aos filtros do fluxo (segmento / condições)
o contato não é elegível para entrar/reentrar no fluxo devido às configurações do fluxo (por exemplo, “Contatos não podem reentrar”)
o contato não está atualmente aguardando no bloco Event específico que você pretendia satisfazer
O que fazer
Verifique se a grafia/capitalização corresponde exatamente ao que está configurado no builder.
Confirme se o contato atende ao segmento/aos filtros usados no bloco Start/Event.
Confirme as regras de entrada (reentrada) do fluxo e onde o contato está atualmente no fluxo.
Recomendação: trate 204 como “aceito” e verifique o resultado na UI
Como 204 pode corresponder a ambos os resultados acima, trate-o como solicitação aceita e confirme o resultado verificando:
a posição/progresso do contato no fluxo
Verificar o resultado de um 204 via API (endpoint Messages)
Como 204 No Content apenas confirma que a solicitação foi aceita (e não fornece um corpo de resposta), você pode validar se o fluxo realmente enviou um e-mail consultando o recurso Messages do Mailjet para esse contato dentro de uma janela de tempo definida. (Para mais detalhes, consulte nossa documentação para desenvolvedores aqui.)
1) Consultar mensagens enviadas para um contato específico
Use o ContactID do contato e um timestamp inicial:
GET https://api.mailjet.com/v3/REST/message?Contact=$ContactID&FromTS=2026-01-19T00:00:00
Como interpretar o resultado
Mensagens retornadas (Count > 0 / array Data contém registros): o fluxo disparou o envio de um e-mail para esse contato dentro do período solicitado.
Nenhuma mensagem retornada (Count = 0 / Data vazio): ou nenhum e-mail foi enviado nesse intervalo, ou você precisa ampliar a janela de tempo (ou verificar se está usando o ContactID/conta corretos).
Boas práticas
Use uma janela
FromTSsuficientemente ampla ao testar (por exemplo, comece 15–60 minutos antes da chamada de teste).Use um fuso horário consistente nos logs e timestamps (UTC recomendado).
2) Se você não tiver o ContactID
Se o seu sistema tiver apenas o endereço de e-mail, recupere o ContactID primeiro (via os recursos Contacts) e então chame o endpoint Messages com o filtro Contact. Encontre mais informações aqui.
3) O que isso confirma (e o que não confirma)
Essa verificação confirma que existe um objeto de mensagem para esse contato no intervalo de tempo. No entanto, ela não prova, por si só, qual bloco o disparou — então, ao fazer troubleshooting, combine com:
progressão na UI do fluxo (posição do contato no fluxo), e/ou
logs do seu sistema (timestamp + qualificador/tag enviado + request GUID).
👉 400 — Tag inválida (caracteres não suportados, por exemplo, usar “-”)
O que você verá
HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid Tag: should contain only alphanumeric ASCII characters and underscores","Status":400,"Details":null}
Significado
O qualificador do webhook (Tag) contém caracteres inválidos. As tags devem usar apenas caracteres ASCII alfanuméricos e underscores (por exemplo: purchase_completed). Hífens (-) não são permitidos.
Como corrigir
-
Substitua hífens por underscores:
purchase-completed→purchase_completed
Padronize uma convenção de nomes para qualificadores nos seus sistemas (recomendado: minúsculas + underscores).
👉 400 — Estrutura de payload inválida (tentativa de enviar Tag como um array)
O que você verá
HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"error casting payload into associated model","Status":400,"Details":null}
Significado
O corpo da solicitação não corresponde ao schema esperado. Tag deve ser uma string única, não um array.
Como corrigir
Envie um qualificador por solicitação (um valor
Tag).Se você precisar disparar vários qualificadores, envie várias chamadas à API — uma por qualificador.
👉 400 — ContactMail inválido (formato de e-mail inválido)
O que você verá
HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid ContactMail: mail: missing '@' or angle-addr","Status":400,"Details":null}
SignificadocontactMail não é um formato de e-mail válido (por exemplo, falta @).
Como corrigir
Valide endereços de e-mail no seu sistema antes de chamar o endpoint.
-
Certifique-se de enviar um endereço de e-mail simples (sem formatação de nome de exibição), por exemplo:
Válido:
user@example.comNão válido:
John Doe <user@example.com>
Salvar e publicar fluxos de trabalho
- Os fluxos de trabalho são salvos automaticamente, e a última hora salva será anotada no cabeçalho da tela do fluxo de trabalho.
- Você pode salvar manualmente um fluxo de trabalho ou selecionar "Salvar e publicar"
- Depois de publicar um fluxo de trabalho, você pode editá-lo selecionando a opção de ativar/desativar rascunho.
Quando você estiver pronto para publicar e tiver selecionado a opção, você precisará escolher se deseja aceitar apenas eventos futuros ou incluir contatos existentes, verificando-os de acordo com os critérios do Bloco Iniciar.
Depois que o fluxo de trabalho for publicado, você verá estatísticas básicas sobre os contatos que entraram no fluxo de trabalho, estão nele e saíram dele. Além disso, se você passar o mouse na miniatura de qualquer bloco de ação de e-mail no fluxo de trabalho, você terá uma pré-visualização das estatísticas da campanha para esse bloco.
Criar um fluxo de trabalho a partir de um modelo
Para facilitar ainda mais o início com as automações, a Mailjet agora oferece uma seleção de modelos de fluxos de trabalho predefinidos para os casos de uso mais comuns.
Em vez de criar seu fluxo de trabalho do zero, você pode escolher um modelo pronto e personalizá-lo conforme suas necessidades. Isso economiza tempo e garante o uso das melhores práticas em automação de e-mails.
Como usar um modelo:
- Acesse a seção Automações da sua conta Mailjet.
- Clique em Criar a partir de um modelo no canto superior direito.
- Explore os modelos disponíveis e escolha aquele que melhor se adapta ao seu objetivo.
- Clique em Começar a construir para personalizar o fluxo de trabalho.
Modelos disponíveis:
- Série de boas-vindas – Dê as boas-vindas aos novos usuários e apresente sua marca.
- Sequência de onboarding – Acompanhe os usuários nos primeiros passos.
- Campanha de reengajamento – Recupere contatos inativos.
- Confirmação de atualização de perfil – Valide alterações importantes nas informações dos contatos.
- E-mails de aniversário de assinatura – Comemore marcos importantes com seus usuários.
- Nurturing de leads – Eduque seus leads ao longo da jornada de compra.
Outros modelos também estão disponíveis: Celebrações de marcos, Solicitações de feedback, Convites para eventos, Inscrição em programas de fidelidade, Campanhas de reconquista, entre outros.
Você também pode escolher a opção Tela em branco para criar um fluxo de trabalho totalmente personalizado.
Ejemplos de flujos de trabajo
Fluxo de Aniversário
Com o construtor de automações da Mailjet, você pode criar facilmente fluxos que são acionados em datas recorrentes — perfeitos para aniversários, aniversários de associação ou lembretes de renovação.
Abaixo está um exemplo passo a passo de como configurar um fluxo de e-mail de aniversário:
Visão Geral da Estrutura do Fluxo
O fluxo consiste em três etapas principais:
- Gatilho: Quando o aniversário do contato é atualizado.
- Temporizador: Aguarda até a próxima ocorrência anual do aniversário.
- Ação: Envia um e-mail de aniversário.
1. Defina o Gatilho (Atualização de Propriedade do Contato)
Comece criando um novo fluxo e selecione o gatilho "Atualização de propriedade do contato".
- Configure o filtro da propriedade do contato para aniversário (propriedade do tipo data/hora).
- Aplique um segmento: adicione a condição "Está na lista" e selecione a lista de contatos que deseja segmentar (ex: MyFirstTest).
2. Adicione um Temporizador (Aguardar até a Próxima Ocorrência)
Adicione um bloco de Temporizador após o gatilho.
- Escolha a propriedade de aniversário.
- Defina como "Ativar na próxima ocorrência anual".
- Opcional: Especifique um horário do dia, dia(s) da semana ou aplique um atraso, se necessário.
3. Configure o E-mail (Enviar E-mail)
Adicione um bloco de Enviar E-mail após o Temporizador.
- Crie seu modelo de e-mail de aniversário.
- Exemplo de assunto: “🎂 Feliz Aniversário de todos nós!”
4. Ative o Ciclo Anual
Conecte o final do fluxo de volta ao Temporizador para garantir que ele se repita todos os anos na data de aniversário do contato.
📝 Dicas
- Faça testes com contatos fictícios para verificar se o fluxo está funcionando corretamente.
- Você pode reutilizar essa configuração para outros eventos recorrentes, como aniversários de associação, lembretes de renovação ou marcos de fidelidade.
Estatísticas da automação
Depois que uma automação é publicada e os contatos começam a avançar pelo fluxo, você tem várias maneiras de monitorar o desempenho do fluxo de trabalho:
- Contadores de visão geral do fluxo de trabalho (no canto superior direito do editor)
- Estatísticas de emails enviados (aparecem quando você seleciona um bloco Enviar email)
- Estatísticas do fluxo de trabalho no nível do bloco (exibidas diretamente nos blocos do fluxo de trabalho na visualização publicada)
Contadores de visão geral do fluxo de trabalho
Os contadores de visão geral do fluxo de trabalho, no canto superior direito, resumem o status geral dos contatos na sua automação:
- Entraram — Contatos únicos que iniciaram o fluxo de trabalho.
- Ativos — Contatos que ainda estão avançando pelo fluxo de trabalho (por exemplo, aguardando um atraso ou uma condição).
- Saíram — Contatos que concluíram um caminho ou chegaram a um bloco de saída.
- Saíram antecipadamente — Contatos que saíram antes de concluir o fluxo de trabalho.
- Podem reentrar — Contatos autorizados a entrar novamente no fluxo de trabalho, dependendo das suas configurações de reentrada.
Estatísticas de emails enviados
Selecione uma etapa Enviar email para ver os KPIs dessa mensagem:
- Entregue — Aceito pelos servidores dos destinatários.
- Aberto — Aberturas rastreadas. (Pode ser inflado por recursos de privacidade, como o Apple Mail Privacy Protection.)
- Clicado — Pelo menos um clique em link.
- Cancelou a inscrição — Cancelamentos de inscrição a partir deste email.
- Bloqueado — Suprimido devido a hard bounces, reclamações ou cancelamentos de inscrição anteriores.
- Marcado como spam — Reclamações de spam.
- Hard bounce — Falhas permanentes, como um endereço de email inválido.
- Soft bounce — Problemas temporários, como uma caixa de entrada cheia ou limites de taxa.
- Tentando novamente — Adiado; a Mailjet tentará entregar novamente.
Estatísticas do fluxo de trabalho no nível do bloco
Na visualização publicada de uma automação, você também pode ver estatísticas detalhadas diretamente em cada bloco do fluxo de trabalho.
Essas estatísticas no nível do bloco ajudam você a entender como os contatos avançam pelo fluxo de trabalho e com que frequência cada etapa é usada.
Como as estatísticas são exibidas
Você pode alternar entre as estatísticas disponíveis no nível do bloco pelo painel de estatísticas do fluxo de trabalho, no canto superior direito do editor.
Ao selecionar uma dessas visualizações, a métrica correspondente aparece diretamente em cada bloco do fluxo de trabalho.
Para cada bloco, você verá:
- a estatística selecionada
- um ícone e uma cor correspondentes
- um contador exibido no bloco
Ao passar o cursor sobre a estatística exibida em um bloco, uma dica de ferramenta mostra todas as métricas disponíveis para esse bloco.
Contatos atualmente no bloco
Esta visualização mostra quantos contatos individuais estão atualmente em um bloco.
Ela é especialmente útil para blocos em que os contatos podem permanecer por algum tempo, como:
- Início
- Evento
- Temporizador
- Saída
Use esta visualização para ver onde os contatos estão aguardando ou avançando atualmente no fluxo de trabalho.
Contatos que chegaram ao bloco
Esta visualização mostra quantos contatos individuais chegaram a um bloco pelo menos uma vez.
Ela inclui:
- contatos que estão atualmente nesse bloco
- contatos que passaram por ele anteriormente
Use essa métrica para entender quantos contatos únicos passaram por cada etapa da automação.
Número de vezes que o bloco foi alcançado
Esta visualização mostra o número total de vezes que um bloco foi alcançado.
Esse número pode ser maior do que o número de contatos individuais, porque o mesmo contato pode chegar ao mesmo bloco mais de uma vez, por exemplo quando:
- o fluxo de trabalho permite reentrada
- um contato passa novamente pelo fluxo de trabalho
- caminhos diferentes levam o mesmo contato de volta à mesma etapa
Essa métrica é útil para medir:
- quantas vezes um bloco de ação foi executado
- quais caminhos são usados com mais frequência
📝Dicas
- As estatísticas aparecem depois que o primeiro contato entra no fluxo de trabalho e podem levar um curto período para serem atualizadas.
- Se seu fluxo enviar vários emails, revise as estatísticas de cada bloco Enviar email.
- As estatísticas do fluxo de trabalho no nível do bloco estão disponíveis apenas na visualização publicada de um fluxo de automação.
Links de cancelamento de inscrição em e-mails de automação
Os e-mails enviados por um fluxo de automação devem incluir pelo menos uma opção de cancelamento de inscrição gerada pelo Mailjet. Ela pode ser:
- um link de saída do fluxo de trabalho (“parar de receber e-mails desta série”), ou
- um link global de cancelamento de inscrição (“cancelar a inscrição de todos os e-mails de marketing”).
Você pode substituir um desses links gerados pelo Mailjet pela sua própria URL, mas não os dois.
Se o seu e-mail não contiver nenhum link de saída do fluxo de trabalho ou de cancelamento de inscrição gerado pelo Mailjet, o Mailjet adicionará automaticamente um rodapé de cancelamento de inscrição à mensagem. Esse rodapé contém tanto um link de saída do fluxo de trabalho quanto um link global de cancelamento de inscrição.
Links obrigatórios para templates de automação
Ao criar templates de automação, pelo menos uma das seguintes variáveis deve ser incluída:
-
[[WORKFLOW_EXIT_EN]]– Permite que o destinatário saia do fluxo de trabalho. -
[[UNSUB_ALL_LINK_EN]]– Permite que o destinatário saia do fluxo de trabalho e cancele a inscrição de todos os e-mails de marketing.
Gerenciar um fluxo de trabalho existente
Para gerenciar um fluxo de trabalho existente, acesse Meus fluxos de trabalho automatizados e clique no ícone de engrenagem à direita.
A partir daí, você pode escolher entre as seguintes opções:
Duplicar – Cria uma cópia do fluxo de trabalho selecionado. Isso é útil quando você quer reutilizar uma configuração existente em vez de criar um novo fluxo de trabalho do zero.
Bloquear – Bloqueia o fluxo de trabalho para impedir que novos contatos entrem nele, permitindo que os contatos que já estão no fluxo continuem e o concluam.
Parar – Interrompe a execução do fluxo de trabalho. Use esta opção se você não quiser mais que a automação continue processando contatos ou eventos.
Excluir – Remove permanentemente o fluxo de trabalho da sua conta.