Resposta curta
Para enviar mensagens no WhatsApp pela API, conecte uma WhatsApp Business Account por um parceiro da Meta ou pela Cloud API da Meta, colete o opt-in e aprove um modelo de mensagem. Use o modelo para iniciar a conversa. Depois que o cliente responder, você pode enviar texto livre, mídia ou mensagens interativas na janela de atendimento de 24 horas.
O que você precisa antes do primeiro envio
- Uma WhatsApp Business Account (WABA), geralmente criada pelo fluxo de Embedded Signup da Meta de um parceiro, com número de telefone comercial e nome de exibição verificados.
- Pelo menos um modelo de mensagem aprovado na categoria marketing, utilidade ou autenticação.
- O opt-in de cada destinatário, como exigem as políticas da Meta.
- Um acordo de cobrança. Desde 1º de julho de 2025, a Meta cobra por mensagem entregue, conforme a categoria e o mercado do destinatário; consulte a tabela de preços atual da Meta.
Modelo ou mensagem livre?
A partir de 1º de outubro de 2026, a Meta também passa a cobrar mensagens de serviço e modelos de utilidade enviados dentro da janela, após 1.000 mensagens de serviço gratuitas por número de telefone comercial a cada mês.
| Situação | O que você pode enviar |
|---|---|
| Você inicia a conversa | Somente um modelo aprovado |
| O cliente enviou mensagem nas últimas 24 horas | Qualquer tipo de mensagem: texto, mídia, interativa ou modelo |
| A janela de 24 horas foi encerrada | Somente um modelo aprovado |
| Envio de uma senha de uso único | Um modelo de autenticação |
Passo a passo do envio
- Crie o modelo com nome, idioma, categoria e valores de exemplo para as variáveis, e envie-o para análise da Meta.
- Aguarde até o status do modelo ficar como aprovado.
- Chame o endpoint de envio com o destinatário, o nome do modelo, o idioma e os valores das variáveis.
- Guarde o ID retornado e acompanhe SENT, DELIVERED, READ ou FAILED no seu webhook.
Exemplo: enviando um modelo
Na OmniChannels.ai, toda mensagem de WhatsApp passa por POST https://api.broadnet.me/whatsapp/message/sendbulk como multipart form data com um token Bearer. Defina messageType como MODELO e informe destinationNo, templateName, templateLanguage e bodyTemplateVariables. A chamada retorna um batchId, e os status de cada destinatário chegam no seu webhook ou via GET /whatsapp/message/bulk-insights.