API oficial do WhatsApp Business API Cloud a partir de R$39/canalAPI de Negócios do WhatsApp

WhatsApp Business API é a interface programática da WhatsApp Business Platform. Ela permite que aplicações enviem e recebam mensagens, reajam a eventos, automatizem conversas, gerenciem modelos e construam experiências interativas.

curl -X POST "$WHATSAPP_API/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15550001234",
    "type": "text",
    "text": { "body": "Your order is on the way." }
  }'

Veja o início rápido

Mesma mensagem. Três produtos diferentes.

WhatsApp Business API não é outro aplicativo do WhatsApp. É uma infraestrutura que os desenvolvedores usam para conectar o WhatsApp com software.

O Aplicativo de Negócios é um produto que você usa. A API de Negócios é a infraestrutura com a qual você constrói.

Se uma ou duas pessoas respondem a um punhado de clientes manualmente, o Business App é suficiente.

Wrappers e emuladores não oficiais não são a API de Negócios: eles colocam em risco o banimento de números, causam a perda de sessões e não são adequados para nada que você não possa se dar ao luxo de perder.

Os nomes em torno da API são uma confusão à parte. WhatsApp Business API, Cloud API e On-Premises são usados como se fossem a mesma coisa. Não são — e a próxima seção é a última vez que esta página vai parar para falar sobre os nomes.

Hoje é chamado de Cloud API

A Plataforma de Negócios do WhatsApp é o nome da Meta para toda a pilha de negócios no WhatsApp — números, contas, modelos, mensagens e o restante.

A API da nuvem é como você se comunica com essa plataforma hoje: a Meta a hospeda, você envia solicitações e recebe webhooks. Você não roda um servidor do WhatsApp.

A API On-Premises era a geração anterior, auto-hospedada. O envio de mensagens através dela foi descontinuado. Se um tutorial ainda te aconselha a instalar o On-Premises, ele está descrevendo uma pilha que você não deve construir.

As pessoas procuram pela WhatsApp Business API e se referem à Cloud API na Plataforma Empresarial. Essa fórmula é suficientemente próxima para navegar pela documentação — com uma ressalva: a plataforma é mais ampla do que um único ponto de mensagem.

Uma vez que os nomes estejam definidos, a verdadeira pergunta é por que deixar um aplicativo gratuito.

Por que usar a WhatsApp Business API

Mantenha o aplicativo quando fizer a troca, deixe seu backend ver qual anúncio iniciou o chat e execute o número pelo software — não pelo telefone.

A automação, os ganchos de CRM e a escalabilidade aparecem mais adiante nesta página. Este bloco é a parte que a maioria dos artigos ainda erra - ou nunca menciona.

Trocar não tira o aplicativo.

As equipes atrasam a API porque acham que o WhatsApp Business App precisa sair. Não precisa. O mesmo número pode funcionar no app e na API ao mesmo tempo: as pessoas continuam respondendo onde já trabalham, e o software envia notificações e gerencia as mensagens recebidas ao mesmo tempo. Você está adicionando a API. Você não está confiscando o chat que sua equipe já usa.

A coexistência tem limites — quais recursos do aplicativo permanecem disponíveis, como a sincronização de histórico. Verifique a documentação da Meta para a lista atual antes de depender de um recurso específico. A ação em si está em Começar.

Seu backend vê qual anúncio iniciou o chat.

Um anúncio Click-to-WhatsApp no Facebook ou Instagram pode abrir um chat com o aplicativo para negócios. O produto de anúncio não é exclusivo da API. O que a API adiciona é o evento: o webhook que entrega a primeira mensagem também carrega qual anúncio e qual fonte iniciaram a conversa. Isso é suficiente para atribuir a conversa e responder ou direcioná-la em software.

O número vive em software.

O App de Negócios vive em um telefone. A API não. O número é um objeto em seus sistemas: nenhum aparelho precisa ficar online, várias aplicações e vários agentes podem usá-lo ao mesmo tempo, e o canal não depende de quem está segurando o dispositivo hoje.

Como funciona

Duas direções, um modelo. Se você implementar apenas o outbound, você construiu metade de um canal.

Customer ↔ WhatsApp ↔ WhatsApp Cloud API ↔ Your backend — do backend: CRM, AI, Support.

1. Seu aplicativo envia solicitações de API. Uma chamada de saída é uma solicitação HTTP: uma mensagem, um modelo, um upload de mídia. O WhatsApp não está consultando seu servidor.

2. WhatsApp entrega a mensagem. A infraestrutura da Meta coloca no telefone do usuário. Você não opera esse caminho.

3. Webhooks enviam eventos de volta. Mensagens de entrada e os status que informam se uma mensagem foi enviada, entregue, lida ou falhou, chegam como callbacks. Sua aplicação reage. Ela não pergunta «alguma novidade?»

Capacidade da API

A WhatsApp Business API não é um endpoint de «enviar mensagem» com extras. Esta é a interface que você está realmente integrando.

Mensagens

Envie e receba mensagens no WhatsApp.

Texto é o início, não o produto. A mesma API envia e recebe imagens, vídeos, áudios e documentos — você faz o upload e download de mídias em vez de anexá-las de um telefone — além de localização, contatos, reações e adesivos.

Experiências interativas

Transforme uma conversa em uma interface.

Botões de resposta, listas, chamadas para ação e respostas estruturadas coletam uma escolha sem analisar texto livre. Fluxos do WhatsApp são mini-formulários nativos dentro da conversa: reserva, aplicações, pesquisas, registro, onboarding — o usuário não sai do WhatsApp para enviar um formulário.

Modelos e mensagens de saída

Inicie conversas que o canal realmente entregará.

Um negócio que escreve primeiro usa modelos que a Meta revisou: Utilitário, Autenticação, Marketing. Modelos existem porque o WhatsApp é um canal com permissão. A revisão ocorre antes da primeira mensagem de saída, não após uma reclamação. Essa é uma fricção intencional — e é por isso que mensagens de sessão e mensagens modelos não são intercambiáveis em seu código.

Eventos e webhooks

Reaja enquanto a conversa estiver acontecendo.

Webhooks entregam mensagens recebidas; estados de enviado, entregue, lido e falhado; erros; respostas a mensagens interativas; pedidos; eventos de chamadas; eventos de contas; e o contexto de clique quando uma conversa começou a partir de um anúncio. O aplicativo que ignora webhooks pode enviar. Ele não pode operar.

Comércio

Coloque um catálogo na conversa.

Catálogos de produtos, mensagens de produto único e múltiplo, carrosséis, pedidos e configurações de comércio permitem que alguém navegue e compre sem ser enviado a uma loja aleatória. O catálogo é um objeto de negócio, não um PDF que você anexa.

Chamando

Coloque o WhatsApp voice no mesmo backend que o chat.

Receba e faça chamadas WhatsApp a partir do seu aplicativo. Conecte um PBX ou um centro de atendimento — incluindo via SIP — quando a parte de voz deve pertencer ao mesmo registro de cliente que o fluxo.

Gestão empresarial

Gerencie a conta do WhatsApp como um software, não como uma configuração de telefone.

Números de telefone, perfis de negócios, contas do WhatsApp Business, modelos, códigos QR e conta são objetos da API. O Cadastro Embutido é a janela nativa da Meta para conectar o WhatsApp de um cliente ou de uma filial sem um ticket. Esse caminho é importante se você conectar o WhatsApp para outros negócios, não apenas para si mesmo.

Escala e operações

Saiba o que o canal permitirá antes de prometer uma data de lançamento.

Limites de mensagens, classificação de qualidade e capacidade de envio — incluindo aumentos automáticos de capacidade — determinam quanto você pode enviar. Os status de entrega e erros informam o que realmente aconteceu. A mecânica pertence a esta página; os números atuais estão na documentação da Meta porque eles mudam.

Você não pode simplesmente enviar mensagens pra todo mundo

WhatsApp não é uma lista que você faz upload. Se a integração assumir que uma planilha de números é suficiente para escrever primeiro, estará errada desde o primeiro dia — no código, e não apenas na política.

• Iniciado pelo cliente. A pessoa escreveu primeiro. Dentro da janela de atendimento ao cliente, você pode responder de forma livre. Quando a janela se fecha, você volta para os modelos.

• Iniciado pela empresa. Você escreve primeiro apenas com um modelo aprovado, por um motivo que a pessoa pode razoavelmente esperar.

• Opt-in. Eles concordaram em ouvir de você, e esperam o tipo de mensagem que você está enviando. Opt-in não é uma brecha em relação a modelos.

Uma conversa não precisa começar na caixa de entrada. Um anúncio Click-to-WhatsApp, um código QR ou um botão no seu site ainda significa que o usuário está iniciando o tópico. Alguns desses pontos de entrada utilizam uma janela de atendimento diferente. A ideia é estável; os temporizadores não são — use a Documentação da Meta, não um número desta página.

O que custa

Não existe um único «preço da WhatsApp Business API». Há uma estrutura de custos. As tarifas mudam; essa forma não muda.

Seu custo total = encargos de mensagens do WhatsApp + encargos da plataforma ou sua própria infraestrutura

• Meta. Você paga por mensagens do WhatsApp. O valor depende do tipo de mensagem, do mercado e do modelo de preços atual da Meta — que já mudou e mudará novamente. Esta página não cita tarifas.

• Uma plataforma. Os fornecedores cobram uma assinatura, um acréscimo sobre as mensagens, uma taxa por número, às vezes uma taxa de instalação — frequentemente uma mistura. Compare a conta completa, não apenas uma linha em uma tabela de preços.

• Direct to Cloud API. Não há fatura do provedor. Ainda há uma conta: hospedagem, um banco de dados, armazenamento de mídia, filas, monitoramento e o tempo de engenharia para manter essa pilha correta quando a API se mover.

Os preços para 1MSG estão no cabeçalho e rodapé do site. Eles não são repetidos aqui.

Construa você mesmo ou use uma plataforma

Uma API te dá capacidades. Ela não te dá um produto.

Se você se conectar diretamente à API do WhatsApp Cloud, você obtém os elementos básicos para construir seu próprio produto do WhatsApp. Você decide como as mensagens são armazenadas, exibidas, roteadas e integradas ao restante da sua estrutura. Twilio, 1MSG, respond.io e os demais existem porque essa segunda parte é um trabalho real — não porque o WhatsApp é diferente dependendo do fornecedor.

WhatsApp Business API te oferece: Mensagens, webhooks, modelos, mídia, Flows, chamadas, objetos de negócios.

Uma plataforma adiciona: Uma caixa de entrada, histórico de conversas, ferramentas para agentes, integrações com CRM, automação, análises, registros, tentativas, gerenciamento de usuários, ganchos de IA, faturamento e ferramentas para desenvolvedores.

A diferença aparece como tempo até a produção, o que você paga para manter as luzes acesas e quem está acordado quando os webhooks falham às 2 da manhã. API em nuvem não é pior. É incompleta como produto.

Como você obtém acesso é uma pergunta separada de como você armazena mensagens. Três caminhos: seu próprio aplicativo Meta, um BSP ou um Provedor de Tecnologia. O que muda é quem detém a Conta do WhatsApp Business e o número, se um BSP é necessário e se você pode levar o número para outro lugar. Um BSP não é obrigatório. Através de um Provedor de Tecnologia, o WABA e o número podem continuar sendo seus, com o Embedded Signup como o fluxo de conexão. Os detalhes estão nas perguntas frequentes — esta página não é um contrato.

Tudo que você precisa para construir no WhatsApp

A versão burocrática dessa história é um mês de tickets da Meta antes de um Olá Mundo. A versão prática é uma lista de verificação curta e, em seguida, uma primeira mensagem.

O que você precisa

• Um portfólio de negócios da Meta

• Uma conta do WhatsApp Business

• Um número de telefone comercial

• Verificação de número

• Verificação de negócios quando a Meta exige — nem em todos os casos

• Um token de acesso

• Um endpoint de webhook

Um número de teste e uma conexão de sandbox, webhooks e a primeira mensagem em uma linha. A lista de verificação é como a produção se parece, não o custo de uma tentativa.

Passos

1. Crie ou conecte-se a uma conta do WhatsApp Business

2. Adicione seu número de telefone comercial

3. Conecte a API

4. Configurar webhooks

5. Envie sua primeira mensagem

6. Construa sua integração

Comece a construir · Leia o quickstart · Leia Documentação

Movendo um número do Aplicativo Empresarial

O número pode ser transferido do WhatsApp Business App para a API. Você mantém o número. Esse é o medo habitual, e essa é a parte com uma resposta clara.

O histórico de conversas no aplicativo não se torna automaticamente um histórico completo que sua API pode consultar. Trate o histórico de chat como um detalhe de migração a ser confirmado na Documentação da Meta para sua configuração — coexistência, uma mudança completa ou um novo número não são o mesmo caso. Não planeje uma troca esperando que cada conversa antiga estará disponível no software.

FAQ