Pular para o conteúdo
Docs

Guia

Migre do Mailjet para o Emailit. Faça a correspondência dos pares de chaves de API e dos remetentes, converta as chamadas à Send API v3.1 e a linguagem de templates, troque o SMTP e migre webhooks, a lista de exclusão e as listas de contatos.

Atualizado em 23 de out. de 2026

Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks, as supressões, os templates e os contatos do Mailjet e os equivalentes no Emailit. Leia antes Migrar para o Emailit para conhecer a ordem geral e saber como usar os dois provedores em paralelo.

Conceitos

Mailjet Emailit
Chave de API principal e chaves de API de sub-accounts Conta e workspaces. Cada workspace tem os seus próprios domínios, chaves, membros e créditos.
Par de chaves de API (chave pública e chave secreta) Chave de API: Full Access, ou Sending Only, que pode ser restrita a um domínio
Remetentes: endereços individuais e domínios inteiros Domínios de envio. Remetentes de um único endereço não estão disponíveis.
SandboxMode Não há modo de teste. Os workspaces novos ficam no modo sandbox e só entregam para membros do workspace.
Templates e a linguagem de templates do Mailjet Templates com alias e versões, renderizados com o Temple
Event API, uma URL por tipo de evento Webhooks: um endpoint pode receber todos os tipos de evento
Parse API Recebimento de e-mails
Lista de exclusão, quem reclamou de spam e endereços bloqueados Supressões
Contatos, listas de contatos e propriedades de contato Contatos, listas de contatos e campos personalizados
Segmentos Escolha listas de contatos e deixe outras de fora em cada campanha. Os segmentos estão em alfa e disponíveis apenas para a equipe do Emailit.
Campanhas e automações Campanhas e automações (beta)
CustomID, EventPayload, CustomCampaign meta
Estatísticas e histórico de mensagens Email APIEmails, Email APILogs e relatórios de campanha

Atualizar as chamadas à API

O POST /v3.1/send do Mailjet recebe autenticação básica e uma lista Messages com campos em PascalCase. O POST /v2/emails do Emailit recebe um bearer token e uma única mensagem com campos em minúsculas:

Antes: Mailjet
curl https://api.mailjet.com/v3.1/send \
  --user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
  -H "Content-Type: application/json" \
  -d '{
    "Messages": [{
      "From": { "Email": "hello@acme.com", "Name": "Acme" },
      "To": [{ "Email": "ada@example.com" }],
      "Subject": "Your receipt",
      "TextPart": "Thanks for your order.",
      "HTMLPart": "<p>Thanks for your order.</p>"
    }]
  }'
Depois: Emailit
curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<p>Thanks for your order.</p>"
  }'
Mailjet (Send API v3.1) Emailit
Autenticação básica com a chave pública e a chave secreta Authorization: Bearer secret_…
api.mailjet.com, ou api.us.mailjet.com para contas dos EUA Um único host, api.emailit.com
Messages[], até 50 por chamada Uma mensagem por requisição
From: { Email, Name } from: "Name <email>"
To, Cc, Bcc com Email e Name to, cc, bcc como string ou array de até 50 cada
ReplyTo reply_to
Subject, TextPart, HTMLPart subject, text, html
Headers headers
Attachments[] com ContentType, Filename, Base64Content attachments[] com content_type, filename, content
InlinedAttachments[] com ContentID attachments[] com um content_id, referenciado como cid: no HTML
CustomID, EventPayload, CustomCampaign meta, por exemplo meta: { "custom_id": "order-123" }, devolvido nos eventos de webhook
TemplateID, TemplateLanguage: true e Variables template (um alias ou ID) e variables
TrackOpens, TrackClicks tracking: { "loads": true, "clicks": true }
URLTags Adicione parâmetros UTM aos seus links. As campanhas os adicionam para você.
Globals Não disponível. Repita os campos compartilhados em cada requisição.
Resposta com MessageUUID e MessageID para cada destinatário 200 com id (em_…), status: "accepted" e, para vários destinatários, ids, com um ID para cada um

Os IDs do Emailit são strings, então você não precisa mais lidar com os valores inteiros grandes de MessageID do Mailjet. O Emailit também oferece agendamento com scheduled_at e novas tentativas seguras com um cabeçalho Idempotency-Key. Consulte Enviar um e-mail.

Mudar as configurações SMTP

Configuração Mailjet Emailit
Host in-v3.mailjet.com smtp.emailit.com
Porta 587, 588, 2525, 25 ou 80 (STARTTLS), 465 (TLS) 587, 2587, 2525 ou 25 (STARTTLS), 465 (TLS)
Usuário A sua chave de API pública emailit
Senha A sua chave de API secreta A sua chave de API do Emailit

O Emailit não lê os cabeçalhos do Mailjet, como X-Mailjet-Campaign, X-MJ-CustomID, X-MJ-EventPayload, X-Mailjet-TrackOpen, X-Mailjet-TrackClick, X-MJ-TemplateID ou X-MJ-Vars. Remova-os. Configure o rastreamento no domínio e use a API quando precisar de templates ou metadados. Consulte Configurações SMTP.

Correspondência dos eventos de webhook

Evento do Mailjet Evento do Emailit
sent email.delivered
bounce email.bounced. O Emailit também envia email.attempted para cada tentativa com falha que ele repete.
blocked email.suppressed quando o endereço tem uma supressão recipient
spam email.complained
open email.loaded
click email.clicked
unsub email.unsubscribed, somente para e-mails de campanha
Rota da Parse API email.received; depois, busque o conteúdo com GET /emails/{id}

O Emailit também envia email.accepted quando a API aceita um e-mail. Consulte Tipos de evento.

O formato da requisição muda:

  • O Mailjet precisa de uma URL para cada tipo de evento e envia um evento por requisição, a menos que você agrupe os eventos. Um webhook do Emailit pode ser inscrito em vários tipos de evento e envia um array JSON de até 100 eventos, então percorra o corpo em um loop.
  • O nome do evento passa de event para type, e o e-mail fica em data.object. Use data.object.id, o ID em_ da resposta do envio, em vez de MessageID ou Message_GUID, e data.object.to em vez de email. Os seus valores de meta, que substituem CustomID e Payload, ficam em data.object.meta.
  • Em email.loaded e email.clicked, data.object é o carregamento ou o clique. Use data.object.email_id para obter o ID do e-mail, e data.object.email.rcpt_to e data.object.email.meta para obter o destinatário e os seus valores de meta.
  • O Mailjet não assina as requisições dele. O Emailit assina todas: verifique X-Emailit-Signature com X-Emailit-Timestamp e o seu segredo whsec_ e, se quiser, retire as credenciais de autenticação básica da sua URL. Consulte Assinatura das requisições.
JavaScript
for (const event of req.body) {
  const email = event.data.object;
  if (event.type === 'email.bounced') markBounced(email.to, email.id);
  if (event.type === 'email.complained') unsubscribe(email.to);
}

Migrar as supressões

O Mailjet não tem uma lista de supressão única, então reúna os endereços de vários lugares:

  1. Reúna os endereços que o Mailjet bloqueia:

    Mailjet Como exportar Tipo no Emailit
    Lista de exclusão O download da lista de exclusão no painel, ou GET /v3/REST/contact?IsExcludedFromCampaigns=true unsubscribe, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais, como a lista de exclusão do Mailjet
    Quem reclamou de spam Contatos com IsSpamComplaining definido, de GET /v3/REST/contact recipient
    Hard bounces Os eventos bounce que os seus webhooks armazenaram, ou os seus relatórios de campanha recipient
  2. Monte um único CSV com as colunas email,type,reason:

    CSV
    email,type,reason
    excluded@example.com,unsubscribe,mailjet exclusion list
    angry@example.com,recipient,mailjet spam complaint

    O tipo recipient bloqueia envios pela API, por SMTP e de campanhas.

  3. Em Email APISuppressions, selecione Import e envie o arquivo. Cada arquivo pode ter até 10.000 linhas e no máximo 8 MB. Os duplicados são ignorados.

Se você usava várias chaves de API do Mailjet, repita isso para cada uma. Consulte Gerenciar supressões.

Migrar os contatos

Exporte cada lista de contatos em Contacts no Mailjet, ou com GET /v3/REST/listrecipient?ContactsList={id}, que inclui o indicador IsUnsubscribed de cada membro. As propriedades de contato vêm de GET /v3/REST/contactdata.

  1. Prepare o Emailit. Crie um campo personalizado para cada propriedade de contato que você usa e uma lista de contatos para cada lista.

  2. Importe os membros inscritos. Em Email MarketingContacts, selecione Import, mapeie as colunas e escolha a lista de contatos correspondente. Divida os arquivos em partes de até 2.500 linhas. Consulte Importar e exportar contatos.

  3. Suprima os demais. A importação adiciona todas as pessoas do arquivo como inscritas, então deixe os membros descadastrados fora do arquivo. Em vez disso, adicione-os ao seu arquivo de supressões com o tipo unsubscribe e deixe de fora os contatos cujo opt-in ainda está pendente. Uma supressão unsubscribe bloqueia todas as campanhas, então não a adicione para pessoas que ainda estão inscritas em outra lista que você está migrando.

Recrie as suas campanhas e automações em Email MarketingCampaigns e Automations, a partir dos templates importados.

Migrar os templates

Obtenha o HTML de cada template com GET /v3/REST/template/{id}/detailcontent, que retorna Html-part e Text-part, ou copie-o do editor do Mailjet. Importe-o em Email MarketingTemplates ou crie-o com a API de templates e dê a ele um alias, como receipt.

Converta a linguagem de templates do Mailjet para o Temple:

Mailjet Emailit (Temple)
{{var:name}}, {{var:order.total}} {{name}}, {{order.total}}
{{var:name:"there"}} {{name|"there"}}
{{data:firstname}} (uma propriedade de contato) {{first_name}} ou {{cf.<key>}} nas campanhas. Nos envios pela API, passe o valor em variables.
{% if var:plan %}…{% else %}…{% endif %} {{#if plan}}…{{else}}…{{/if}}
{% if var:plan == "pro" %}, {% elseif %} Não suportado. Passe um booleano como is_pro e use {{#if is_pro}}.
{% for item in var:items %}…{% endfor %} Não suportado. Renderize a lista no seu código e passe-a como uma única variável.
Funções como Upper() ou FormatNumber() Não suportado. Formate o valor no seu código.
{{mj:unsub_link}} {{unsubscribe_url}} nas campanhas
Variables variables

O Temple nunca escapa HTML, então escape o que vier dos usuários antes de passar. Consulte Temple e Importar e exportar templates.

Alterar o DNS

Adicione o seu domínio em Email APIDomains e publique os registros do Emailit. Eles usam nomes próprios (emailit._domainkey, emailit.<domain> e, opcionalmente, go e inbound), então não entram em conflito com o registro DKIM mailjet._domainkey do Mailjet nem com o registro TXT de propriedade dele. Mantenha o seu registro DMARC. Consulte Registros DNS.

Se o seu host de rastreamento personalizado no Mailjet já for go, escolha outro nome para o do Emailit com tracking_key. Consulte Domínio de rastreamento personalizado.

Depois da virada, remova os registros DKIM, de propriedade, de rastreamento e de return path do Mailjet e o include:spf.mailjet.com do seu registro SPF. Se você recebe e-mails com a Parse API no seu próprio domínio, mude antes para um subdomínio de recebimento do Emailit.

Próximos passos

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.