Saltar al contenido
Docs

Guía

Pasa de Brevo (antes Sendinblue) a Emailit. Conversión de las llamadas a la API smtp/email y del lenguaje de plantillas, cambio de las claves SMTP, y traslado de webhooks, listas de bloqueados, contactos, campañas y automatizaciones.

Actualizado el 23 oct 2026

Esta guía relaciona los conceptos, las llamadas a la API, los webhooks, las listas de bloqueados, las plantillas, los contactos y las automatizaciones de Brevo con sus equivalentes en Emailit. Brevo se llamaba Sendinblue hasta 2023, y algunos de sus hosts y cabeceras todavía usan ese nombre. Lee primero Migrar a Emailit para conocer el orden general y cómo usar los dos proveedores en paralelo.

Conceptos

Brevo Emailit
Cuenta y subcuentas Cuenta y espacios de trabajo. Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos.
Claves de API Claves de API: Full Access, o Sending Only limitada opcionalmente a un dominio
Usuario SMTP y claves SMTP Tu clave de API, usada como contraseña SMTP
Remitentes, verificados uno a uno o mediante un dominio autenticado Dominios de envío. Las direcciones de remitente individuales no están disponibles.
Cabecera X-Sib-Sandbox No hay modo de prueba. Los espacios de trabajo nuevos están en modo sandbox y solo entregan a los miembros del espacio de trabajo.
Plantillas y el lenguaje de plantillas de Brevo Plantillas con un alias y versiones, renderizadas con Temple
Webhooks transaccionales, de marketing y de entrada Webhooks
Procesamiento de emails entrantes Emails entrantes
Contactos bloqueados (emails transaccionales) y contactos en la lista de bloqueados (campañas) Direcciones bloqueadas
Contactos, atributos y listas Contactos, campos personalizados y listas de contactos
Segmentos Elige y excluye listas de contactos en cada campaña. Los segmentos están en alfa y solo están abiertos al equipo de Emailit.
Campañas de email Campañas
Automatizaciones Automatizaciones (beta)
Formularios Formularios (acceso anticipado), o la URL de suscripción de una lista de contactos
tags y la cabecera X-Mailin-custom meta
IP dedicadas IP dedicadas bajo solicitud

Actualizar las llamadas a la API

POST /v3/smtp/email de Brevo pasa a ser POST /v2/emails. La clave pasa de la cabecera api-key a Authorization, y los nombres de los campos se acortan:

Antes: Brevo
curl https://api.brevo.com/v3/smtp/email \
  -H "api-key: $BREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": { "email": "hello@acme.com", "name": "Acme" },
    "to": [{ "email": "ada@example.com" }],
    "subject": "Your receipt",
    "textContent": "Thanks for your order.",
    "htmlContent": "<p>Thanks for your order.</p>"
  }'
Después: 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>"
  }'
Brevo Emailit
Cabecera api-key: xkeysib-… Authorization: Bearer secret_…
sender: { email, name } o sender: { id } from: "Name <email>"
to, cc, bcc con email y name to, cc, bcc como cadena o como array de hasta 50 cada uno
replyTo: { email, name } reply_to
subject, htmlContent, textContent subject, html, text
headers headers
attachment[] con content y name, o url attachments[] con content, filename y content_type, o url
templateId y params template (un alias o ID) y variables
tags, headers["X-Mailin-custom"] meta, que se devuelve en los eventos de webhook
scheduledAt (hasta 72 horas de antelación) scheduled_at (ISO 8601 o lenguaje natural en inglés)
headers.idempotencyKey (se conserva durante 30 minutos) Una cabecera HTTP Idempotency-Key, que se conserva durante 24 horas
messageVersions[] No disponible. Envía una petición por destinatario con sus propias variables.
headers["X-Sib-Sandbox"] No disponible
201 con messageId 200 con id (em_…), status: "accepted" y, con varios destinatarios, ids con un ID para cada uno

Brevo no tiene ajustes de seguimiento por email. En Emailit, tracking: { "loads": true, "clicks": true } sustituye la configuración de seguimiento del dominio para un email. Consulta Enviar un email.

Cambiar la configuración SMTP

Ajuste Brevo Emailit
Host smtp-relay.brevo.com smtp.emailit.com
Puerto 587 o 2525 (STARTTLS), 465 (TLS) 587, 2587, 2525 o 25 (STARTTLS), 465 (TLS)
Usuario Tu usuario SMTP, como …@smtp-brevo.com o la dirección de email de tu cuenta emailit
Contraseña Una clave SMTP Tu clave de API de Emailit

Emailit no lee las cabeceras de Brevo, como X-Mailin-custom o X-Mailin-Tag. Elimínalas y usa la API cuando necesites metadatos. Consulta Configuración SMTP.

Equivalencias de los eventos de webhook

Evento de Brevo Evento de Emailit
request (enviado) email.accepted (solo API)
delivered email.delivered
deferred email.attempted
soft_bounce email.attempted mientras Emailit reintenta, y después email.bounced si fallan todos los reintentos
hard_bounce email.bounced
invalid_email Un error en la respuesta de la API si la dirección tiene un formato incorrecto, o email.bounced si la dirección no existe
blocked email.suppressed
error email.failed
spam email.complained
opened, unique_opened, proxy_open email.loaded, que se envía con cada carga
click email.clicked
unsubscribed, unsubscribe email.unsubscribed, solo para los emails de campaña
list_addition subscriber.created
contact_updated, contact_deleted contact.updated, contact.deleted
inboundEmailProcessed email.received; después, obtén el contenido con GET /emails/{id}

El formato de las peticiones cambia:

  • Brevo envía un evento por petición, o lotes de hasta 500 si el envío por lotes está activado. Emailit envía un array JSON de hasta 100 eventos, así que recorre el cuerpo.
  • El nombre del evento pasa de event a type, y el email está en data.object. Usa data.object.id, el ID em_ de la respuesta de envío, en lugar de message-id, y data.object.to en lugar de email. Tus valores de meta, que sustituyen a tags y X-Mailin-custom, están en data.object.meta.
  • Para email.loaded y email.clicked, data.object es la carga o el clic. Usa data.object.email_id para el ID del email, y data.object.email.rcpt_to y data.object.email.meta para el destinatario y tus valores de meta.
  • Brevo no firma los webhooks; los proteges con credenciales o con un token. Emailit firma todas las peticiones: verifica X-Emailit-Signature con X-Emailit-Timestamp y tu secreto whsec_. Consulta Verificar las firmas de los webhooks.
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);
}

Trasladar las direcciones bloqueadas

Brevo tiene dos listas de bloqueados. Trasládalas las dos:

  1. Contactos bloqueados de los emails transaccionales. Expórtalos desde Settings > Transactional emails > Blocked or Unsubscribed contacts, o recorre las páginas de GET /v3/smtp/blockedContacts. Usa el tipo recipient para todos. Brevo bloquea una dirección para un remitente, y Emailit la bloquea para todo el espacio de trabajo.

  2. Contactos de campañas en la lista de bloqueados. En CRM > Contacts, filtra por la suscripción a campañas de email Blocklisted y exporta, o usa POST /v3/contacts/export. Usa el tipo recipient para los rebotes duros y las quejas por spam, y unsubscribe para las bajas. El tipo unsubscribe detiene todas las campañas pero sigue dejando pasar los emails transaccionales, así que no lo añadas para las personas que solo dejaron una lista y siguen suscritas a otra.

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

    CSV
    email,type,reason
    old-address@example.com,recipient,brevo hard bounce
    left@example.com,unsubscribe,brevo unsubscribed
  4. Impórtalo. En Email APISuppressions, 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.

Los dominios bloqueados no tienen equivalente, porque Emailit bloquea direcciones exactas. Consulta Gestionar las direcciones bloqueadas.

Trasladar los contactos

  1. Crea los campos personalizados. Por cada atributo de contacto de Brevo que uses, salvo EMAIL, FIRSTNAME y LASTNAME, crea un campo personalizado en Emailit. Las claves van en minúsculas, así que COMPANY pasa a ser company.

  2. Crea las listas de contactos, una por cada lista de Brevo a la que envías campañas.

  3. Exporta cada lista desde CRM > Contacts con More actions > Export, incluidos los atributos y el estado de suscripción. Deja fuera los contactos de la lista de bloqueados y a las personas que se dieron de baja de la lista.

  4. Impórtala. En Email MarketingContacts, selecciona Import, asigna EMAIL, FIRSTNAME, LASTNAME y tus atributos, y elige la lista de contactos correspondiente. Divide los archivos en partes de hasta 2500 filas. Consulta Importar y exportar contactos.

La importación añade como suscritas a todas las personas del archivo, así que comprueba que el archivo no contenga bajas antes de importarlo.

Trasladar las plantillas

Obtén el HTML de cada plantilla con GET /v3/smtp/templates/{templateId} para las plantillas transaccionales, o con GET /v3/emailCampaigns/{campaignId} para las campañas. Los dos lo devuelven en htmlContent. Impórtalo en Email MarketingTemplates o crea la plantilla con la API de plantillas, y asígnale un alias, como receipt.

Convierte el lenguaje de plantillas de Brevo a Temple:

Brevo Emailit (Temple)
{{ params.name }}, {{ params.order.total }} {{name}}, {{order.total}}
{{ contact.FIRSTNAME }}, {{ contact.LASTNAME }} {{first_name}}, {{last_name}} en las campañas
{{ contact.COMPANY }} {{cf.company}} en las campañas
{{ params.name|default:"there" }} {{name|"there"}}
{% if params.plan %}…{% else %}…{% endif %} {{#if plan}}…{{else}}…{{/if}}
{% if params.plan == "pro" %}, {% elif %} No compatible. Pasa un booleano como is_pro y usa {{#if is_pro}}.
{% for item in params.items %}…{% endfor %} No compatible. Genera la lista en tu código y pásala como una sola variable.
Filtros como upper o date No compatibles. Da formato al valor en tu código.
{{ unsubscribe }} {{unsubscribe_url}} en las campañas
{{ update_profile }} {{manage_subscriptions_url}} en las campañas
{{ mirror }} {{webview_url}} en las campañas

Brevo escapa el HTML salvo que añadas safe. Temple nunca escapa el HTML, así que escapa los datos que introducen los usuarios antes de pasarlos. Consulta Lenguaje de plantillas Temple y Etiquetas de combinación.

Volver a crear las campañas y las automatizaciones

Crea tus campañas en Email MarketingCampaigns a partir de las plantillas importadas. Vuelve a crear cada automatización de Brevo como una automatización de Emailit en el contexto Contact:

Disparador de Brevo Disparador de Emailit
Contacto añadido a una lista, quitado de una lista Added to audience, Removed from audience
Aniversario, o un atributo de fecha Date anniversary, Date in contact field
Formulario enviado Form submitted, para los formularios de Emailit (acceso anticipado)
Email abierto, clic en un enlace Email opened, Link clicked
Baja de una lista de email Unsubscribed
Evento personalizado Custom event, en los planes Business y Custom

Inicia cada automatización antes de trasladar tus formularios de suscripción, para que los contactos nuevos reciban sus emails desde el primer día.

Cambiar los DNS

Añade tu dominio en Email APIDomains 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 TXT brevo-code de Brevo ni con sus registros DKIM (brevo1._domainkey y brevo2._domainkey, o mail._domainkey en las configuraciones antiguas). Conserva tu registro DMARC. Consulta Registros DNS de los dominios de envío.

Después del cambio definitivo, elimina los registros de Brevo del código, de DKIM y del subdominio de marca, y quita include:spf.brevo.com o include:spf.sendinblue.com si tu registro SPF lo tiene. Si recibes correo con el procesamiento de emails entrantes de Brevo, trasládalo antes a un subdominio de entrada de Emailit.

Próximos pasos

¿Te ha resultado útil esta página?

Gracias por tu opinión.

Gracias. Leemos todos los mensajes.