# Migrar do SMTP2GO

> Migre do SMTP2GO para o Emailit. Troque os usuários e os hosts SMTP, converta as chamadas à API email/send e os templates e migre webhooks, supressões e domínios de envio.

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

| SMTP2GO | Emailit |
| --- | --- |
| Master account e subaccounts | Conta e [workspaces](/pt/docs/workspaces/). Cada workspace tem os seus próprios domínios, chaves, membros e créditos. |
| Usuários SMTP | A sua chave de API, usada como senha do SMTP. Crie uma chave por aplicação ou servidor. |
| Chaves de API com permissões por endpoint | [Chaves de API](/pt/docs/developers/api-keys/): **Full Access**, ou **Sending Only**, que pode ser restrita a um domínio |
| Autenticação por IP e por endereço | Não disponível. Toda conexão SMTP se autentica com uma chave de API. |
| Sender domains | [Domínios de envio](/pt/docs/domains/) |
| Single sender emails | Não disponível. Todo endereço From deve estar em um domínio verificado. |
| Status de sandbox em um usuário SMTP ou em uma chave de API | Os workspaces novos ficam no [modo sandbox](/pt/docs/workspaces/production-access/) e só entregam para membros do workspace. |
| Configurações de rastreamento e de rodapé de descadastro por usuário SMTP ou chave de API | [Rastreamento](/pt/docs/tracking/) por domínio de envio. O Emailit não adiciona um rodapé de descadastro aos e-mails enviados pela API ou por SMTP. |
| Templates | [Templates](/pt/docs/templates/) com alias e versões, renderizados com o [Temple](/pt/docs/templates/temple/) |
| Webhooks | [Webhooks](/pt/docs/webhooks/) |
| Supressões de endereços e de domínios | [Supressões](/pt/docs/suppressions/) de endereços |
| Relatórios e atividade | **Email API → Emails** e **Email API → Logs** |
| IPs dedicados e IP pools | [IPs dedicados](/pt/docs/deliverability/dedicated-ips/) sob solicitação |

Se você depende do rodapé de descadastro do SMTP2GO nas newsletters, adicione o seu próprio link de descadastro e os cabeçalhos `List-Unsubscribe`, ou envie-as como [campanhas](/pt/docs/campaigns/) do Emailit, que adicionam os cabeçalhos para você. Nas campanhas, adicione o link visível com `{{unsubscribe_url}}`. Consulte [Cabeçalhos SMTP](/pt/docs/smtp/headers/#add-list-unsubscribe-yourself).

## Mudar as configurações SMTP

| Configuração | SMTP2GO | Emailit |
| --- | --- | --- |
| Host | `mail.smtp2go.com`, ou um host regional como `mail-eu.smtp2go.com` | `smtp.emailit.com` |
| Porta | `2525`, `587`, `25`, `8025` ou `80` (STARTTLS), `465`, `8465` ou `443` (TLS) | `587`, `2587`, `2525` ou `25` (STARTTLS), `465` (TLS) |
| Usuário | O nome de usuário do usuário SMTP | `emailit` |
| Senha | A senha do usuário SMTP | A sua chave de API do Emailit |

O Emailit não escuta nas portas `80`, `443`, `8025` e `8465`. Se a sua rede bloquear `25` e `587`, use `2525` ou `2587`. No Emailit, cada destinatário vira um e-mail próprio, e a resposta `250` lista os IDs deles, ou apenas o primeiro ID quando há muitos destinatários. Consulte [Configurações SMTP](/pt/docs/smtp/settings/) e [Cabeçalhos e respostas SMTP](/pt/docs/smtp/headers/).

## Atualizar as chamadas à API

O `POST /v3/email/send` do SMTP2GO passa a ser `POST /v2/emails`. Os endereços continuam sendo strings, mas os nomes dos campos mudam:

```bash title="Antes: SMTP2GO"
curl https://api.smtp2go.com/v3/email/send \
  -H "X-Smtp2go-Api-Key: $SMTP2GO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "Acme <hello@acme.com>",
    "to": ["ada@example.com"],
    "subject": "Your receipt",
    "text_body": "Thanks for your order.",
    "html_body": "<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>"
  }'
```

| SMTP2GO | Emailit |
| --- | --- |
| Cabeçalho `X-Smtp2go-Api-Key`, `api_key` no corpo ou `Authorization: Bearer api-…` | `Authorization: Bearer secret_…` |
| `sender` | `from` |
| `to`, `cc`, `bcc` | `to`, `cc`, `bcc`, até 50 cada |
| `custom_headers` com `Reply-To` | `reply_to` |
| `custom_headers: [{ "header": "…", "value": "…" }]` | `headers: { "Name": "Value" }` |
| `subject` | `subject` |
| `text_body`, `html_body` | `text`, `html` |
| `attachments[]` com `filename`, `fileblob` ou `url`, e `mimetype` | `attachments[]` com `filename`, `content` ou `url`, e `content_type` |
| `inlines[]` | `attachments[]` com um `content_id`, referenciado como `cid:` no HTML |
| `template_id` e `template_data` | `template` (um alias ou ID) e `variables` |
| `schedule` (até 3 dias de antecedência) | `scheduled_at` (ISO 8601 ou inglês simples) |
| `fastaccept` | Não é necessário. O Emailit coloca todos os e-mails na fila de entrega e responde sem esperar pela entrega. |
| `POST /v3/email/batch` (até 1.000 e-mails) | Não disponível. Envie uma requisição por mensagem. |
| `POST /v3/email/mime` | Envie a mensagem MIME pelo [SMTP relay](/pt/docs/smtp/) |
| `200` com `email_id`, `succeeded`, `failed` e `failures` | `200` com `id` (`em_…`), `status: "accepted"` e, para vários destinatários, `ids`, com um ID para cada um. Os erros usam códigos de status HTTP. |

O SMTP2GO não tem metadados nem configurações de rastreamento por e-mail. No Emailit, adicione `meta` para receber os seus próprios valores de volta nos eventos de webhook, e `tracking: { "loads": true, "clicks": true }` para substituir o rastreamento do domínio. Adicione um cabeçalho `Idempotency-Key` para que as novas tentativas sejam seguras. Consulte [Enviar um e-mail](/pt/docs/email-api/send-email/).

## Correspondência dos eventos de webhook

| Evento do SMTP2GO | Evento do Emailit |
| --- | --- |
| `processed` | `email.accepted` (somente API) |
| `delivered` | `email.delivered` |
| `bounce` com `bounce` `soft` | `email.attempted` enquanto o Emailit faz novas tentativas, e depois `email.bounced` se todas as novas tentativas falharem |
| `bounce` com `bounce` `hard` | `email.bounced` |
| `reject` | `email.suppressed` quando o endereço tem uma supressão `recipient`. Outras rejeições, como um remetente não verificado, são erros na resposta da API ou na resposta SMTP. |
| `spam` | `email.complained` |
| `open` | `email.loaded` |
| `click` | `email.clicked` |
| `unsubscribe` | `email.unsubscribed`, somente para e-mails de campanha |

O formato da requisição muda:

- O SMTP2GO envia um evento por requisição, como campos de formulário por padrão ou como 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 `event` para `type`, e o e-mail fica em `data.object`. Use `data.object.id`, o ID `em_` da resposta do envio ou da resposta SMTP, em vez de `email_id`, e `data.object.to` em vez de `rcpt`. Os valores que você passou em `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 SMTP2GO não assina os webhooks. O Emailit assina cada requisição: 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 as suas supressões em **Reports > Suppressions** com **Export**, ou percorra as páginas de `POST /v3/suppression/view`. A API retorna mais ou menos os últimos 30 dias, a menos que você defina `start_date`, então defina-o para cobrir todo o seu histórico.

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

   | Motivo no SMTP2GO | Tipo no Emailit |
   | --- | --- |
   | `bounce`, `spam`, `manual` | `recipient`, que bloqueia envios pela API, por SMTP e de campanhas |
   | `unsubscribe` | `unsubscribe`, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais. Use `recipient` se a pessoa tiver se descadastrado de tudo o que você envia. |

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

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 suprime endereços exatos, então as supressões de domínio não podem ser importadas. Repita a exportação para cada subaccount e importe-a no workspace correspondente. Consulte [Gerenciar supressões](/pt/docs/suppressions/manage/).

## Migrar os templates

Obtenha o HTML de cada template com `POST /v3/template/view`, que retorna `html_body`, `text_body` e `subject`, ou copie-o em **Settings > Templates**. Importe-o em **Email Marketing → Templates** ou crie-o com a [API de templates](/pt/docs/api-reference/templates/create/) e use o ID do template no SMTP2GO como alias, se ele se encaixar no formato de alias: letras minúsculas, números, `-` e `_`.

O SMTP2GO ignora `subject` quando você envia um template. O Emailit usa o assunto do template, a menos que a requisição tenha um, então deixe `subject` de fora para manter o do template.

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

| SMTP2GO (Handlebars) | Emailit (Temple) |
| --- | --- |
| `{{ username }}`, `{{ user.name }}` | `{{username}}`, `{{user.name}}` |
| `{{{ 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 |
| `{{#each items}}…{{/each}}` | Não suportado. Renderize a lista no seu código e passe-a como uma única variável. |
| Sem valor padrão embutido | `{{username\|"there"}}` adiciona um valor alternativo |
| `template_data` | `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 o CNAME de DKIM `s<number>._domainkey` do SMTP2GO, com o CNAME de return path `em<number>` dele nem com o CNAME de rastreamento `link` dele. Mantenha o seu registro DMARC. Consulte [Registros DNS](/pt/docs/domains/dns-records/).

Depois da virada, remova os CNAMEs do SMTP2GO e o `include:spf.smtp2go.com`, se o seu registro SPF ainda o tiver.

## Próximos passos

- [Checklist para entrar em produção](/pt/docs/get-started/go-live/)
- [Solução de problemas de SMTP](/pt/docs/smtp/troubleshooting/)
- [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/smtp2go/
