> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Brevo

> Añade Brevo a tu proyecto de Macaly

Brevo (antes Sendinblue) es una plataforma de email marketing que también incluye SMS, campañas de WhatsApp y un CRM integrado. Si necesitas algo más que boletines, Brevo agrupa varios canales de comunicación en una sola herramienta.

<Callout icon="user">
  Disponible en todos los planes
</Callout>

<Note>
  **¿Realmente necesitas Brevo?** Macaly tiene una [base de datos integrada](/docs/es/features/databases) y notificaciones por correo. Si solo necesitas un formulario de contacto o una lista de espera, no necesitas una herramienta externa. Brevo merece la pena cuando necesitas boletines, secuencias automatizadas, campañas de SMS o un CRM para gestionar tus contactos.
</Note>

## Por qué usar Brevo

* **Envía boletines y correos de marketing.** Usa el editor de arrastrar y soltar o plantillas HTML sin tocar código.
* **Automatiza tus seguimientos.** Crea series de bienvenida, correos de carrito abandonado y campañas de reenganche que funcionan solas.
* **Llega a la gente por varios canales.** Envía campañas de correo, SMS y WhatsApp desde la misma plataforma.
* **Gestiona contactos sin un CRM aparte.** Rastrea acuerdos y segmenta tu audiencia todo en un mismo lugar.

## Qué necesitas

Antes de empezar, asegúrate de tener:

* Una **cuenta de Brevo**. Crea una gratis en [brevo.com](https://www.brevo.com)
* Una **lista de contactos** en Brevo en la que recopilar suscriptores

Hay dos formas de conectar Brevo a tu sitio:

* **Formulario de registro incrustado.** Pega el código de formulario generado por Brevo en tu sitio. Ideal para recopilar correos de forma sencilla.
* **API de Brevo.** Conecta tus formularios a la API de Brevo para tener control total sobre qué datos envías. Ideal cuando quieres formularios personalizados que combinen con tu diseño.

## Opción 1: formulario de registro incrustado

El enfoque más sencillo. Brevo genera un formulario que puedes insertar en tu sitio.

<Steps>
  <Step title="Obtén el código de tu formulario incrustado">
    En Brevo, ve a **Contacts** y luego **Forms**. Crea un formulario de suscripción nuevo (o usa uno existente), personalízalo y copia el código incrustado.
  </Step>

  <Step title="Pide al agente que lo añada">
    Abre el chat en tu proyecto de Macaly y pregunta:

    ```
    Añade este formulario de registro de Brevo a mi sitio. Aquí tienes el código incrustado:

    [pega aquí tu código incrustado de Brevo]
    ```
  </Step>

  <Step title="El agente coloca el formulario">
    El agente añade el formulario a tu proyecto. Dile dónde quieres que vaya: pie de página, barra lateral, página dedicada o ventana emergente.
  </Step>
</Steps>

<Tip>
  Si quieres que el formulario combine con el diseño de tu sitio, dile al agente: *"Adapta el estilo del formulario de Brevo para que combine con el resto de mi sitio."*
</Tip>

## Opción 2: formulario personalizado con la API de Brevo

Para más control, el agente puede crear un formulario personalizado que envíe suscriptores a Brevo a través de su API.

<Steps>
  <Step title="Añade tus credenciales de Brevo a Secretos">
    Ve a **Ajustes** y luego **Secretos** en tu proyecto de Macaly. Añade dos secretos:

    * `BREVO_API_KEY`: tu clave de API de Brevo
    * `BREVO_LIST_ID`: la lista de contactos a la que quieres añadir los suscriptores

    <Accordion title="Cómo encontrar tu clave de API y el ID de lista">
      **Clave de API:**

      1. En Brevo, haz clic en tu nombre arriba a la derecha y luego en **SMTP & API**
      2. Ve a la pestaña **API Keys**
      3. Haz clic en **Generate a new API key** y cópiala

      **ID de lista:**

      1. Ve a **Contacts** y luego **Lists**
      2. Haz clic en la lista que quieres usar
      3. Tu **List ID** aparece en la URL y en los detalles de la lista
    </Accordion>
  </Step>

  <Step title="Pide al agente que cree el formulario">
    Abre el chat y pregunta:

    ```
    Crea un formulario de registro al boletín en el pie de página. Cuando alguien se suscriba,
    añádelo a mi lista de contactos de Brevo usando la API.
    He añadido mi clave de API y el ID de lista en Secretos.
    ```
  </Step>
</Steps>

<Warning>
  Nunca pegues claves de API directamente en el chat. Usa siempre **Ajustes** y luego **Secretos** para guardar credenciales sensibles. El agente puede leerlas desde ahí de forma segura.
</Warning>

## Verifica que funciona

<Steps>
  <Step title="Envía un registro de prueba">
    Visita tu sitio e introduce una dirección de correo de prueba en el formulario de registro.
  </Step>

  <Step title="Comprueba tus contactos en Brevo">
    Ve a **Contacts** en Brevo. Tu correo de prueba debería aparecer en la lista que conectaste.
  </Step>
</Steps>

## Datos útiles

* Si solo necesitas recopilar correos, la [base de datos integrada](/docs/es/features/databases) de Macaly es más sencilla y no requiere una cuenta externa
* Para cumplir con el RGPD, activa el **doble opt-in** en la configuración de tu formulario de Brevo
* La API de Brevo también puede enviar correos transaccionales (confirmaciones de pedido, restablecimiento de contraseña). Pídeselo al agente si también los necesitas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.