> ## Documentation Index
> Fetch the complete documentation index at: https://chatnorris.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Campañas

> Cómo crear y gestionar campañas de mensajes automáticos por WhatsApp o email.

# Campañas

Las campañas te permiten enviar mensajes automáticos a una lista de contactos en una fecha específica — por ejemplo, recordatorios de pago, avisos de vencimiento de contrato, confirmaciones de cita o cualquier comunicación programada.

<Note>
  Las campañas están disponibles en los planes **Standard** y **Plus**. El plan Standard incluye hasta 500 contactos por campaña; el plan Plus no tiene límite.
</Note>

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-lista-campanas.png" alt="TODO: captura de la lista de campañas con estados y barra de progreso" />
</Frame>

## Tipos de campaña

<Tabs>
  <Tab title="WhatsApp">
    Envía mensajes usando **plantillas aprobadas por Meta**. Debes tener un canal de WhatsApp conectado y una plantilla creada y aprobada en tu cuenta de Meta Business.

    Las plantillas pueden incluir variables personalizadas como el nombre del cliente, fecha de vencimiento o datos adicionales.
  </Tab>

  <Tab title="Email">
    Envía emails con asunto y cuerpo personalizados. Puedes usar variables como `{{name}}`, `{{due_date}}`, `{{custom1}}` y `{{custom2}}` para personalizar cada mensaje.
  </Tab>
</Tabs>

## Crear una campaña

<Steps>
  <Step title="Ve a Campañas">
    En el menú lateral, haz clic en **Campañas**, luego en **Nueva campaña**.
  </Step>

  <Step title="Completa la información básica">
    * **Nombre** — un nombre interno para identificar la campaña.
    * **Tipo** — WhatsApp o Email.
  </Step>

  <Step title="Configura el canal y el mensaje">
    <Tabs>
      <Tab title="WhatsApp">
        * **Canal** — elige el número de WhatsApp Business conectado.
        * **Nombre de la plantilla** — el nombre exacto de la plantilla aprobada en Meta Business Manager.
        * **Variables** — mapea las variables de la plantilla (ej. `{{1}}` → nombre del contacto, `{{2}}` → fecha de vencimiento).
      </Tab>

      <Tab title="Email">
        * **Nombre del remitente** — el nombre que verán los destinatarios.
        * **Asunto** — el asunto del email. Puedes usar variables: `Recordatorio para {{name}}`.
        * **Cuerpo del mensaje** — el contenido del email. Usa `{{name}}`, `{{due_date}}`, `{{custom1}}`, `{{custom2}}` para personalizar.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Define el trigger de envío">
    Elige cuándo debe enviarse el mensaje en relación a la fecha objetivo de cada contacto:

    | Opción             | Ejemplo                                                             |
    | ------------------ | ------------------------------------------------------------------- |
    | **X días antes**   | "3 días antes" → envía el recordatorio 3 días antes del vencimiento |
    | **El día**         | Envía exactamente el día del evento                                 |
    | **X días después** | "1 día después" → envía seguimiento al día siguiente                |
  </Step>

  <Step title="Guarda la campaña">
    La campaña se crea en estado **Borrador**. Aún no envía nada hasta que la actives.
  </Step>
</Steps>

## Agregar contactos a la campaña

<Steps>
  <Step title="Entra al detalle de la campaña">
    Desde la lista, haz clic en la campaña que creaste.
  </Step>

  <Step title="Agrega contactos">
    Puedes agregar contactos de dos formas:

    **Manual (uno por uno):**

    * Haz clic en **+ Agregar contacto**.
    * Completa: nombre, teléfono (para WhatsApp) o email, fecha objetivo y datos opcionales (custom1, custom2).

    **Por CSV (masivo):**

    * Haz clic en **Importar CSV**.
    * Descarga la plantilla CSV para ver el formato correcto.
    * Completa los datos y sube el archivo.

    <Tip>
      El CSV acepta las columnas: `name`, `phone`, `email`, `due_date`, `custom1`, `custom2`. La columna `due_date` debe estar en formato `YYYY-MM-DD`.
    </Tip>
  </Step>
</Steps>

## Activar y pausar una campaña

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-campana-detalle.png" alt="TODO: captura del detalle de una campaña con barra de progreso y tabla de contactos" />
</Frame>

Una vez que tienes contactos cargados:

* **Activar** — la campaña empieza a enviar mensajes según el trigger definido. El sistema verifica diariamente qué contactos deben recibir el mensaje ese día.
* **Pausar** — detiene los envíos sin eliminar los contactos. Puedes reactivarla cuando quieras.

## Ver el progreso

En la lista de campañas, cada campaña muestra:

* **Estado** — Borrador, Activa, Pausada o Completada.
* **Progreso** — barra que indica el % de contactos que ya recibieron el mensaje.
* **Enviados / Fallidos** — contador de mensajes enviados exitosamente y errores.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿A qué hora se envían los mensajes?">
    Los mensajes se envían diariamente a las 9:00 AM (hora del servidor). Los contactos cuya fecha coincida con el trigger ese día recibirán el mensaje.
  </Accordion>

  <Accordion title="¿Qué pasa si un envío falla?">
    El contacto pasa a estado **Fallido** y el motivo del error queda registrado en la tabla de contactos. El sistema no reintenta automáticamente.
  </Accordion>

  <Accordion title="¿Puedo eliminar un contacto de una campaña?">
    Sí. En la tabla de contactos del detalle de la campaña, cada fila tiene un botón para eliminar el contacto.
  </Accordion>

  <Accordion title="¿Puedo reutilizar los contactos de una campaña en otra?">
    Por ahora, los contactos están ligados a cada campaña. Para reutilizarlos, debes volver a importar el CSV en la nueva campaña.
  </Accordion>

  <Accordion title="¿Dónde creo una plantilla de WhatsApp?">
    Las plantillas de WhatsApp se crean y aprueban en **Meta Business Manager** bajo la sección de plantillas de mensajes (Message Templates). Meta puede tardar entre 24 y 48 horas en aprobar una plantilla nueva. Una vez aprobada, escribe el nombre exacto de la plantilla en la configuración de la campaña en ChatNorris.
  </Accordion>
</AccordionGroup>