# Migrar desde Brevo

> 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.

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](/es/docs/migrate/) 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](/es/docs/workspaces/). Cada espacio de trabajo tiene sus propios dominios, claves, miembros y créditos. |
| Claves de API | [Claves de API](/es/docs/developers/api-keys/): **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](/es/docs/domains/). 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](/es/docs/workspaces/production-access/) y solo entregan a los miembros del espacio de trabajo. |
| Plantillas y el lenguaje de plantillas de Brevo | [Plantillas](/es/docs/templates/) con un alias y versiones, renderizadas con [Temple](/es/docs/templates/temple/) |
| Webhooks transaccionales, de marketing y de entrada | [Webhooks](/es/docs/webhooks/) |
| Procesamiento de emails entrantes | [Emails entrantes](/es/docs/inbound/) |
| Contactos bloqueados (emails transaccionales) y contactos en la lista de bloqueados (campañas) | [Direcciones bloqueadas](/es/docs/suppressions/) |
| Contactos, atributos y listas | [Contactos](/es/docs/contacts/), [campos personalizados](/es/docs/contacts/custom-fields/) y [listas de contactos](/es/docs/audiences/) |
| Segmentos | Elige y excluye listas de contactos en cada campaña. Los [segmentos](/es/docs/segments/) están en alfa y solo están abiertos al equipo de Emailit. |
| Campañas de email | [Campañas](/es/docs/campaigns/) |
| Automatizaciones | [Automatizaciones](/es/docs/automations/) (beta) |
| Formularios | [Formularios](/es/docs/forms/) (acceso anticipado), o la [URL de suscripción](/es/docs/audiences/subscribe-url/) de una lista de contactos |
| `tags` y la cabecera `X-Mailin-custom` | `meta` |
| IP dedicadas | [IP dedicadas](/es/docs/deliverability/dedicated-ips/) 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:

```bash title="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>"
  }'
```

```bash title="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 "` |
| `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](/es/docs/email-api/send-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](/es/docs/smtp/settings/).

## 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}`](/es/docs/api-reference/emails/get/) |

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](/es/docs/webhooks/request-signature/).

```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 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.

Los dominios bloqueados no tienen equivalente, porque Emailit bloquea direcciones exactas. Consulta [Gestionar las direcciones bloqueadas](/es/docs/suppressions/manage/).

## 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](/es/docs/contacts/custom-fields/) 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 Marketing → Contacts**, 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](/es/docs/contacts/import-export/).

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 Marketing → Templates** o crea la plantilla con la [API de plantillas](/es/docs/api-reference/templates/create/), 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](/es/docs/templates/temple/) y [Etiquetas de combinación](/es/docs/campaigns/merge-tags/).

## Volver a crear las campañas y las automatizaciones

Crea tus campañas en **Email Marketing → Campaigns** a partir de las plantillas importadas. Vuelve a crear cada automatización de Brevo como una [automatización](/es/docs/automations/) 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](/es/docs/forms/) (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 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 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](/es/docs/domains/dns-records/).

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](/es/docs/inbound/set-up/) de Emailit.

## Próximos pasos

- [Lista de comprobación para pasar a producción](/es/docs/get-started/go-live/)
- [Crear una campaña](/es/docs/campaigns/create/)
- [Migración prioritaria](/es/docs/programs/priority-migration/): deja que los ingenieros de Emailit hagan la migración contigo

---
Fuente: https://emailit.com/es/docs/migrate/brevo/
