Migrar do Resend

Este guia mostra a correspondência entre os conceitos, as chamadas à API, os webhooks e os templates do Resend e os equivalentes no Emailit. As duas APIs têm um formato parecido, então a maioria das mudanças no código é pequena. Leia antes Migrar para o Emailit para conhecer a ordem geral e saber como usar os dois provedores em paralelo.

Conceitos

Atualizar as chamadas à API

O POST /emails do Resend passa a ser o POST /v2/emails do Emailit, com quase os mesmos campos. Em Node.js:

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

await resend.emails.send({
  from: 'Acme <hello@acme.com>',
  to: ['ada@example.com'],
  subject: 'Your receipt',
  html: '<p>Thanks for your order.</p>',
});

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: ['ada@example.com'],
  subject: 'Your receipt',
  html: '<p>Thanks for your order.</p>',
});

Cada destinatário de uma requisição do Emailit vira um e-mail próprio, com o seu próprio ID. Quando você envia para vários destinatários, o ids da resposta associa cada endereço ao ID dele. O Emailit também rastreia aberturas e cliques por e-mail com tracking: { "loads": true, "clicks": true }, desde que o domínio tenha um subdomínio de rastreamento verificado. Consulte Enviar um e-mail.

React Email

Se você cria e-mails com o React Email, mantenha os seus componentes e renderize-os você mesmo antes de enviar:

import { render } from '@react-email/render';
import Receipt from './emails/receipt';

const html = await render(<Receipt order={order} />);
const text = await render(<Receipt order={order} />, { plainText: true });

await emailit.emails.send({ from, to, subject, html, text });

Mudar as configurações SMTP

Consulte Configurações SMTP.

Correspondência dos eventos de webhook

O formato da requisição muda:

• O Resend envia um evento por requisição. O Emailit envia um array JSON de até 100 eventos, então percorra o corpo em um loop.
• O e-mail fica em data.object. Use data.object.id, o ID em_ da resposta do envio, em vez de data.email_id. Os seus valores de meta ficam em data.object.meta.
• As assinaturas funcionam de outro jeito. O Resend assina os webhooks pelo Svix, com cabeçalhos svix-*. O Emailit envia X-Emailit-Signature, o HMAC-SHA256 em hexadecimal de <timestamp>.<raw body>, com o segredo inteiro como chave, incluindo o prefixo whsec_. Uma biblioteca de verificação do Svix não vai funcionar, embora os dois segredos comecem com whsec_. 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 e os contatos

1. Reúna todos os endereços que deram bounce ou reclamaram enquanto você usava o Resend, pelo painel do Resend ou pelos eventos que os seus webhooks armazenaram.

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

   CSV

   email,type,reason
   old-address@example.com,recipient,resend bounce
   angry@example.com,recipient,resend complaint

   Use o tipo recipient para endereços que nunca devem receber e-mails. Ele 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ê envia broadcasts, exporte cada audience do Resend como CSV e importe-a em Email Marketing›Contacts com Import, escolhendo a lista de contatos correspondente no Emailit. Mapeie a coluna de descadastro para que as pessoas que saíram continuem descadastradas. Consulte Importar e exportar contatos.

Migrar os templates

Se você renderiza os e-mails no código, com o React Email ou qualquer outra coisa, nada muda: envie o HTML. Se você guarda templates no Resend, recrie-os em Email Marketing›Templates ou com a API de templates, dê um alias a cada um e envie-os com template e variables.

Os templates do Emailit usam o Temple: {{name}}, valores aninhados como {{user.name}}, valores padrão como {{name|"there"}} e {{#if plan}}…{{else}}…{{/if}}. Não há loops, então renderize as listas no seu código. O Temple nunca escapa HTML, então escape o que vier dos usuários antes de passar.

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 os registros do Resend, que normalmente ficam em resend._domainkey e em um subdomínio send. Mantenha o seu registro DMARC. Depois da virada, remova os registros do Resend. Consulte Registros DNS.

Próximos passos

• Checklist para entrar em produção
• Configurar webhooks
• Migração prioritária: deixe os engenheiros do Emailit fazerem a migração com você