# Migrar do Mailtrap

> Migre do Mailtrap Email Sending para o Emailit. Faça a correspondência de streams, tokens e sub-accounts, converta as chamadas à API e os templates Handlebars, troque o SMTP e migre webhooks, supressões e contatos.

Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks, as supressões, os templates e os contatos do Mailtrap Email Sending 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

| Mailtrap | Emailit |
| --- | --- |
| Organização e sub-accounts | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Domínios de envio | [Domínios de envio](/pt/docs/domains/) |
| Transactional stream | A [API de e-mail](/pt/docs/email-api/) e o [SMTP relay](/pt/docs/smtp/) |
| Bulk stream | [Campanhas](/pt/docs/campaigns/), ou a API com os seus próprios cabeçalhos `List-Unsubscribe` |
| Tokens de API com permissões por recurso | [Chaves de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Domínio de demonstração | Os workspaces novos ficam no [modo sandbox](/pt/docs/workspaces/production-access/) e podem enviar para membros do workspace a partir do seu próprio domínio verificado. |
| Email Sandbox (testes) | Não disponível. Mantenha o sandbox do Mailtrap para testes, ou envie para membros do workspace enquanto desenvolve. |
| Templates | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Webhooks por stream | [Webhooks](/pt/docs/webhooks/) por workspace |
| Supressões por domínio e por stream | Uma [lista de supressão](/pt/docs/suppressions/) por workspace |
| Logs de e-mail | **Email API → Emails** e **Email API → Logs** |
| `category` e `custom_variables` | `meta` |
| Email Marketing: contatos, listas, campanhas, automações | [Contatos](/pt/docs/contacts/), [listas de contatos](/pt/docs/audiences/), [campanhas](/pt/docs/campaigns/) e [automações](/pt/docs/automations/) (beta) |
| Recebimento de e-mails | [Recebimento de e-mails](/pt/docs/inbound/) |

Para manter separadas a reputação transacional e a de marketing, como fazem os dois streams do Mailtrap, envie de domínios ou subdomínios diferentes, como `mail.acme.com` para recibos e `news.acme.com` para newsletters.

## Atualizar as chamadas à API

O `POST /api/send` do Mailtrap 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: Mailtrap"
curl https://send.api.mailtrap.io/api/send \
  -H "Authorization: Bearer $MAILTRAP_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>"
  }'
```

| Mailtrap | Emailit |
| --- | --- |
| `Authorization: Bearer <token>` ou `Api-Token: <token>` | `Authorization: Bearer secret_…` |
| `send.api.mailtrap.io` e `bulk.api.mailtrap.io` | Um único host, `api.emailit.com` |
| `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`, `headers` | Iguais |
| `attachments[]` com `content`, `filename`, `type`, `disposition` e `content_id` | `attachments[]` com `content`, `filename`, `content_type` e `content_id`, ou uma `url` no lugar de `content` |
| `category` | `meta`, por exemplo `meta: { "category": "password-reset" }` |
| `custom_variables` | `meta`, devolvido nos eventos de webhook |
| `template_uuid` e `template_variables` | `template` (um alias ou ID) e `variables` |
| Rastreamento definido por domínio | Rastreamento definido por domínio, ou por e-mail com `tracking: { "loads": true, "clicks": true }` |
| `POST /api/batch` (até 500 mensagens) | Não disponível. Envie uma requisição por mensagem. |
| Resposta com `message_ids`, um por destinatário | `200` com `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um |

O Emailit também oferece agendamento com `scheduled_at` e novas tentativas seguras com um cabeçalho `Idempotency-Key`, o que a API de envio do Mailtrap não oferece. Consulte [Enviar um e-mail](/pt/docs/email-api/send-email/).

## Mudar as configurações SMTP

| Configuração | Mailtrap | Emailit |
| --- | --- | --- |
| Host | `live.smtp.mailtrap.io`, ou `bulk.smtp.mailtrap.io` para o bulk stream | `smtp.emailit.com` |
| Porta | `587`, `2525` ou `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | `api` | `emailit` |
| Senha | O seu token de API do Mailtrap | A sua chave de API do Emailit |

O Emailit não lê os cabeçalhos `X-MT-Category` nem `X-MT-Custom-Variables`. 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 do Mailtrap | Evento do Emailit |
| --- | --- |
| `delivery` | `email.delivered` |
| `soft bounce` | `email.attempted` enquanto o Emailit faz novas tentativas, e depois `email.bounced` se todas as novas tentativas falharem |
| `bounce` | `email.bounced` |
| `reject` | `email.suppressed` quando o endereço tem uma supressão `recipient` |
| `suspension` | `email.held` |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, somente para e-mails de campanha |
| `inbound.message_received` | `email.received`; depois, busque o conteúdo com [`GET /emails/{id}`](/pt/docs/api-reference/emails/get/) |

O Emailit também envia `email.accepted` quando a API aceita um e-mail. Consulte [Tipos de evento](/pt/docs/webhooks/event-types/).

O formato da requisição muda:

- O Mailtrap envia uma lista `events` de até 500 eventos, ou JSON Lines. O Emailit envia um array JSON de até 100 eventos como corpo da requisição.
- 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 `message_id`, e `data.object.to` em vez de `email`. Os seus valores de `meta`, que substituem `category` e `custom_variables`, 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 `Mailtrap-Signature` do Mailtrap é 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. Exporte as suas supressões em **Suppressions** no Mailtrap, ou percorra as páginas de `GET https://mailtrap.io/api/suppressions`, que retorna até 1.000 entradas por chamada.

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

   | Tipo no Mailtrap | Tipo no Emailit |
   | --- | --- |
   | `hard bounce`, `spam complaint`, `manual import` | `recipient`, que bloqueia envios pela API, por SMTP e de campanhas |
   | `unsubscription` | `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais. Use `recipient` para descadastros do transactional stream. |

```csv
email,type,reason
old-address@example.com,recipient,mailtrap hard bounce
left@example.com,unsubscribe,mailtrap unsubscription
```

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, então os endereços suprimidos em vários domínios ou streams do Mailtrap são adicionados uma única vez.

Consulte [Gerenciar supressões](/pt/docs/suppressions/manage/).

## Migrar os contatos

Se você usa o Mailtrap Email Marketing, exporte os seus contatos em **Contacts** com **More Actions > Export**, ou com `POST https://mailtrap.io/api/contacts/exports` filtrado por `subscription_status` e `list_id`. Antes, crie no Emailit os [campos personalizados](/pt/docs/contacts/custom-fields/) e as [listas de contatos](/pt/docs/audiences/) correspondentes.

Importe apenas os contatos inscritos, uma lista de contatos por vez, em **Email Marketing → Contacts** com **Import**. A importação adiciona todas as pessoas do arquivo como inscritas, então, em vez disso, adicione os contatos descadastrados ao seu arquivo de supressões com o tipo `unsubscribe`. Divida os arquivos em partes de até 2.500 linhas. Consulte [Importar e exportar contatos](/pt/docs/contacts/import-export/).

## Migrar os templates

Obtenha o HTML dos seus templates com `GET https://mailtrap.io/api/email_templates`, que retorna `body_html`, `body_text` e `subject` de cada template. Importe cada um 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`.

Os templates do Mailtrap usam Handlebars. O Temple cobre as partes mais comuns:

| Mailtrap (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{name}}`, `{{user.name}}` | Igual |
| `{{{html_block}}}` | `{{html_block}}`. O Temple nunca escapa HTML, então escape você mesmo o que vier dos usuários. |
| `{{#if plan}}…{{else}}…{{/if}}` | Igual |
| `{{#unless plan}}…{{/unless}}` | `{{#if plan}}{{else}}…{{/if}}` |
| `{{#if name}}{{name}}{{else}}Customer{{/if}}` | `{{name\|"Customer"}}` |
| `{{#each items}}…{{/each}}`, `{{#with}}` | Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
| `template_variables` | `variables` |

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 `rwmt1._domainkey` e `rwmt2._domainkey` do Mailtrap, com o CNAME de verificação dele nem com o CNAME de rastreamento `mt-link` dele. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

Depois da virada, remova os registros DKIM, de verificação e de rastreamento do Mailtrap e o `include:_spf.mailtrap.io`, se o seu registro SPF ainda o tiver. O recebimento do Mailtrap usa o registro MX do seu domínio raiz, e o do Emailit usa um subdomínio como `inbound.acme.com`, então migre os e-mails recebidos e atualize os seus endereços de recebimento antes de alterar o registro MX. Consulte [Configurar o recebimento de e-mails](/pt/docs/inbound/set-up/).

## 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/mailtrap/
