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

# Campañas

> Envíos masivos de una plantilla a una audiencia de contactos, con resultado por destinatario.

<Info>Outbound → **Campañas** · Owner y Admin · Requiere un plan con campañas, un número de WhatsApp conectado y al menos una plantilla aprobada</Info>

## Antes de empezar

Una campaña necesita tres cosas ya creadas:

1. Un **número de WhatsApp** conectado en un departamento.
2. Una **[plantilla aprobada](/guia/07-outbound/plantillas)** en ese número.
3. Una **audiencia**: [grupos de contactos](/guia/07-outbound/contactos) o contactos sueltos.

Y una cuarta muy recomendable: una **[etiqueta](/guia/11-tags)** para que las respuestas lleguen al equipo correcto.

## Crear una campaña

**Crear campaña** abre un asistente de cuatro pasos. La vista previa del mensaje aparece a la derecha en cuanto eliges plantilla.

<Steps>
  <Step title="Básicos">
    | Campo                        | Notas                                                                                                                       |
    | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
    | **Nombre de la campaña**     | Interno, para ti (*Renovaciones noviembre*).                                                                                |
    | **Número de WhatsApp**       | Desde cuál se envía.                                                                                                        |
    | **Plantilla**                | Solo las aprobadas de ese número. Si no ves la tuya, sincroniza en Plantillas o espera la aprobación.                       |
    | **Etiqueta de conversación** | Las respuestas de esta campaña llegarán a Conversaciones con esta etiqueta; los agentes asignados a ella podrán atenderlas. |
  </Step>

  <Step title="Audiencia">
    Marca uno o varios **grupos** (con su número de miembros) y/o añade **contactos individuales** buscándolos por nombre, email o teléfono. El asistente muestra el **total estimado**; los repetidos se cuentan una sola vez y los dados de baja se excluyen automáticamente.
  </Step>

  <Step title="Variables">
    Solo aparece si la plantilla tiene variables. Para cada `{{variable}}` decides de dónde sale su valor **para cada destinatario**:

    | Origen                  | Ejemplo                                                                             |
    | ----------------------- | ----------------------------------------------------------------------------------- |
    | **Texto fijo**          | `{{producto}}` → *seguro de vehículo* para todos                                    |
    | **Campo del contacto**  | `{{nombre}}` → Nombre, Apellido, Nombre completo, Teléfono o Email de cada contacto |
    | **Campo personalizado** | `{{vencimiento}}` → el campo personalizado *Fecha de vencimiento* de cada contacto  |

    La vista previa muestra el mensaje con los datos del primer contacto elegido.
  </Step>

  <Step title="Programar">
    * **Enviar manualmente**: queda como *Borrador* y la disparas desde el listado cuando quieras.
    * **Programar**: fecha y hora futuras (hora de Guatemala).

    Revisa el **resumen** y pulsa **Crear campaña**.
  </Step>
</Steps>

## Estados de una campaña

| Estado         | Significado                                                                    |
| -------------- | ------------------------------------------------------------------------------ |
| **Borrador**   | Creada, sin enviar. Puedes **Enviar ahora** o **Cancelar**.                    |
| **Programada** | Se enviará a la fecha indicada. Puedes **Enviar ahora** o **Cancelar**.        |
| **Enviando**   | En curso, en segundo plano. No se puede detener.                               |
| **Completada** | Terminó de procesar todos los destinatarios (aunque algunos hayan fallado).    |
| **Pausada**    | Detenida por WhatsApp (por ejemplo, plantilla pausada o límite de mensajería). |
| **Fallida**    | No pudo iniciarse.                                                             |
| **Cancelada**  | Cancelada antes de enviar; no salió ningún mensaje.                            |

El listado muestra por campaña **Destinatarios**, barra de **Progreso** (enviados y fallidos) y **Entrega** (porcentaje entregado o leído sobre lo enviado).

## Leer los resultados

El detalle de una campaña se actualiza solo cada 5 segundos mientras está enviando y muestra seis contadores: **Total · Enviados · Entregados · Leídos · Fallidos · Omitidos**, más la tabla de destinatarios con filtro por estado.

| Estado del destinatario      | Significado                                                |
| ---------------------------- | ---------------------------------------------------------- |
| **Pendiente** / **Enviando** | En cola o en proceso                                       |
| **Enviado**                  | WhatsApp lo aceptó                                         |
| **Entregado**                | Llegó al teléfono                                          |
| **Leído**                    | El cliente lo abrió                                        |
| **Fallido**                  | No se entregó; la columna **Error** dice por qué           |
| **Omitido**                  | No se intentó: contacto dado de baja o sin teléfono válido |

### Fallos frecuentes y su solución

| Error                                        | Causa                                                                                                                                  | Solución                                                                                         |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| *131042: Business eligibility payment issue* | Tu cuenta de WhatsApp Business (WABA) no tiene método de pago válido en Meta. **Ningún mensaje saliente se entrega** hasta resolverlo. | Meta Business Suite → Configuración → Pagos → agregar un método de pago a la cuenta de WhatsApp. |
| Plantilla pausada o deshabilitada            | Meta la pausó por calidad                                                                                                              | Sincroniza Plantillas, revisa el estado y usa otra plantilla                                     |
| Número inválido                              | El contacto no tiene WhatsApp o el número está mal                                                                                     | Corrige el contacto                                                                              |
| Límite de mensajería                         | Superaste el tope diario de conversaciones iniciadas que Meta asigna a tu número (empieza en 250 y sube con la calidad)                | Espera 24 h o divide la audiencia en varios días                                                 |
| Todos fallan con *131042* o similar          | Casi siempre facturación del WABA                                                                                                      | Ver primera fila                                                                                 |

<Tip>
  **Después de enviar, mira Conversaciones.** Las respuestas llegan a la bandeja con la etiqueta de la campaña. Si el cliente responde, se abre la ventana de 24 horas y tus agentes (o la IA) pueden continuar sin plantilla.
</Tip>

## Automatizar

Todo el flujo (contactos, grupos, plantillas, campañas y resultados por destinatario) está disponible por API para lanzar campañas desde tu ERP o CRM. Ver el [tutorial paso a paso](/desarrolladores/tutorial-campana).
