Migrar desde Resend

Esta guía relaciona los conceptos, las llamadas a la API, los webhooks y las plantillas de Resend con sus equivalentes en Emailit. Las dos API tienen una forma parecida, así que la mayoría de los cambios en el código son pequeños. Lee primero Migrar a Emailit para conocer el orden general y cómo usar los dos proveedores en paralelo.

Conceptos

Actualizar las llamadas a la API

POST /emails de Resend pasa a ser POST /v2/emails de Emailit, con casi los mismos campos. En 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 destinatario de una petición a Emailit se convierte en un email independiente con su propio ID. Cuando envías a varios destinatarios, ids en la respuesta asocia cada dirección con su ID. Emailit también hace el seguimiento de aperturas y clics por email con tracking: { "loads": true, "clicks": true }, una vez que el dominio tiene un subdominio de seguimiento verificado. Consulta Enviar un email.

React Email

Si creas los emails con React Email, conserva tus componentes y renderízalos tú 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 });

Cambiar la configuración SMTP

Consulta Configuración SMTP.

Equivalencias de los eventos de webhook

El formato de las peticiones cambia:

• Resend envía un evento por petición. Emailit envía un array JSON de hasta 100 eventos, así que recorre el cuerpo.
• El email está en data.object. Usa data.object.id, el ID em_ de la respuesta de envío, en lugar de data.email_id. Tus valores de meta están en data.object.meta.
• Las firmas funcionan de otra manera. Resend firma los webhooks a través de Svix, con cabeceras svix-*. Emailit envía X-Emailit-Signature, el HMAC-SHA256 en hexadecimal de <timestamp>.<raw body>, con el secreto completo, incluido el prefijo whsec_, como clave. Una biblioteca de verificación de Svix no funcionará, aunque los dos secretos empiecen por whsec_. Consulta Verificar las firmas de los webhooks.

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);
}

Trasladar las direcciones bloqueadas y los contactos

1. Reúne todas las direcciones que rebotaron o generaron quejas mientras usabas Resend, desde el panel de Resend o a partir de los eventos que guardaron tus webhooks.

2. Crea un único CSV con las columnas email,type,reason:

   CSV

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

   Usa el tipo recipient para las direcciones que nunca deben recibir emails. Bloquea los envíos por API, por SMTP y de campañas.

3. En Email API›Suppressions, selecciona Import y sube el archivo. Cada archivo puede tener hasta 10.000 filas y ocupar como máximo 8 MB. Los duplicados se omiten.

Si envías broadcasts, exporta cada audience de Resend como CSV e impórtala en Email Marketing›Contacts con Import, eligiendo la lista de contactos correspondiente de Emailit. Asigna la columna de baja para que las personas que se dieron de baja sigan dadas de baja. Consulta Importar y exportar contactos.

Trasladar las plantillas

Si renderizas los emails en tu código, con React Email o con cualquier otra herramienta, no cambia nada: envía el HTML. Si guardas plantillas en Resend, vuelve a crearlas en Email Marketing›Templates o con la API de plantillas, asigna un alias a cada una y envíalas con template y variables.

Las plantillas de Emailit usan Temple: {{name}}, valores anidados como {{user.name}}, valores por defecto como {{name|"there"}} y {{#if plan}}…{{else}}…{{/if}}. No hay bucles, así que genera las listas en tu código. Temple nunca escapa el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos.

Cambiar los DNS

Añade tu dominio en Email API›Domains y publica los registros de Emailit. Usan sus propios nombres (emailit._domainkey, emailit.<domain> y, opcionalmente, go e inbound), así que no entran en conflicto con los registros de Resend, que normalmente están en resend._domainkey y en un subdominio send. Conserva tu registro DMARC. Después del cambio definitivo, elimina los registros de Resend. Consulta Registros DNS de los dominios de envío.

Próximos pasos

• Lista de comprobación para pasar a producción
• Configurar un webhook
• Migración prioritaria: deja que los ingenieros de Emailit hagan la migración contigo