# Migrar do MailerSend

> Migre do MailerSend para o Emailit. Faça a correspondência de domínios, tokens e usuários SMTP, converta as chamadas à API e a personalização, troque o SMTP e migre webhooks, supressões e templates.

Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks, as supressões e os templates do MailerSend e os equivalentes no Emailit. Leia antes [Migrar para o Emailit](/pt/docs/migrate/) para conhecer a ordem geral e saber como usar os dois provedores em paralelo.

## Conceitos

| MailerSend | Emailit |
| --- | --- |
| Conta | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Domínios | [Domínios de envio](/pt/docs/domains/) |
| Sender identities | Não disponível. Todo endereço From deve estar em um domínio verificado. |
| Tokens de API com escopos | [Chaves de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Usuários SMTP | A sua chave de API, usada como senha do SMTP |
| Domínio de teste e modo sandbox | Não há domínio de teste compartilhado. Os workspaces novos ficam no [modo sandbox](/pt/docs/workspaces/production-access/) e só podem enviar para membros do workspace. |
| Templates | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Webhooks por domínio | [Webhooks](/pt/docs/webhooks/) por workspace |
| Inbound routes | [Recebimento de e-mails](/pt/docs/inbound/), com o webhook `email.received` ou a [automação](/pt/docs/inbound/forward-with-automations/) **Forward received email** |
| Supressões por domínio: hard bounces, reclamações de spam, descadastros, lista de bloqueio | Uma [lista de supressão](/pt/docs/suppressions/) por workspace |
| Lista on hold | Não é necessária. O Emailit faz novas tentativas para os soft bounces e informa cada tentativa como `email.attempted`. |
| Activity | **Email API → Emails** e **Email API → Logs** |
| Tags | `meta` |
| Verificação de e-mails | [Verificação de e-mails](/pt/docs/email-verification/) |
| IPs dedicados | [IPs dedicados](/pt/docs/deliverability/dedicated-ips/) sob solicitação |

## Atualizar as chamadas à API

O `POST /v1/email` do MailerSend passa a ser `POST /v2/emails`. Os dois recebem um bearer token e JSON, mas no Emailit os endereços são strings simples em vez de objetos:

```bash title="Antes: MailerSend"
curl https://api.mailersend.com/v1/email \
  -H "Authorization: Bearer $MAILERSEND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<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>"
  }'
```

| MailerSend | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` | `Authorization: Bearer secret_…` |
| `from: { email, name }` | `from: "Name "` |
| `to[]`, `cc[]`, `bcc[]` com `email` e `name` | `to`, `cc`, `bcc` como string ou array de até 50 cada |
| `reply_to: { email, name }` | `reply_to` |
| `subject`, `text`, `html` | Iguais |
| `headers: [{ "name": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `list_unsubscribe` | `headers` com `List-Unsubscribe` e `List-Unsubscribe-Post`. Consulte [Cabeçalhos e metadados](/pt/docs/email-api/headers-and-metadata/). |
| `attachments[]` com `content`, `filename`, `disposition` e `id` | `attachments[]` com `content`, `filename` e `content_type`, ou uma `url` no lugar de `content`. Use `content_id` para imagens inline. |
| `template_id` | `template`, um ID ou alias de template |
| `personalization: [{ "email": "…", "data": { … } }]` | `variables`, com uma requisição por destinatário quando os valores forem diferentes |
| `tags` | `meta`, devolvido nos eventos de webhook |
| `send_at` (horário Unix ou ISO 8601) | `scheduled_at` (ISO 8601 ou inglês simples). Converta os horários Unix para ISO 8601 antes. |
| `settings.track_opens`, `settings.track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `POST /v1/bulk-email` | Não disponível. Envie uma requisição por mensagem. |
| `202 Accepted` com um cabeçalho `x-message-id` e um corpo vazio | `200` com um corpo JSON: `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um |

Cada destinatário de uma requisição do Emailit vira um e-mail próprio, com o seu próprio ID. O MailerSend responde `202` mesmo quando todos os destinatários estão suprimidos, com um aviso no corpo. O Emailit também aceita destinatários com uma supressão `recipient` e dá a cada um o status `suppressed`. Adicione um cabeçalho `Idempotency-Key` para que as novas tentativas sejam seguras. Consulte [Enviar um e-mail](/pt/docs/email-api/send-email/).

## Mudar as configurações SMTP

| Configuração | MailerSend | Emailit |
| --- | --- | --- |
| Host | `smtp.mailersend.net` | `smtp.emailit.com` |
| Porta | `587` (STARTTLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | O nome de usuário gerado para o usuário SMTP | `emailit` |
| Senha | A senha do usuário SMTP | A sua chave de API do Emailit |

O Emailit não lê o cabeçalho `X-MailerSend-Tags`. Remova-o. Ao contrário do MailerSend, o Emailit entrega os seus outros cabeçalhos personalizados sem alterações. Consulte [Configurações SMTP](/pt/docs/smtp/settings/).

## Correspondência dos eventos de webhook

| Evento do MailerSend | Evento do Emailit |
| --- | --- |
| `activity.sent` | `email.accepted` (somente API) |
| `activity.delivered` | `email.delivered` |
| `activity.deferred` | `email.attempted` |
| `activity.soft_bounced` | `email.attempted` enquanto o Emailit faz novas tentativas, e depois `email.bounced` se todas as novas tentativas falharem |
| `activity.hard_bounced` | `email.bounced` |
| `activity.suppressed` | `email.suppressed` |
| `activity.opened`, `activity.opened_unique` | `email.loaded`, enviado a cada carregamento |
| `activity.clicked`, `activity.clicked_unique` | `email.clicked`, enviado a cada clique |
| `activity.spam_complaint` | `email.complained` |
| `activity.unsubscribed` | `email.unsubscribed`, somente para e-mails de campanha |
| Inbound route que encaminha para um webhook | `email.received`; depois, busque o conteúdo com [`GET /emails/{id}`](/pt/docs/api-reference/emails/get/) |

O formato da requisição muda:

- O MailerSend envia um evento por requisição. O Emailit envia um array JSON de até 100 eventos, então percorra o corpo em um loop.
- Nos dois, o nome do evento fica em `type`. No Emailit, o e-mail fica em `data.object`: use `data.object.id`, o ID `em_` da resposta do envio, em vez de `data.message_id` (`data.email.message.id` nos webhooks da versão 1), e `data.object.to` em vez de `data.recipient`. Os seus valores de `meta` 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 cabeçalho `Signature` do MailerSend é um HMAC-SHA256 do corpo bruto. O `X-Emailit-Signature` do Emailit é um HMAC-SHA256 de `<timestamp>.<raw body>`, com o seu segredo `whsec_` como chave, então leia também `X-Emailit-Timestamp`. 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

1. No MailerSend, exporte as listas **Hard bounces**, **Spam complaints**, **Unsubscribes** e **Blocklist** de cada domínio, pelas páginas de supressão ou pela API (`/v1/suppressions/hard-bounces`, `/spam-complaints`, `/unsubscribes` e `/blocklist`). A lista on hold é temporária, então você pode deixá-la de fora.

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

```csv
email,type,reason
old-address@example.com,recipient,mailersend hard bounce
angry@example.com,recipient,mailersend spam complaint
```

   Use o tipo `recipient` para endereços que nunca devem receber e-mails. Ele bloqueia envios pela API, por SMTP e de campanhas. Para pessoas que só se descadastraram dos e-mails de marketing, use o tipo `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais.

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

O Emailit tem uma lista de supressão por workspace, então os endereços de todos os seus domínios do MailerSend vão para a mesma lista. As supressões são endereços exatos: padrões da lista de bloqueio como `.*@example.com` não têm equivalente. Consulte [Gerenciar supressões](/pt/docs/suppressions/manage/).

## Migrar os templates

Copie o HTML de cada template do editor do MailerSend e depois importe-o em **Email Marketing → Templates** ou crie-o com a [API de templates](/pt/docs/api-reference/templates/create/). Dê a ele um alias, como `receipt`, e envie-o com `"template": "receipt"` e `variables`.

A personalização do MailerSend é uma versão limitada do Twig. O Temple cobre as partes mais comuns:

| MailerSend | Emailit (Temple) |
| --- | --- |
| `{{ name }}`, `{{ user.name }}` | `{{name}}`, `{{user.name}}` |
| `{{ name\|default('there') }}` | `{{name\|"there"}}` |
| `{% if plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if plan == "pro" %}`, `{% elseif %}` | Não suportado. Passe um booleano como `is_pro` e use `{{#if is_pro}}`. |
| `{% for item in items %}…{% endfor %}` | Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
| `{{ name\|upper }}` e outros filtros | Não suportado. Formate o valor no seu código. |
| `personalization[].data` | `variables` |

O MailerSend remove a maior parte do HTML dos valores de personalização. O Temple nunca escapa nem remove HTML, então escape o que vier dos usuários antes de passar. Consulte [Temple](/pt/docs/templates/temple/) e [Importar e exportar templates](/pt/docs/templates/import-export/).

## 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 os registros DKIM `ms1._domainkey` e `ms2._domainkey` do MailerSend, com o CNAME de return path `mta` dele nem com o CNAME de rastreamento `email` dele. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

O roteamento de recebimento do MailerSend também usa um subdomínio `inbound` por padrão. Se o seu usar, dê outro subdomínio ao recebimento do Emailit com `inbound_key`, ou troque o registro MX quando migrar os e-mails recebidos. Consulte [Configurar o recebimento de e-mails](/pt/docs/inbound/set-up/).

Depois da virada, remova os registros DKIM, de return path e de rastreamento do MailerSend e remova `include:_spf.mailersend.net` do seu registro SPF.

## Próximos passos

- [Checklist para entrar em produção](/pt/docs/get-started/go-live/)
- [Configurar webhooks](/pt/docs/webhooks/set-up/)
- [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/mailersend/
