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

# Campañas

> Crea un borrador, envíalo expresamente y sigue cada resultado.

## Prepara un borrador

Usa un teléfono activo de la cuenta y una plantilla aprobada en la caché de su WABA. `POST /v1/broadcasts` requiere `name`, `phoneNumberId`, `templateName`, `templateLanguage` y `recipients`.

Incluye entre 1 y 500 números, preferiblemente solo dígitos sin `+`. Se eliminan duplicados. Los `templateComponents` opcionales son iguales para todos, no personalizados por persona.

Crear produce un `draft` y no envía nada.

## Envía de forma deliberada

> [!WARNING]
>
> `POST /v1/broadcasts/{broadcastId}/send` inicia una campaña real. Revisa antes destinatarios, plantilla y parámetros.

La llamada cambia `draft` a `queued`; el envío ocurre en segundo plano. La respuesta inmediata no es un informe final de entrega. Una campaña que no sea borrador no puede volver a enviarse.

## Sigue el avance

`GET /v1/broadcasts/{broadcastId}` devuelve campaña y destinatarios. Los estados incluyen `draft`, `queued`, `sending`, `completed`, `cancelled`, `failed`. Esto no implica que exista un endpoint público para cancelar.

Los conteos usan `pending`, `sent`, `failed`, `skipped`; pueden omitir estados vacíos. `sent` no significa entregado ni leído: usa [webhooks de estado](https://docs.watahub.dev/es/webhooks.md).

`GET /v1/broadcasts` lista las 100 más recientes, de nueva a antigua.


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