Guia
Migrar do Mailjet
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.
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:
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>"
}]
}'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
eventparatype, e o e-mail fica emdata.object. Usedata.object.id, o IDem_da resposta do envio, em vez deMessageIDouMessage_GUID, edata.object.toem vez deemail. Os seus valores demeta, que substituemCustomIDePayload, ficam emdata.object.meta. - Em
email.loadedeemail.clicked,data.objecté o carregamento ou o clique. Usedata.object.email_idpara obter o ID do e-mail, edata.object.email.rcpt_toedata.object.email.metapara obter o destinatário e os seus valores demeta. - O Mailjet não assina as requisições dele. O Emailit assina todas: verifique
X-Emailit-SignaturecomX-Emailit-Timestampe o seu segredowhsec_e, se quiser, retire as credenciais de autenticação básica da sua URL. Consulte Assinatura das requisições.
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:
-
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=trueunsubscribe, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais, como a lista de exclusão do MailjetQuem reclamou de spam Contatos com IsSpamComplainingdefinido, deGET /v3/REST/contactrecipientHard bounces Os eventos bounceque os seus webhooks armazenaram, ou os seus relatórios de campanharecipient -
Monte um único CSV com as colunas
email,type,reason:email,type,reason excluded@example.com,unsubscribe,mailjet exclusion list angry@example.com,recipient,mailjet spam complaintO tipo
recipientbloqueia envios pela API, por SMTP e de campanhas. -
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.
-
Prepare o Emailit. Crie um campo personalizado para cada propriedade de contato que você usa e uma lista de contatos para cada lista.
-
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.
-
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
unsubscribee deixe de fora os contatos cujo opt-in ainda está pendente. Uma supressãounsubscribebloqueia 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
- Checklist para entrar em produção
- Configurar webhooks
- Migração prioritária: deixe os engenheiros do Emailit fazerem a migração com você