# 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](/pt/docs/migrate/) para conhecer a ordem geral e saber como usar os dois provedores em paralelo.

## Conceitos

| Brevo | Emailit |
| --- | --- |
| Conta e sub-accounts | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Chaves de API | [Chaves de API](/pt/docs/developers/api-keys/): **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](/pt/docs/domains/). 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](/pt/docs/workspaces/production-access/) e só entregam para membros do workspace. |
| Templates e a linguagem de templates da Brevo | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Webhooks transacionais, de marketing e de recebimento | [Webhooks](/pt/docs/webhooks/) |
| Inbound parsing | [Recebimento de e-mails](/pt/docs/inbound/) |
| Contatos bloqueados (transacional) e contatos na lista de bloqueio (campanhas) | [Supressões](/pt/docs/suppressions/) |
| Contatos, atributos e listas | [Contatos](/pt/docs/contacts/), [campos personalizados](/pt/docs/contacts/custom-fields/) e [listas de contatos](/pt/docs/audiences/) |
| Segmentos | Escolha listas de contatos e deixe outras de fora em cada campanha. Os [segmentos](/pt/docs/segments/) estão em alfa e disponíveis apenas para a equipe do Emailit. |
| Campanhas de e-mail | [Campanhas](/pt/docs/campaigns/) |
| Automações | [Automações](/pt/docs/automations/) (beta) |
| Formulários | [Formulários](/pt/docs/forms/) (acesso antecipado), ou a [URL de inscrição](/pt/docs/audiences/subscribe-url/) de uma lista de contatos |
| `tags` e o cabeçalho `X-Mailin-custom` | `meta` |
| IPs dedicados | [IPs dedicados](/pt/docs/deliverability/dedicated-ips/) 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:

```bash title="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>"
  }'
```

```bash title="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 "` |
| `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](/pt/docs/email-api/send-email/).

## 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](/pt/docs/smtp/settings/).

## 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}`](/pt/docs/api-reference/emails/get/) |

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](/pt/docs/webhooks/request-signature/).

```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 API → Suppressions**, 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](/pt/docs/suppressions/manage/).

## 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](/pt/docs/contacts/custom-fields/) 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 Marketing → Contacts**, 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](/pt/docs/contacts/import-export/).

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 Marketing → Templates** ou crie-o com a [API de templates](/pt/docs/api-reference/templates/create/) 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](/pt/docs/templates/temple/) e [Tags de mesclagem](/pt/docs/campaigns/merge-tags/).

## Recriar as campanhas e as automações

Crie as suas campanhas em **Email Marketing → Campaigns** a partir dos templates importados. Recrie cada automação da Brevo como uma [automação](/pt/docs/automations/) 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](/pt/docs/forms/) (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 API → Domains** 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](/pt/docs/domains/dns-records/).

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](/pt/docs/inbound/set-up/) do Emailit.

## Próximos passos

- [Checklist para entrar em produção](/pt/docs/get-started/go-live/)
- [Criar uma campanha](/pt/docs/campaigns/create/)
- [Migração prioritária](/pt/docs/programs/priority-migration/): deixe os engenheiros do Emailit fazerem a migração com você

---
Fonte: https://emailit.com/pt/docs/migrate/brevo/
