Brevo

Descripción

Brevo (antes Sendinblue) es una plataforma de email, SMS y marketing. Los nodos de Brevo hablan con su API v3 por HTTPS (puerto 443), no por SMTP. Por eso funcionan aunque tu servidor tenga bloqueados los puertos 25, 465 y 587, algo habitual en proveedores cloud.

Nodo	Qué hace
brevoSendEmail	Envía un email transaccional con HTML, texto o una plantilla de Brevo.
brevoSendSms	Envía un SMS.
brevoUpsertContact	Crea un contacto, o lo actualiza si ya existe.
brevoGetContact	Lee un contacto con sus atributos y listas.
brevoUpdateContact	Cambia atributos, listas y bloqueos de un contacto.
brevoDeleteContact	Elimina un contacto (no se puede deshacer).
brevoListContacts	Lista contactos de la cuenta o de una lista, con paginación.
brevoManageList	Añade o quita contactos (hasta 150 por llamada) de una lista.

Credencial

Crea una credencial de tipo Brevo con tu clave de API v3 (empieza con xkeysib-). Se genera en Brevo → SMTP y API → Claves API. El botón Probar consulta tu cuenta sin modificar nada.

Para enviar emails, el remitente debe estar validado en Brevo (Remitentes, dominios e IP). Si no lo está, Brevo rechaza el envío con un error de validación.

Salida

Todos los nodos añaden su resultado a data.brevo y conservan el resto de data. Puedes cambiar el nombre con Clave de salida.

{
  "ticket": 7,
  "brevo": { "success": true, "messageId": "<202610211000.123@smtp-relay.mailin.fr>" }
}

Usa {{data.brevo.messageId}} en los nodos siguientes. En brevoGetContact el contacto está en data.brevo.contact, y en brevoListContacts la lista está en data.brevo.contacts.

Ante un error el nodo no continúa y devuelve error.type: validation, auth_error, not_found, rate_limited, timeout u otro. Los límites de uso (429), los errores 5xx y los fallos de red se reintentan solos hasta 3 veces.

brevoSendEmail

Parámetro	Requerido	Descripción
credentials_id	Sí	Credencial Brevo.
sender_email / sender_name	Según caso	Remitente validado. Opcional si la plantilla ya lo define.
to	Sí	Uno o varios destinatarios separados por coma. Admite Ana <ana@cliente.com>.
subject	Según caso	Asunto. Obligatorio si no usas plantilla.
html_content / text_content	Según caso	Contenido. Hace falta alguno si no usas plantilla.
template_id	No	ID de una plantilla de Brevo. Con ella no hace falta contenido.
params	No	JSON con los parámetros de la plantilla, ej. {"nombre":"Ana"}.
cc, bcc, reply_to	No	Copias y dirección de respuesta.
tags	No	Etiquetas separadas por coma para las estadísticas.
attachment_urls	No	URLs públicas de adjuntos, separadas por coma.
scheduled_at	No	Fecha ISO 8601 para programar el envío.

brevoSendSms

El teléfono lleva prefijo de país y solo dígitos (34600111222; se limpian espacios, guiones y el +). El remitente admite hasta 11 letras o números, o hasta 15 dígitos. Cada SMS consume créditos de tu cuenta de Brevo.

Contactos y listas

• Los atributos usan los nombres de Brevo en mayúsculas: {"FIRSTNAME":"Ana","LASTNAME":"Pérez"}.
• En brevoGetContact, brevoUpdateContact y brevoDeleteContact, el identificador puede ser el email, el ID de contacto, un ID externo o el teléfono. Elige el Tipo de identificador que corresponda.
• brevoListContacts devuelve hasta 1000 contactos por llamada. Usa Desplazamiento para paginar y Modificados desde para sincronizar solo lo nuevo.

Ejemplo: enviar un correo cuando llega un formulario

1. Un disparador de formulario recibe email y nombre.
2. brevoSendEmail con to = {{email}}, template_id = tu plantilla y params = {"nombre":"{{nombre}}"}.
3. brevoUpsertContact con el mismo email y list_ids = la lista de bienvenida.

Privacidad

El contenido de los emails, los SMS y los datos de contactos salen de Floogos hacia Brevo (un tercero) y se rigen por tus condiciones con Brevo. Brevo cobra el consumo según tu plan.