Guia
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 para conhecer a ordem geral e saber como usar os dois provedores em paralelo.
Conceitos
| SMTP2GO | Emailit |
|---|---|
| Master account e subaccounts | Conta e 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: 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 |
| 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 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 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 com alias e versões, renderizados com o Temple |
| Webhooks | Webhooks |
| Supressões de endereços e de domínios | Supressões de endereços |
| Relatórios e atividade | Email APIEmails e Email APILogs |
| IPs dedicados e IP pools | IPs dedicados 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 do Emailit, que adicionam os cabeçalhos para você. Nas campanhas, adicione o link visível com {{unsubscribe_url}}. Consulte Cabeçalhos SMTP.
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 e Cabeçalhos e respostas SMTP.
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:
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>"
}'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 |
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.
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
eventparatype, e o e-mail fica emdata.object. Usedata.object.id, o IDem_da resposta do envio ou da resposta SMTP, em vez deemail_id, edata.object.toem vez dercpt. Os valores que você passou emmetaficam emdata.object.meta. - Em
email.loadedeemail.clicked,data.objecté o carregamento ou o clique. Usedata.object.email_idpara obter o ID do e-mail, edata.object.email.rcpt_toedata.object.email.metapara obter o destinatário e os seus valores demeta. - O SMTP2GO não assina os webhooks. O Emailit assina cada requisição: verifique
X-Emailit-SignaturecomX-Emailit-Timestampe o seu segredowhsec_. Consulte Assinatura das requisições.
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
-
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ê definastart_date, então defina-o para cobrir todo o seu histórico. -
Monte um único CSV com as colunas
email,type,reason:Motivo no SMTP2GO Tipo no Emailit bounce,spam,manualrecipient, que bloqueia envios pela API, por SMTP e de campanhasunsubscribeunsubscribe, que bloqueia campanhas, mas ainda deixa passar os e-mails transacionais. Userecipientse a pessoa tiver se descadastrado de tudo o que você envia.email,type,reason old-address@example.com,recipient,smtp2go bounce left@example.com,unsubscribe,smtp2go unsubscribe -
Em Email APISuppressions, 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.
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 MarketingTemplates ou crie-o com a API de templates 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 e Importar e exportar templates.
Alterar o DNS
Adicione o seu domínio em Email APIDomains 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.
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
- Solução de problemas de SMTP
- Migração prioritária: deixe os engenheiros do Emailit fazerem a migração com você