Marcio Cunha
Volver al Blog
BackendAutomação

Cómo Crear Plantillas Visuales en Brevo y Dispararlas mediante Llamadas de API

Aprende el paso a paso para diseñar diseños de correo en el constructor visual de Brevo y automatizar envíos masivos o transaccionales usando llamadas de API.

Marcio Cunha•2 min
También disponible en:PortuguêsEnglish
Resumen
  • El diseño queda en el constructor de Brevo. La API solo envía el número de la plantilla y los datos.
  • Las variables del envío usan params en el cuerpo y en la plantilla.
  • La plantilla tiene que estar activa. Un borrador no se envía.
  • La llamada es POST a /v3/smtp/email con la cabecera api-key.
  • 401 es la clave. 400 suele ser templateId o un parámetro que el diseño esperaba y no llegó.

Qué queda en el panel y qué queda en el código

Brevo separa el diseño del correo del envío. Marketing arma el HTML en el constructor visual, con columnas, botón y logo. El backend no reenvía ese HTML. Manda el identificador numérico de la plantilla y un objeto con los textos que cambian en cada destinatario.

Ese número, templateId, aparece en el detalle de la plantilla transaccional. Mientras la plantilla esté en borrador, la API rechaza el envío. Actívala en el panel antes de probar la llamada.

Paso a paso

Crea la plantilla, marca los huecos dinámicos y solo entonces llama a la API. La clave se queda en el servidor, nunca en el navegador.

  1. En el panel de Brevo, crea una plantilla transaccional y termina el diseño en el constructor.
  2. Donde el texto cambia, inserta una variable params, por ejemplo el nombre del destinatario. Guarda y activa la plantilla.
  3. Copia el ID numérico. Crea una clave de API con permiso de envío y guárdala solo en el entorno del servidor.
  4. Envía POST a https://api.brevo.com/v3/smtp/email con la cabecera api-key y el cuerpo JSON.
  5. En el cuerpo, informa sender, to con el correo del destinatario, templateId y params con las mismas claves dibujadas en el diseño.
  6. Lee la respuesta. 201 significa que Brevo aceptó el envío. Abre el correo y comprueba que el nombre sustituyó el hueco.
curl -X POST https://api.brevo.com/v3/smtp/email \
  -H 'api-key: TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"sender":{"email":"[email protected]"},"to":[{"email":"[email protected]"}],"templateId":12,"params":{"nombre":"Ana"}}'

En el diseño, el hueco correspondiente usa la clave nombre dentro de params. Si el constructor muestra otro prefijo, usa el que la propia vista previa de Brevo sustituye y envía esa misma clave en params.

Errores frecuentes

La mayoría de los fallos son de alta, no de HTTP. El JSON puede estar bien y la plantilla seguir inactiva.

  • 401: la clave falta, fue revocada o no tiene permiso SMTP.
  • 400 con templateId: el número no existe en esta cuenta o la plantilla sigue en borrador.
  • El correo sale con el hueco en blanco: la clave en params no es la dibujada en el diseño.
  • El remitente tiene que ser un dominio autenticado en Brevo. Un correo suelto suele rechazarse.

Conclusión

El constructor guarda el visual. La llamada manda templateId, destinatario y params. Con la plantilla activa, ese es el puente entero.

Cambiar un texto del diseño no exige deploy. Cambiar una clave de params exige acertar los dos lados: el bloque en el constructor y el objeto en el JSON.