Pular para o conteúdo
Docs

Guia

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.

Atualizado em 23 de out. de 2026

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:

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

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.