Saltar al contenido principal

​
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

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. GET /v1/broadcasts lista las 100 más recientes, de nueva a antigua.