# Migrar do Mailjet

> Migre do Mailjet para o Emailit. Faça a correspondência dos pares de chaves de API e dos remetentes, converta as chamadas à Send API v3.1 e a linguagem de templates, troque o SMTP e migre webhooks, a lista de exclusão e as listas de contatos.

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

| Mailjet | Emailit |
| --- | --- |
| Chave de API principal e chaves de API de sub-accounts | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Par de chaves de API (chave pública e chave secreta) | [Chave de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Remetentes: endereços individuais e domínios inteiros | [Domínios de envio](/pt/docs/domains/). Remetentes de um único endereço não estão disponíveis. |
| `SandboxMode` | 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 do Mailjet | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Event API, uma URL por tipo de evento | [Webhooks](/pt/docs/webhooks/): um endpoint pode receber todos os tipos de evento |
| Parse API | [Recebimento de e-mails](/pt/docs/inbound/) |
| Lista de exclusão, quem reclamou de spam e endereços bloqueados | [Supressões](/pt/docs/suppressions/) |
| Contatos, listas de contatos e propriedades de contato | [Contatos](/pt/docs/contacts/), [listas de contatos](/pt/docs/audiences/) e [campos personalizados](/pt/docs/contacts/custom-fields/) |
| 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 e automações | [Campanhas](/pt/docs/campaigns/) e [automações](/pt/docs/automations/) (beta) |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta` |
| Estatísticas e histórico de mensagens | **Email API → Emails**, **Email API → Logs** e [relatórios de campanha](/pt/docs/campaigns/reports/) |

## Atualizar as chamadas à API

O `POST /v3.1/send` do Mailjet recebe autenticação básica e uma lista `Messages` com campos em PascalCase. O `POST /v2/emails` do Emailit recebe um bearer token e uma única mensagem com campos em minúsculas:

```bash title="Antes: Mailjet"
curl https://api.mailjet.com/v3.1/send \
  --user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE" \
  -H "Content-Type: application/json" \
  -d '{
    "Messages": [{
      "From": { "Email": "hello@acme.com", "Name": "Acme" },
      "To": [{ "Email": "ada@example.com" }],
      "Subject": "Your receipt",
      "TextPart": "Thanks for your order.",
      "HTMLPart": "<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>"
  }'
```

| Mailjet (Send API v3.1) | Emailit |
| --- | --- |
| Autenticação básica com a chave pública e a chave secreta | `Authorization: Bearer secret_…` |
| `api.mailjet.com`, ou `api.us.mailjet.com` para contas dos EUA | Um único host, `api.emailit.com` |
| `Messages[]`, até 50 por chamada | Uma mensagem por requisição |
| `From: { Email, Name }` | `from: "Name "` |
| `To`, `Cc`, `Bcc` com `Email` e `Name` | `to`, `cc`, `bcc` como string ou array de até 50 cada |
| `ReplyTo` | `reply_to` |
| `Subject`, `TextPart`, `HTMLPart` | `subject`, `text`, `html` |
| `Headers` | `headers` |
| `Attachments[]` com `ContentType`, `Filename`, `Base64Content` | `attachments[]` com `content_type`, `filename`, `content` |
| `InlinedAttachments[]` com `ContentID` | `attachments[]` com um `content_id`, referenciado como `cid:` no HTML |
| `CustomID`, `EventPayload`, `CustomCampaign` | `meta`, por exemplo `meta: { "custom_id": "order-123" }`, devolvido nos eventos de webhook |
| `TemplateID`, `TemplateLanguage: true` e `Variables` | `template` (um alias ou ID) e `variables` |
| `TrackOpens`, `TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `URLTags` | Adicione parâmetros UTM aos seus links. As campanhas os adicionam para você. |
| `Globals` | Não disponível. Repita os campos compartilhados em cada requisição. |
| Resposta com `MessageUUID` e `MessageID` para cada destinatário | `200` com `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um |

Os IDs do Emailit são strings, então você não precisa mais lidar com os valores inteiros grandes de `MessageID` do Mailjet. O Emailit também oferece agendamento com `scheduled_at` e novas tentativas seguras com um cabeçalho `Idempotency-Key`. Consulte [Enviar um e-mail](/pt/docs/email-api/send-email/).

## Mudar as configurações SMTP

| Configuração | Mailjet | Emailit |
| --- | --- | --- |
| Host | `in-v3.mailjet.com` | `smtp.emailit.com` |
| Porta | `587`, `588`, `2525`, `25` ou `80` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | A sua chave de API pública | `emailit` |
| Senha | A sua chave de API secreta | A sua chave de API do Emailit |

O Emailit não lê os cabeçalhos do Mailjet, como `X-Mailjet-Campaign`, `X-MJ-CustomID`, `X-MJ-EventPayload`, `X-Mailjet-TrackOpen`, `X-Mailjet-TrackClick`, `X-MJ-TemplateID` ou `X-MJ-Vars`. 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 Mailjet | Evento do Emailit |
| --- | --- |
| `sent` | `email.delivered` |
| `bounce` | `email.bounced`. O Emailit também envia `email.attempted` para cada tentativa com falha que ele repete. |
| `blocked` | `email.suppressed` quando o endereço tem uma supressão `recipient` |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsub` | `email.unsubscribed`, somente para e-mails de campanha |
| Rota da Parse API | `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 Mailjet precisa de uma URL para cada tipo de evento e envia um evento por requisição, a menos que você agrupe os eventos. Um webhook do Emailit pode ser inscrito em vários tipos de evento e 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 `MessageID` ou `Message_GUID`, e `data.object.to` em vez de `email`. Os seus valores de `meta`, que substituem `CustomID` e `Payload`, 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 Mailjet não assina as requisições dele. O Emailit assina todas: verifique `X-Emailit-Signature` com `X-Emailit-Timestamp` e o seu segredo `whsec_` e, se quiser, retire as credenciais de autenticação básica da sua URL. 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

O Mailjet não tem uma lista de supressão única, então reúna os endereços de vários lugares:

1. Reúna os endereços que o Mailjet bloqueia:

   | Mailjet | Como exportar | Tipo no Emailit |
   | --- | --- | --- |
   | Lista de exclusão | O download da lista de exclusão no painel, ou `GET /v3/REST/contact?IsExcludedFromCampaigns=true` | `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais, como a lista de exclusão do Mailjet |
   | Quem reclamou de spam | Contatos com `IsSpamComplaining` definido, de `GET /v3/REST/contact` | `recipient` |
   | Hard bounces | Os eventos `bounce` que os seus webhooks armazenaram, ou os seus relatórios de campanha | `recipient` |

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

```csv
email,type,reason
excluded@example.com,unsubscribe,mailjet exclusion list
angry@example.com,recipient,mailjet spam complaint
```

   O tipo `recipient` bloqueia envios pela API, por SMTP e de campanhas.

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.

Se você usava várias chaves de API do Mailjet, repita isso para cada uma. Consulte [Gerenciar supressões](/pt/docs/suppressions/manage/).

## Migrar os contatos

Exporte cada lista de contatos em **Contacts** no Mailjet, ou com `GET /v3/REST/listrecipient?ContactsList={id}`, que inclui o indicador `IsUnsubscribed` de cada membro. As propriedades de contato vêm de `GET /v3/REST/contactdata`.

1. **Prepare o Emailit.** Crie um [campo personalizado](/pt/docs/contacts/custom-fields/) para cada propriedade de contato que você usa e uma [lista de contatos](/pt/docs/audiences/) para cada lista.

2. **Importe os membros inscritos.** Em **Email Marketing → Contacts**, selecione **Import**, mapeie as colunas 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/).

3. **Suprima os demais.** A importação adiciona todas as pessoas do arquivo como inscritas, então deixe os membros descadastrados fora do arquivo. Em vez disso, adicione-os ao seu arquivo de supressões com o tipo `unsubscribe` e deixe de fora os contatos cujo opt-in ainda está pendente. Uma supressão `unsubscribe` bloqueia todas as campanhas, então não a adicione para pessoas que ainda estão inscritas em outra lista que você está migrando.

Recrie as suas campanhas e automações em **Email Marketing → Campaigns** e **Automations**, a partir dos templates importados.

## Migrar os templates

Obtenha o HTML de cada template com `GET /v3/REST/template/{id}/detailcontent`, que retorna `Html-part` e `Text-part`, ou copie-o do editor do Mailjet. 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 do Mailjet para o Temple:

| Mailjet | Emailit (Temple) |
| --- | --- |
| `{{var:name}}`, `{{var:order.total}}` | `{{name}}`, `{{order.total}}` |
| `{{var:name:"there"}}` | `{{name\|"there"}}` |
| `{{data:firstname}}` (uma propriedade de contato) | `{{first_name}}` ou `{{cf.<key>}}` nas campanhas. Nos envios pela API, passe o valor em `variables`. |
| `{% if var:plan %}…{% else %}…{% endif %}` | `{{#if plan}}…{{else}}…{{/if}}` |
| `{% if var:plan == "pro" %}`, `{% elseif %}` | Não suportado. Passe um booleano como `is_pro` e use `{{#if is_pro}}`. |
| `{% for item in var:items %}…{% endfor %}` | Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
| Funções como `Upper()` ou `FormatNumber()` | Não suportado. Formate o valor no seu código. |
| `{{mj:unsub_link}}` | `{{unsubscribe_url}}` nas campanhas |
| `Variables` | `variables` |

O Temple nunca escapa 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 o registro DKIM `mailjet._domainkey` do Mailjet nem com o registro TXT de propriedade dele. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

Se o seu host de rastreamento personalizado no Mailjet já for `go`, escolha outro nome para o do Emailit com `tracking_key`. Consulte [Domínio de rastreamento personalizado](/pt/docs/tracking/custom-tracking-domain/).

Depois da virada, remova os registros DKIM, de propriedade, de rastreamento e de return path do Mailjet e o `include:spf.mailjet.com` do seu registro SPF. Se você recebe e-mails com a Parse API no seu próprio domínio, 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/mailjet/
