Migrar desde Mailgun

Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, las direcciones bloqueadas y las plantillas de Mailgun con sus equivalentes en Emailit. 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 /v3/<domain>/messages de Mailgun recibe campos de formulario con autenticación básica. POST /v2/emails de Emailit recibe JSON con un token bearer:

curl -s --user "api:$MAILGUN_API_KEY" \
  https://api.mailgun.net/v3/mg.acme.com/messages \
  -F from='Acme <hello@mg.acme.com>' \
  -F to='ada@example.com' \
  -F subject='Your receipt' \
  -F text='Thanks for your order.' \
  --form-string html='<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@mg.acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "text": "Thanks for your order.",
    "html": "<p>Thanks for your order.</p>"
  }'

Si enviabas desde un subdominio como mg.acme.com, añade exactamente ese subdominio en Emailit. Los subdominios se verifican por separado del dominio principal. Los hosts de la API de Mailgun para la UE y para EE. UU. corresponden al mismo endpoint único de Emailit. Consulta Enviar un email.

Cambiar la configuración SMTP

Emailit no lee las cabeceras X-Mailgun-*. Elimínalas y configura el seguimiento en el dominio. Consulta Configuración SMTP.

Equivalencias de los eventos de webhook

El formato de las peticiones cambia:

• Mailgun envía un evento por petición, con los detalles en event-data. Emailit envía un array JSON de hasta 100 eventos. Recorre el array.
• El nombre del evento está en type y el email, en data.object. Usa data.object.id, el ID em_ de la respuesta de envío, para asociar los eventos con los mensajes. Tus valores de meta están en data.object.meta.
• Mailgun firma una marca de tiempo y un token dentro del cuerpo. Emailit firma todo el cuerpo en bruto: verifica X-Emailit-Signature con X-Emailit-Timestamp y tu secreto 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

1. Exporta las listas Bounces, Complaints y Unsubscribes de cada dominio de Mailgun desde el que envías, desde el panel de control o con la API de suppressions (/v3/<domain>/bounces, /complaints y /unsubscribes).

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

   CSV

   email,type,reason
   old-address@example.com,recipient,mailgun bounce
   angry@example.com,recipient,mailgun 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. Los tipos bounce, complaint y unsubscribe solo detienen las 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.

Emailit tiene una lista de direcciones bloqueadas por espacio de trabajo, así que las direcciones de todos tus dominios de Mailgun van a la misma lista. No hay lista de direcciones permitidas. Consulta Gestionar las direcciones bloqueadas.

Trasladar las plantillas

Copia el HTML de cada plantilla de Mailgun y después impórtalo en Email Marketing›Templates o crea la plantilla con la API de plantillas. Asígnale un alias y envíala con "template": "<alias>" y variables.

Las plantillas de Mailgun usan Handlebars. Temple cubre lo más habitual:

Consulta Lenguaje de plantillas Temple e Importar, exportar y duplicar plantillas.

Cambiar los DNS

Añade cada 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 el registro DKIM de Mailgun ni con su CNAME de seguimiento email.<domain>. No necesitas cambiar el registro SPF de tu dominio raíz para Emailit. Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.

Después del cambio definitivo, elimina los registros DKIM y de seguimiento de Mailgun, y quita include:mailgun.org de tu registro SPF. Si recibes correo a través de las rutas de Mailgun, conserva sus registros MX hasta que hayas trasladado ese tráfico a los emails entrantes de Emailit, que reciben en un subdominio como inbound.acme.com.

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