Guia
Migrar da Brevo
Migre da Brevo (antiga Sendinblue) para o Emailit. Converta as chamadas à API smtp/email e a linguagem de templates, troque as chaves SMTP e migre webhooks, listas de bloqueio, contatos, campanhas e automações.
Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks, as listas de bloqueio, os templates, os contatos e as automações da Brevo e os equivalentes no Emailit. A Brevo se chamava Sendinblue até 2023, e alguns dos hosts e cabeçalhos dela ainda usam esse nome. Leia antes Migrar para o Emailit para conhecer a ordem geral e saber como usar os dois provedores em paralelo.
Conceitos
| Brevo | Emailit |
|---|---|
| Conta e sub-accounts | Conta e workspaces. Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Chaves de API | Chaves de API: Full Access, ou Sending Only, que pode ser restrita a um domínio |
| Login SMTP e chaves SMTP | A sua chave de API, usada como senha do SMTP |
| Remetentes, verificados um a um ou por meio de um domínio autenticado | Domínios de envio. Remetentes de um único endereço não estão disponíveis. |
Cabeçalho X-Sib-Sandbox |
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 da Brevo | Templates com alias e versões, renderizados com o Temple |
| Webhooks transacionais, de marketing e de recebimento | Webhooks |
| Inbound parsing | Recebimento de e-mails |
| Contatos bloqueados (transacional) e contatos na lista de bloqueio (campanhas) | Supressões |
| Contatos, atributos e listas | Contatos, campos personalizados e listas de contatos |
| 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 de e-mail | Campanhas |
| Automações | Automações (beta) |
| Formulários | Formulários (acesso antecipado), ou a URL de inscrição de uma lista de contatos |
tags e o cabeçalho X-Mailin-custom |
meta |
| IPs dedicados | IPs dedicados sob solicitação |
Atualizar as chamadas à API
O POST /v3/smtp/email da Brevo passa a ser POST /v2/emails. A chave sai do cabeçalho api-key e vai para Authorization, e os nomes dos campos ficam mais curtos:
curl https://api.brevo.com/v3/smtp/email \
-H "api-key: $BREVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sender": { "email": "hello@acme.com", "name": "Acme" },
"to": [{ "email": "ada@example.com" }],
"subject": "Your receipt",
"textContent": "Thanks for your order.",
"htmlContent": "<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>"
}'| Brevo | Emailit |
|---|---|
Cabeçalho api-key: xkeysib-… |
Authorization: Bearer secret_… |
sender: { email, name } ou sender: { id } |
from: "Name <email>" |
to, cc, bcc com email e name |
to, cc, bcc como string ou array de até 50 cada |
replyTo: { email, name } |
reply_to |
subject, htmlContent, textContent |
subject, html, text |
headers |
headers |
attachment[] com content e name, ou url |
attachments[] com content, filename e content_type, ou url |
templateId e params |
template (um alias ou ID) e variables |
tags, headers["X-Mailin-custom"] |
meta, devolvido nos eventos de webhook |
scheduledAt (até 72 horas de antecedência) |
scheduled_at (ISO 8601 ou inglês simples) |
headers.idempotencyKey (mantido por 30 minutos) |
Um cabeçalho HTTP Idempotency-Key, mantido por 24 horas |
messageVersions[] |
Não disponível. Envie uma requisição por destinatário, cada uma com as suas variables. |
headers["X-Sib-Sandbox"] |
Não disponível |
201 com messageId |
200 com id (em_…), status: "accepted" e, para vários destinatários, ids, com um ID para cada um |
A Brevo não tem configuração de rastreamento por e-mail. No Emailit, tracking: { "loads": true, "clicks": true } substitui o rastreamento do domínio em um e-mail. Consulte Enviar um e-mail.
Mudar as configurações SMTP
| Configuração | Brevo | Emailit |
|---|---|---|
| Host | smtp-relay.brevo.com |
smtp.emailit.com |
| Porta | 587 ou 2525 (STARTTLS), 465 (TLS) |
587, 2587, 2525 ou 25 (STARTTLS), 465 (TLS) |
| Usuário | O seu login SMTP, como …@smtp-brevo.com, ou o e-mail da sua conta |
emailit |
| Senha | Uma chave SMTP | A sua chave de API do Emailit |
O Emailit não lê os cabeçalhos da Brevo, como X-Mailin-custom ou X-Mailin-Tag. Remova-os e use a API quando precisar de metadados. Consulte Configurações SMTP.
Correspondência dos eventos de webhook
| Evento da Brevo | Evento do Emailit |
|---|---|
request (enviado) |
email.accepted (somente API) |
delivered |
email.delivered |
deferred |
email.attempted |
soft_bounce |
email.attempted enquanto o Emailit faz novas tentativas, e depois email.bounced se todas as novas tentativas falharem |
hard_bounce |
email.bounced |
invalid_email |
Um erro na resposta da API para um endereço malformado, ou email.bounced se o endereço não existir |
blocked |
email.suppressed |
error |
email.failed |
spam |
email.complained |
opened, unique_opened, proxy_open |
email.loaded, enviado a cada carregamento |
click |
email.clicked |
unsubscribed, unsubscribe |
email.unsubscribed, somente para e-mails de campanha |
list_addition |
subscriber.created |
contact_updated, contact_deleted |
contact.updated, contact.deleted |
inboundEmailProcessed |
email.received; depois, busque o conteúdo com GET /emails/{id} |
O formato da requisição muda:
- A Brevo envia um evento por requisição, ou lotes de até 500 quando o envio em lotes está ativado. O Emailit 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 demessage-id, edata.object.toem vez deemail. Os seus valores demeta, que substituemtagseX-Mailin-custom, 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. - A Brevo não assina os webhooks; você os protege com credenciais ou um token. O Emailit assina cada requisição: verifique
X-Emailit-SignaturecomX-Emailit-Timestampe o seu segredowhsec_. 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
A Brevo mantém duas listas de bloqueio. Traga as duas:
-
Contatos bloqueados nos e-mails transacionais. Exporte-os em Settings > Transactional emails > Blocked or Unsubscribed contacts, ou percorra as páginas de
GET /v3/smtp/blockedContacts. Use o tiporecipientpara todos eles. A Brevo bloqueia um endereço para um remetente, e o Emailit o bloqueia para o workspace inteiro. -
Contatos de campanhas na lista de bloqueio. Em CRM > Contacts, filtre as inscrições em campanhas de e-mail por Blocklisted e exporte, ou use
POST /v3/contacts/export. Use o tiporecipientpara hard bounces e reclamações de spam, eunsubscribepara descadastros. O tipounsubscribebloqueia todas as campanhas, mas ainda deixa passar os e-mails transacionais, então não o adicione para pessoas que só saíram de uma lista e continuam inscritas em outra. -
Monte um único CSV com as colunas
email,type,reason:email,type,reason old-address@example.com,recipient,brevo hard bounce left@example.com,unsubscribe,brevo unsubscribed -
Importe o arquivo. 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.
Os domínios bloqueados não têm equivalente, porque o Emailit suprime endereços exatos. Consulte Gerenciar supressões.
Migrar os contatos
-
Crie os campos personalizados. Para cada atributo de contato da Brevo que você usa, exceto
EMAIL,FIRSTNAMEeLASTNAME, crie um campo personalizado no Emailit. As chaves ficam em minúsculas, entãoCOMPANYviracompany. -
Crie as listas de contatos, uma para cada lista da Brevo para a qual você envia campanhas.
-
Exporte cada lista em CRM > Contacts com More actions > Export, incluindo os atributos e o status de inscrição. Deixe de fora os contatos na lista de bloqueio e as pessoas que se descadastraram da lista.
-
Importe a lista. Em Email MarketingContacts, selecione Import, mapeie
EMAIL,FIRSTNAME,LASTNAMEe os seus atributos e escolha a lista de contatos correspondente. Divida os arquivos em partes de até 2.500 linhas. Consulte Importar e exportar contatos.
A importação adiciona todas as pessoas do arquivo como inscritas, então confira se há descadastros no arquivo antes de importá-lo.
Migrar os templates
Obtenha o HTML de cada template com GET /v3/smtp/templates/{templateId} para templates transacionais, ou com GET /v3/emailCampaigns/{campaignId} para campanhas. Os dois o retornam em htmlContent. 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 da Brevo para o Temple:
| Brevo | Emailit (Temple) |
|---|---|
{{ params.name }}, {{ params.order.total }} |
{{name}}, {{order.total}} |
{{ contact.FIRSTNAME }}, {{ contact.LASTNAME }} |
{{first_name}}, {{last_name}} nas campanhas |
{{ contact.COMPANY }} |
{{cf.company}} nas campanhas |
{{ params.name|default:"there" }} |
{{name|"there"}} |
{% if params.plan %}…{% else %}…{% endif %} |
{{#if plan}}…{{else}}…{{/if}} |
{% if params.plan == "pro" %}, {% elif %} |
Não suportado. Passe um booleano como is_pro e use {{#if is_pro}}. |
{% for item in params.items %}…{% endfor %} |
Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
Filtros como upper ou date |
Não suportado. Formate o valor no seu código. |
{{ unsubscribe }} |
{{unsubscribe_url}} nas campanhas |
{{ update_profile }} |
{{manage_subscriptions_url}} nas campanhas |
{{ mirror }} |
{{webview_url}} nas campanhas |
A Brevo escapa o HTML, a menos que você adicione safe. O Temple nunca escapa HTML, então escape o que vier dos usuários antes de passar. Consulte Temple e Tags de mesclagem.
Recriar as campanhas e as automações
Crie as suas campanhas em Email MarketingCampaigns a partir dos templates importados. Recrie cada automação da Brevo como uma automação do Emailit no contexto Contact:
| Gatilho da Brevo | Gatilho do Emailit |
|---|---|
| Contato adicionado a uma lista, removido de uma lista | Added to audience, Removed from audience |
| Aniversário, ou um atributo de data | Date anniversary, Date in contact field |
| Formulário enviado | Form submitted, para formulários do Emailit (acesso antecipado) |
| E-mail aberto, link clicado | Email opened, Link clicked |
| Descadastro de uma lista de e-mail | Unsubscribed |
| Evento personalizado | Custom event, nos planos Business e Custom |
Inicie cada automação antes de migrar os seus formulários de inscrição, para que os novos contatos recebam os e-mails desde o primeiro dia.
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 TXT brevo-code da Brevo nem com os registros DKIM dela (brevo1._domainkey e brevo2._domainkey, ou mail._domainkey em configurações mais antigas). Mantenha o seu registro DMARC. Consulte Registros DNS.
Depois da virada, remova os registros de código, de DKIM e do subdomínio de marca da Brevo, além de include:spf.brevo.com ou include:spf.sendinblue.com, se o seu registro SPF tiver um deles. Se você recebe e-mails com o inbound parsing da Brevo, mude antes para um subdomínio de recebimento do Emailit.
Próximos passos
- Checklist para entrar em produção
- Criar uma campanha
- Migração prioritária: deixe os engenheiros do Emailit fazerem a migração com você