# Migrar do Mandrill

> Migre do Mandrill (Mailchimp Transactional) para o Emailit. Faça a correspondência de chaves de API e subaccounts, converta as chamadas a messages/send, troque o SMTP e os cabeçalhos X-MC, verifique os webhooks e migre os rejects.

Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks, a rejection denylist e os templates do Mandrill (Mailchimp Transactional Email) 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. Se você também envia campanhas pelo Mailchimp, consulte [Migrar do Mailchimp](/pt/docs/migrate/mailchimp/).

## Conceitos

| Mandrill | Emailit |
| --- | --- |
| Um plano Standard ou Premium do Mailchimp com blocos transacionais | Uma conta do Emailit. Você não precisa de um plano de marketing para enviar e-mails transacionais. |
| Subaccounts | [Workspaces](/pt/docs/workspaces/), cada um com os seus próprios domínios, chaves, limites e créditos |
| API keys | [Chaves de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Test API keys | Não há modo de teste. Os workspaces novos ficam no [modo sandbox](/pt/docs/workspaces/production-access/) e só podem enviar para membros do workspace. |
| Sending domains e verificação DKIM/SPF | [Domínios de envio](/pt/docs/domains/) |
| Tracking domains | [Subdomínio de rastreamento](/pt/docs/tracking/), como `go.acme.com` |
| Templates com regiões `mc:edit` | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Webhooks | [Webhooks](/pt/docs/webhooks/) |
| Inbound domains e routes | [Recebimento de e-mails](/pt/docs/inbound/) |
| Rejection denylist | [Supressões](/pt/docs/suppressions/) |
| Rejection allowlist | Não disponível |
| Merge languages: Mailchimp e Handlebars | [Temple](/pt/docs/templates/temple/) |
| Tags e metadata | `meta` |
| Outbound activity | **Email API → Emails** e **Email API → Logs** |
| IPs dedicados e IP pools | [IPs dedicados](/pt/docs/deliverability/dedicated-ips/) sob solicitação |

## Atualizar as chamadas à API

O `POST /messages/send` do Mandrill recebe a chave de API no corpo JSON e aninha o e-mail em `message`. O `POST /v2/emails` do Emailit recebe um bearer token e um corpo sem aninhamento:

```bash title="Antes: Mandrill"
curl https://mandrillapp.com/api/1.0/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "key": "'"$MANDRILL_API_KEY"'",
    "message": {
      "from_email": "hello@acme.com",
      "from_name": "Acme",
      "to": [{ "email": "ada@example.com", "type": "to" }],
      "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>"
  }'
```

| Mandrill | Emailit |
| --- | --- |
| `key` no corpo da requisição | Cabeçalho `Authorization: Bearer secret_…` |
| `message.from_email` e `from_name` | `from: "Name "` |
| `message.to[]` com `type` `to`, `cc` ou `bcc` | `to`, `cc`, `bcc`, até 50 cada |
| `message.headers["Reply-To"]` | `reply_to` |
| `message.subject`, `html`, `text` | `subject`, `html`, `text` |
| `message.headers` | `headers` |
| `message.attachments[]` com `type`, `name`, `content` | `attachments[]` com `content_type`, `filename`, `content` |
| `message.images[]` para imagens inline | `attachments[]` com um `content_id`, referenciado como `cid:` no HTML |
| `message.metadata`, `message.tags` | `meta`, um objeto com valores em string, devolvido nos eventos de webhook |
| `message.track_opens`, `track_clicks` | `tracking: { "loads": true, "clicks": true }` |
| `message.global_merge_vars` | `variables` |
| `message.merge_vars` (por destinatário) | Uma requisição por destinatário, cada uma com as suas `variables` |
| `message.subaccount` | Use uma chave de API do workspace correspondente |
| `send_at` | `scheduled_at` (ISO 8601 ou inglês simples) |
| `async` | Não é necessário. O Emailit coloca todos os e-mails na fila de entrega e responde sem esperar pela entrega. |
| `POST /messages/send-template` com `template_name` | O mesmo `POST /v2/emails` com `template` (um alias ou ID) e `variables` |
| Resposta: um array com `email`, `status` e `_id` para cada destinatário | `200` com `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um |

O Mandrill informa os problemas por destinatário na resposta, com status como `rejected` ou `invalid`. O Emailit valida a requisição inteira e retorna um erro HTTP para dados inválidos. Os destinatários com uma supressão `recipient` são aceitos e depois recebem 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 | Mandrill | Emailit |
| --- | --- | --- |
| Host | `smtp.mandrillapp.com` | `smtp.emailit.com` |
| Porta | `587`, `2525` ou `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | Qualquer valor | `emailit` |
| Senha | Uma chave de API do Mandrill | A sua chave de API do Emailit |

O Emailit não lê cabeçalhos `X-MC-*`, como `X-MC-Template`, `X-MC-MergeVars`, `X-MC-Tags`, `X-MC-Metadata` ou `X-MC-Track`. Remova-os. Configure o rastreamento no domínio e use a API quando precisar de templates ou metadados. Consulte [Configurações SMTP](/pt/docs/smtp/settings/).

## Correspondência dos eventos de webhook

| Evento do Mandrill | Evento do Emailit |
| --- | --- |
| `send` | `email.accepted` (somente API) |
| `delivered` | `email.delivered` |
| `deferral` | `email.attempted` |
| `hard_bounce` | `email.bounced` |
| `soft_bounce` | `email.attempted` enquanto o Emailit faz novas tentativas, e depois `email.bounced` se todas as novas tentativas falharem |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `spam` | `email.complained` |
| `unsub` | `email.unsubscribed`, somente para e-mails de campanha |
| `reject` | `email.suppressed`, quando o endereço tem uma supressão `recipient`. Outros motivos de rejeição, como `unsigned`, são erros da API no Emailit. |
| Eventos de sincronização da rejection denylist | `suppression.created`, `suppression.deleted`, para as supressões que você adiciona ou remove |
| `inbound` | `email.received`; depois, busque o conteúdo com [`GET /emails/{id}`](/pt/docs/api-reference/emails/get/) |

O formato da requisição muda:

- O Mandrill envia um campo de formulário, `mandrill_events`, que contém um array JSON de até 1.000 eventos. O Emailit envia o array JSON como corpo da requisição, com até 100 eventos.
- O nome do evento fica em `type`, e o e-mail fica em `data.object`. Use `data.object.id`, o ID `em_` da resposta do envio, em vez de `_id`, e `data.object.to` em vez de `msg.email`. 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 Mandrill assina a URL e os campos do formulário com HMAC-SHA1, codificado em base64, em `X-Mandrill-Signature`. O Emailit assina `<timestamp>.<raw body>` com HMAC-SHA256: 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

1. Exporte a rejection denylist inteira com **Export Full Denylist** na página **Rejection Denylist** do Mandrill, ou com a chamada de API `/exports/rejects`. A `/rejects/list` retorna no máximo 1.000 entradas, então não a use para isso. A exportação é um arquivo ZIP com `rejects.csv` e abrange todas as subaccounts.

2. Monte um único CSV com as colunas `email,type,reason`. Ignore as entradas que já expiraram e use a coluna `reason` para escolher o tipo:

   | Motivo no Mandrill | Tipo no Emailit |
   | --- | --- |
   | `hard-bounce`, `spam`, `custom` | `recipient` |
   | `unsub` | `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais. Use `recipient` para bloquear todos os e-mails, como o Mandrill fazia. |
   | `soft-bounce` | Deixe de fora. Essas entradas expiram depois de um dia. |

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

   O tipo `recipient` bloqueia envios pela API, por SMTP e de campanhas. Se você usava subaccounts, divida o arquivo pela coluna de subaccount e importe cada parte no workspace correspondente.

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.

A rejection allowlist do Mandrill não tem equivalente. Consulte [Gerenciar supressões](/pt/docs/suppressions/manage/).

## Migrar os templates

Obtenha o código dos seus templates no Mandrill: uma única chamada a `/templates/list` retorna todos os templates, cada um com o `slug` e o HTML publicado em `publish_code`. Depois, importe cada um em **Email Marketing → Templates** ou crie-o com a [API de templates](/pt/docs/api-reference/templates/create/). Use o slug do Mandrill como alias, se ele se encaixar no formato de alias: letras minúsculas, números, `-` e `_`.

Nos templates que usavam regiões `mc:edit` preenchidas por `template_content`, essas regiões precisam virar variáveis. Os nomes das variáveis de mesclagem do Mandrill não diferenciam maiúsculas de minúsculas, mas os do Temple diferenciam: `{{FNAME}}` só corresponde a uma variável chamada `FNAME`. Converta as tags de mesclagem para o Temple:

| Mandrill | Emailit (Temple) |
| --- | --- |
| `*\|FNAME\|*` (linguagem de mesclagem do Mailchimp) | `{{FNAME}}`, ou renomeie para `{{first_name}}` |
| `{{fname}}` (linguagem de mesclagem Handlebars) | `{{fname}}` |
| `*\|IF:FNAME\|*…*\|ELSE:\|*…*\|END:IF\|*` | `{{#if FNAME}}…{{else}}…{{/if}}` |
| `*\|IF:PLAN=pro\|*`, ou uma comparação dentro de um `{{#if}}` do Handlebars | Não suportado. Passe um booleano como `is_pro` e use `{{#if is_pro}}`. |
| `*\|DATE:d/m/y\|*`, `*\|CURRENT_YEAR\|*`, helpers como `{{upper name}}` | Não suportado. Formate o valor no seu código e passe-o. |
| `*\|UNSUB:https://…\|*`, `{{unsub "…"}}` | O seu próprio link de descadastro. Consulte [Descadastros](/pt/docs/audiences/unsubscribes/#transactional-email-and-unsubscribes). |
| `{{#if plan}}…{{else}}…{{/if}}` | Igual |
| `{{#each items}}…{{/each}}` | Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
| `…` com `template_content` | `{{body}}`, passado em `variables` |
| `global_merge_vars` | `variables` |

O Temple nunca escapa HTML, então escape o que vier dos usuários antes de passar. Um valor ausente é renderizado como string vazia, a menos que você adicione um valor padrão, como `{{name|"there"}}`. Consulte [Temple](/pt/docs/templates/temple/).

## 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 CNAMEs `mte1._domainkey` e `mte2._domainkey` do Mandrill nem com o registro TXT `mandrill_verify` dele. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

Depois da virada, remova os registros DKIM e de verificação do Mandrill, os CNAMEs personalizados de rastreamento ou de return path que houver e `include:spf.mandrillapp.com`, se o seu registro SPF tiver essa entrada. Se você recebe e-mails com as inbound routes do Mandrill, 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/)
- [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/mandrill/
