# Migrar do Elastic Email

> Migre do Elastic Email para o Emailit. Faça a correspondência das chamadas às APIs v4 e v2, das credenciais SMTP e das notificações, converta os campos de mesclagem e migre supressões, contatos e campanhas.

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

## Conceitos

| Elastic Email | Emailit |
| --- | --- |
| Conta e subaccounts | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Chaves de API com níveis de acesso | [Chaves de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Credenciais SMTP | A sua chave de API, usada como senha do SMTP |
| Domínios verificados e endereços de remetente verificados | [Domínios de envio](/pt/docs/domains/). Remetentes de um único endereço não estão disponíveis. |
| Channels e valores de postback | `meta` |
| Templates, identificados pelo nome | [Templates](/pt/docs/templates/) com alias e versões |
| Campos de mesclagem e scripts de template | [Temple](/pt/docs/templates/temple/): variáveis, valores padrão e condicionais |
| Notificações web por HTTP | [Webhooks](/pt/docs/webhooks/) |
| Inbound routes | [Recebimento de e-mails](/pt/docs/inbound/) |
| Supressões e status de contato que bloqueiam o envio | [Supressões](/pt/docs/suppressions/) |
| Contatos e listas | [Contatos](/pt/docs/contacts/) 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 e automações | [Campanhas](/pt/docs/campaigns/) e [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 |
| Verificação de e-mails | [Verificação de e-mails](/pt/docs/email-verification/) |
| IPs privados e IP pools | [IPs dedicados](/pt/docs/deliverability/dedicated-ips/) sob solicitação |

O Elastic Email adiciona um link de descadastro a todos os e-mails, incluindo os envios pela API e por SMTP. O Emailit adiciona cabeçalhos `List-Unsubscribe` apenas às [campanhas](/pt/docs/campaigns/) e aos e-mails de marketing das automações, e você mesmo adiciona o link visível com `{{unsubscribe_url}}`. Se você envia newsletters ou outros e-mails em massa pela API ou por SMTP, adicione o seu próprio link e os cabeçalhos `List-Unsubscribe`. Consulte [Cabeçalhos e metadados](/pt/docs/email-api/headers-and-metadata/#add-list-unsubscribe-to-bulk-mail).

## Atualizar as chamadas à API

O `POST /v4/emails/transactional` do Elastic Email passa a ser `POST /v2/emails`. O corpo é plano, os nomes dos campos ficam em minúsculas e a chave passa para um cabeçalho `Authorization`:

```bash title="Antes: Elastic Email"
curl https://api.elasticemail.com/v4/emails/transactional \
  -H "X-ElasticEmail-ApiKey: $ELASTICEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Recipients": { "To": ["ada@example.com"] },
    "Content": {
      "From": "Acme <hello@acme.com>",
      "Subject": "Your receipt",
      "Body": [
        { "ContentType": "HTML", "Content": "<p>Thanks for your order.</p>" },
        { "ContentType": "PlainText", "Content": "Thanks for your order." }
      ]
    }
  }'
```

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

| Elastic Email (API v4) | Emailit |
| --- | --- |
| Cabeçalho `X-ElasticEmail-ApiKey` | `Authorization: Bearer secret_…` |
| `Content.From` | `from` |
| `Recipients.To`, `CC`, `BCC` | `to`, `cc`, `bcc`, até 50 cada |
| `Content.ReplyTo` | `reply_to` |
| `Content.Subject` | `subject` |
| `Content.Body[]` com `ContentType` `HTML` e `PlainText` | `html` e `text` |
| `Content.Headers` | `headers` |
| `Content.Attachments[]` com `BinaryContent`, `Name`, `ContentType` | `attachments[]` com `content`, `filename`, `content_type` |
| `Content.AttachFiles` (arquivos enviados antes) | `attachments[]` com uma `url` que o Emailit baixa |
| `Content.TemplateName` | `template`, um alias ou ID de template |
| `Content.Merge` | `variables` |
| `Options.ChannelName`, `Content.Postback` | `meta`, devolvido nos eventos de webhook |
| `Options.TrackOpens`, `Options.TrackClicks` | `tracking: { "loads": true, "clicks": true }` |
| `Options.TimeOffset` (minutos) | `scheduled_at` (ISO 8601 ou inglês simples) |
| `Options.PoolName` | Não é necessário. Um IP dedicado envia todos os e-mails do workspace dele. |
| `Content.Utm` | Adicione parâmetros UTM aos seus links. As campanhas os adicionam para você. |
| `POST /v4/emails` com `Recipients[].Fields` (mesclagem em massa) | Uma requisição por destinatário, cada uma com as suas `variables` |
| Cabeçalho `Idempotency-Key` | Cabeçalho `Idempotency-Key`, mantido por 24 horas |
| Resposta com `TransactionID` e `MessageID` | `200` com `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um |

Se você ainda usa a API v2 (`/v2/email/send` com um parâmetro `apikey`), faça a correspondência dos campos de formulário dela da mesma forma: `from` e `fromName` viram `from`, `bodyHtml` e `bodyText` viram `html` e `text`, os campos `merge_*` viram `variables` e `template` vira `template`. Na v2, cada endereço em `to` recebe uma mensagem separada, como em Bcc. No Emailit, os destinatários em `to` veem uns aos outros no cabeçalho `To`, então envie uma requisição por destinatário para mantê-los separados. Consulte [Enviar um e-mail](/pt/docs/email-api/send-email/).

## Mudar as configurações SMTP

| Configuração | Elastic Email | Emailit |
| --- | --- | --- |
| Host | `smtp.elasticemail.com` | `smtp.emailit.com` |
| Porta | `2525`, `587` ou `25` (STARTTLS), `465` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | O nome da credencial SMTP, um endereço de e-mail | `emailit` |
| Senha | O token da credencial SMTP | A sua chave de API do Emailit |

O Emailit não lê os cabeçalhos de controle do Elastic Email, como `X-ElasticEmail-Channel`, `X-ElasticEmail-Postback`, `IsTransactional`, `trackopens` ou `trackclicks`. Remova-os e configure o rastreamento no domínio. Consulte [Configurações SMTP](/pt/docs/smtp/settings/).

## Correspondência dos eventos de webhook

| Notificação do Elastic Email | Evento do Emailit |
| --- | --- |
| `Sent` (o servidor do destinatário aceitou a mensagem) | `email.delivered` |
| `Opened` | `email.loaded` |
| `Clicked` | `email.clicked` |
| `Error` | `email.bounced` para falhas permanentes. As falhas temporárias enviam `email.attempted` enquanto o Emailit faz novas tentativas. |
| `AbuseReport` | `email.complained` |
| `Unsubscribed` | `email.unsubscribed`, somente para e-mails de campanha |
| Inbound route que notifica uma URL | `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, e `email.suppressed` quando uma supressão `recipient` bloqueia um endereço. Consulte [Tipos de evento](/pt/docs/webhooks/event-types/).

O formato da requisição muda:

- O Elastic Email envia um evento por requisição, na query string ou como um objeto JSON plano. O Emailit envia um array JSON de até 100 eventos, então percorra o corpo em um loop.
- O nome do evento passa de `status` 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`, e `data.object.to` em vez de `to`. Os seus valores de `meta`, que substituem `channel` e `postback`, 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 Emailit assina cada requisição. Verifique `X-Emailit-Signature`, o HMAC-SHA256 em hexadecimal de `<timestamp>.<raw body>`, com `X-Emailit-Timestamp` e o seu segredo `whsec_`. A assinatura opcional do Elastic Email também usa segredos `whsec_`, mas assina uma string diferente, então atualize o seu código de verificação. 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 os endereços que o Elastic Email bloqueia, em **Suppressions** no painel ou pela API (`/v4/suppressions/bounces`, `/complaints` e `/unsubscribes`).

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

   | Status no Elastic Email | Tipo no Emailit |
   | --- | --- |
   | Invalid (`Bounced`) | `recipient` |
   | Complaint (`Abuse`) | `recipient` |
   | Unsubscribed | `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais. Use `recipient` para bloquear todos os e-mails. |

```csv
email,type,reason
old-address@example.com,recipient,elastic email bounced
left@example.com,unsubscribe,elastic email unsubscribed
```

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.

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

## Migrar os contatos e as campanhas

Exporte os seus contatos em **Contacts** (selecione-os e depois use **More actions > Export**) ou com `POST /v4/contacts/export`, e exporte cada lista para a qual você envia campanhas. Depois, traga-os de acordo com o status:

| Status no Elastic Email | Para onde vai |
| --- | --- |
| Engaged, Active | Importe na lista de contatos correspondente em **Email Marketing → Contacts** com **Import**. |
| Transactional | Deixe-os fora das listas de contatos. Eles nunca se inscreveram nos seus e-mails de marketing. |
| Invalid, Complaint, Unsubscribed | A lista de supressão, como acima. |
| Inactive, Stale, Not Confirmed | Deixe-os de fora. |

Crie [campos personalizados](/pt/docs/contacts/custom-fields/) para os seus campos de contato antes de importar e divida os arquivos em partes de até 2.500 linhas. A importação adiciona todas as pessoas do arquivo como inscritas, então importe apenas quem deve receber as suas campanhas. Consulte [Importar e exportar contatos](/pt/docs/contacts/import-export/).

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

## Migrar os templates

Copie o HTML de cada template com **Edit as HTML** no Elastic Email, ou obtenha-o com `GET /v4/templates/{name}`, que o retorna em `Body`. Importe-o em **Email Marketing → Templates** ou crie-o com a [API de templates](/pt/docs/api-reference/templates/create/) e use o nome do template como alias, se ele se encaixar no formato de alias: letras minúsculas, números, `-` e `_`.

Os campos de mesclagem do Elastic Email usam chaves simples, e o Temple usa chaves duplas. Os campos com chaves simples que ficarem em um template são enviados como texto simples, então converta todos:

| Elastic Email | Emailit (Temple) |
| --- | --- |
| `{firstname}`, `{lastname}`, `{email}` | `{{first_name}}`, `{{last_name}}`, `{{email}}` nas campanhas. Nos envios pela API, os nomes que você passa em `variables`. |
| `{firstname:friend}` | `{{first_name\|"friend"}}` |
| `{company}` ou outro campo personalizado | `{{cf.company}}` nas campanhas |
| `{unsubscribe}` | `{{unsubscribe_url}}` nas campanhas |
| `{contactprofile}` | `{{manage_subscriptions_url}}` nas campanhas |
| `{view}` | `{{webview_url}}` nas campanhas |
| `{accountaddress}` e outros campos da conta | Escreva-os no template ou guarde-os em [valores globais](/pt/docs/contacts/global-values/) |
| Scripts de template em `{{ … }}` | Não suportado. Calcule os valores no seu código e use `{{#if}}` para conteúdo condicional. |

Consulte [Tags de mesclagem](/pt/docs/campaigns/merge-tags/) e [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 o registro DKIM `api._domainkey` do Elastic Email, com o CNAME `tracking` dele nem com um domínio de bounce personalizado. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

Depois da virada, remova os registros DKIM e de rastreamento do Elastic Email e o `include:_spf.elasticemail.com` do seu registro SPF. Se você recebe e-mails com as inbound routes do Elastic Email, mude antes para um [subdomínio de recebimento](/pt/docs/inbound/set-up/) do Emailit. O Emailit recebe em um subdomínio, como `inbound.acme.com`, então os endereços de recebimento mudam.

## 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/elastic-email/
