> ## 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.

# Campanhas

> Crie um rascunho, envie explicitamente e acompanhe cada resultado.

## Prepare um rascunho

Use um telefone ativo da conta e um modelo aprovado no cache da WABA correspondente. `POST /v1/broadcasts` exige `name`, `phoneNumberId`, `templateName`, `templateLanguage` e `recipients`.

Inclua de 1 a 500 números, preferencialmente somente dígitos sem `+`. Duplicados são removidos. Os `templateComponents` opcionais são iguais para todos, não personalizados por pessoa.

A criação produz um `draft` e não envia nada.

## Envie deliberadamente

> [!WARNING]
>
> `POST /v1/broadcasts/{broadcastId}/send` inicia uma campanha real. Revise destinatários, modelo e parâmetros antes.

A chamada altera `draft` para `queued`; o envio ocorre em segundo plano. A resposta imediata não é um relatório final de entrega. Uma campanha que não seja rascunho não pode ser enviada novamente.

## Acompanhe o progresso

`GET /v1/broadcasts/{broadcastId}` retorna campanha e destinatários. Os status incluem `draft`, `queued`, `sending`, `completed`, `cancelled`, `failed`. Isso não implica um endpoint público de cancelamento.

As contagens usam `pending`, `sent`, `failed`, `skipped`; status vazios podem ser omitidos. `sent` não significa entregue ou lido: use [webhooks de status](https://docs.watahub.dev/pt-BR/webhooks.md).

`GET /v1/broadcasts` lista as 100 mais recentes, da mais nova para a mais antiga.


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