Pular para o conteúdo principal

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

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. GET /v1/broadcasts lista as 100 mais recentes, da mais nova para a mais antiga.