---
title: "Como enviar mensagem no WhatsApp pela API?"
description: "Como enviar mensagens no WhatsApp pela API: conecte uma WhatsApp Business Account, aprove modelos, respeite a janela de 24 horas e acompanhe cada entrega."
canonical: "https://omnichannels.ai/pt/answers/send-whatsapp-message-api/"
language: "pt"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Como enviar mensagem no WhatsApp pela API?

Canonical: https://omnichannels.ai/pt/answers/send-whatsapp-message-api/
Language: pt
Publisher: OmniChannels.ai by BroadNet Technologies

**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

1. Crie o modelo com nome, idioma, categoria e valores de exemplo para as variáveis, e envie-o para análise da Meta.
2. Aguarde até o status do modelo ficar como aprovado.
3. Chame o endpoint de envio com o destinatário, o nome do modelo, o idioma e os valores das variáveis.
4. 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.

## Fontes oficiais

- [Template fundamentals — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)
- [Send messages: customer service windows — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages)
- [Pricing on the WhatsApp Business Platform — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)
- [Embedded Signup — Meta for Developers](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview)

## Perguntas relacionadas

- https://omnichannels.ai/pt/answers/whatsapp-24-hour-window/
- https://omnichannels.ai/pt/answers/how-to-get-whatsapp-business-api/
- https://omnichannels.ai/pt/answers/whatsapp-template-rejected/
- https://omnichannels.ai/pt/answers/whatsapp-otp-authentication-template/
- https://omnichannels.ai/pt/answers/delivery-report-webhook/

Atualizado em: 2026-10-10