Pular para o conteúdo
Docs

Guia

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.

Atualizado em 23 de out. de 2026

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:

Antes: Brevo
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>"
  }'
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>"
  }'
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 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 message-id, e data.object.to em vez de email. Os seus valores de meta, que substituem tags e X-Mailin-custom, 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.
  • A Brevo não assina os webhooks; você os protege com credenciais ou um token. O Emailit assina cada requisição: verifique X-Emailit-Signature com X-Emailit-Timestamp e o seu segredo whsec_. 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

A Brevo mantém duas listas de bloqueio. Traga as duas:

  1. 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 tipo recipient para todos eles. A Brevo bloqueia um endereço para um remetente, e o Emailit o bloqueia para o workspace inteiro.

  2. 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 tipo recipient para hard bounces e reclamações de spam, e unsubscribe para descadastros. O tipo unsubscribe bloqueia 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.

  3. Monte um único CSV com as colunas email,type,reason:

    CSV
    email,type,reason
    old-address@example.com,recipient,brevo hard bounce
    left@example.com,unsubscribe,brevo unsubscribed
  4. 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

  1. Crie os campos personalizados. Para cada atributo de contato da Brevo que você usa, exceto EMAIL, FIRSTNAME e LASTNAME, crie um campo personalizado no Emailit. As chaves ficam em minúsculas, então COMPANY vira company.

  2. Crie as listas de contatos, uma para cada lista da Brevo para a qual você envia campanhas.

  3. 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.

  4. Importe a lista. Em Email MarketingContacts, selecione Import, mapeie EMAIL, FIRSTNAME, LASTNAME e 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

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.