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

# Mailchimp

> Añade Mailchimp a tu proyecto de Macaly

Mailchimp te permite recopilar suscriptores de correo, enviar boletines y ejecutar campañas de email automatizadas. Si quieres crear y cultivar una lista de correo desde tu sitio de Macaly, Mailchimp es una de las formas más populares de hacerlo.

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

<Note>
  **¿Realmente necesitas Mailchimp?** 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. Mailchimp merece la pena cuando necesitas boletines, secuencias automatizadas o segmentación de audiencia.
</Note>

## Por qué usar Mailchimp

* **Haz crecer tu lista desde tu sitio.** Recopila suscriptores y gestiónalos en un solo lugar. Segméntalos por intereses, origen del registro o comportamiento.
* **Envía boletines sin tocar código.** Diseña y envía campañas de correo a tu audiencia. Prográmalas o envíalas al instante.
* **Automatiza tus seguimientos.** Configura correos de bienvenida, secuencias automatizadas y recordatorios de carritos abandonados que funcionan solos.
* **Ve qué funciona realmente.** Rastrea tasas de apertura, tasas de clics y qué enlaces generan más interacción.

## Qué necesitas

Antes de empezar, asegúrate de tener:

* Una **cuenta de Mailchimp**. Crea una gratis en [mailchimp.com](https://mailchimp.com)
* Una **audiencia de Mailchimp** (lista de correo) en la que recopilar suscriptores

Hay dos formas de conectar Mailchimp a tu sitio:

* **Formulario de registro incrustado.** Pega el código de formulario generado por Mailchimp en tu sitio. Ideal para recopilar correos de forma sencilla.
* **API de Mailchimp.** Conecta tus formularios a la API de Mailchimp 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. Mailchimp genera un formulario que puedes insertar en tu sitio.

<Steps>
  <Step title="Obtén el código de tu formulario incrustado">
    En Mailchimp, ve a **Audience** y luego **Signup forms** y luego **Embedded forms**. Personaliza los campos que quieras y copia el código HTML generado.
  </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 Mailchimp a mi sitio. Aquí tienes el código incrustado:

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

  <Step title="El agente coloca el formulario">
    El agente añade el formulario a tu proyecto. Puedes decirle exactamente dónde quieres que vaya, como el pie de página, una página dedicada o una 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 Mailchimp para que combine con el resto de mi sitio."*
</Tip>

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

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

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

    * `MAILCHIMP_API_KEY`: tu clave de API de Mailchimp
    * `MAILCHIMP_AUDIENCE_ID`: la audiencia a la que quieres añadir los suscriptores

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

      1. En Mailchimp, haz clic en tu icono de perfil y luego en **Account & billing**
      2. Ve a **Extras** y luego **API keys**
      3. Haz clic en **Create a key** y cópiala

      **ID de audiencia:**

      1. Ve a **Audience** y luego **All contacts**
      2. Haz clic en **Settings** y luego **Audience name and defaults**
      3. Tu **Audience ID** aparece en esta página
    </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 audiencia de Mailchimp usando la API.
    He añadido mi clave de API y el ID de audiencia 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 tu audiencia de Mailchimp">
    Ve a **Audience** y luego **All contacts** en Mailchimp. Tu correo de prueba debería aparecer como un suscriptor nuevo.
  </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 audiencia de Mailchimp. Esto envía un correo de confirmación antes de añadir a alguien a tu lista
* El agente también puede configurar formularios emergentes y deslizantes si quieres algo más llamativo que un registro en línea


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