Campañas¶

Para qué sirve: enviar comunicaciones salientes a una audiencia — broadcast de WhatsApp/Email, notificaciones, y —si tenés telefonía— campañas de discador.

Requisitos: permiso campaigns.read (ver) / campaigns.write (crear y ejecutar). El discador requiere Telefonía (voice_enabled).

Cómo llegar¶

Menú lateral → Campañas.

El listado¶

Pestañas: Todas, Mensajería, Discador; más filtros por Estado y Tipo, y Refrescar.
Columnas: Nombre, Tipo (broadcast/automática, predictiva, interactiva), Medio (WhatsApp, Email, Notificación interna), Audiencia, Miembros, Envíos, Última corrida, Acciones.
Botón Nueva campaña.

Mensajería (WhatsApp / Email)¶

Crear una campaña¶

Nueva campaña → elegí el medio (WhatsApp/Email) y la plantilla.
Definí la audiencia (filtros de contactos). Si usás grupos, en el selector de filtros aparece la categoría Grupos — podés apuntar a un grupo, o excluirlo.
Programá el envío (o lanzalo).
Pausá/reanudá según necesites.

Seguimiento¶

Mirá las métricas por campaña: enviados, entregados, leídos, clicks.

Audiencia por API (integraciones / n8n)¶

Además de armar la audiencia con filtros o subir un archivo, se puede inyectar la audiencia por API (para automatizaciones como n8n que cargan destinatarios y disparan el envío). El endpoint es POST /api/v1/campaigns/{id}/audience.

Reenviar a los mismos números (importante)¶

Por defecto, cada envío saltea a quien ya recibió la campaña en un envío anterior. Es a propósito: evita mandar dos veces el mismo mensaje a la misma persona. Por eso podés ver que:

Cargás 2 destinatarios pero se envía a 1 (el otro ya había recibido antes).
La campaña dice que tiene audiencia, pero la corrida muestra 0 destinatarios (todos ya recibieron).

Si tu caso sí necesita reenviar a los mismos números (ej. una encuesta nueva con un token distinto cada vez), en el payload usá:

"mode": "replace" → cada carga es solo ese lote (no se acumula con los anteriores).
"reprocesar": true → reenvía aunque el número ya haya recibido antes.

{
  "mode": "replace",
  "reprocesar": true,
  "launch": true,
  "recipients": [
    { "identity": "5491158889684", "button_urls": { "0": "<token>" } },
    { "identity": "5491121501511", "button_urls": { "0": "<token>" } }
  ]
}

No combines append + reprocesar

append acumula toda la audiencia histórica; con reprocesar reenviarías a todos los cargados alguna vez. Usá replace para que quede solo el lote actual.

Formato del número¶

Mandá siempre el número completo con código de país: 549 + área + número (ej. 5491158889684). Si a veces lo mandás con 549 y otras sin, el sistema los toma como contactos distintos (no los unifica) y puede haber rebotes.

Discador (opcional — Telefonía)¶

Campañas que llaman automáticamente a una lista:

Modo power (1:1) o predictivo.
Cargá la audiencia / pool de contactos.
Configurá disposiciones y reglas de reintento / abandono.

Tips y errores comunes¶

Para WhatsApp necesitás plantillas aprobadas por Meta.
Cuidá la frecuencia y la audiencia para no afectar la reputación del número.
"Cargué N pero se envió a menos" / "hay audiencia pero 0 destinatarios": es el dedup por número — no reenvía a quien ya recibió. Para reenviar a los mismos, ver Audiencia por API → Reenviar a los mismos números.