Neste artigo
A API oficial do WhatsApp é o caminho que a Meta oferece para uma empresa conectar o próprio número a um sistema. É por ela que um CRM mostra as conversas para vários atendentes, que um agente de IA responde de madrugada e que um lembrete de consulta sai sozinho. Se a sua empresa já sentiu que o aplicativo do celular ficou pequeno, este guia explica o que é a API, quem precisa dela, quanto custa e como conseguir.
Antes de entrar nos detalhes, um aviso: as regras e os preços da Meta mudam com frequência. Tudo o que está aqui foi conferido na documentação oficial da plataforma em novembro de 2026, e cada ponto traz o link da fonte para você checar.
O que é a API oficial do WhatsApp
O WhatsApp tem três “versões” para quem fala com cliente:
- WhatsApp comum, para uso pessoal.
- WhatsApp Business (aplicativo), gratuito, feito para pequenos negócios atenderem pelo celular.
- WhatsApp Business Platform, que todo mundo chama de API do WhatsApp ou WhatsApp Business API.
A terceira não tem tela nem aplicativo. Ela é uma ponte técnica entre o WhatsApp e um software. Nas palavras da Meta, a plataforma “permite que empresas se comuniquem com clientes em escala” e a Cloud API permite “enviar mensagens e fazer chamadas no WhatsApp de forma programática” (visão geral da plataforma).
Na prática, você nunca “abre a API”. Você abre o CRM, o chatbot ou a plataforma de atendimento que está ligada nela. Se quiser entender onde a API entra no uso do WhatsApp pela empresa como um todo, veja o guia de WhatsApp para empresas.
Cloud API: a única opção hoje
Durante anos existiram duas formas de usar a API: a On-Premises, que a empresa instalava nos próprios servidores, e a Cloud API, que roda na nuvem da Meta. Esse capítulo acabou. Segundo a Meta, a última versão suportada da On-Premises “expirou em 23 de outubro de 2025” e ela não pode mais ser usada para enviar mensagens (aviso de descontinuação).
Então, quando alguém fala em “cloud api whatsapp” em 2026, está falando da própria API oficial. Não existe mais escolha entre uma e outra.
API oficial x API não oficial
Fora da Meta, existem ferramentas que conectam o WhatsApp a sistemas lendo o QR Code do WhatsApp Web, como se fosse uma pessoa usando o computador. Elas são chamadas de “API não oficial”. São rápidas de ligar e costumam ser baratas, mas não são autorizadas pela Meta. Os Termos de Serviço do WhatsApp proíbem acessar o serviço por meios automatizados não autorizados e enviar mensagens em massa ou automáticas não permitidas, e preveem a suspensão da conta.
A diferença completa, com riscos e quando cada uma aparece no mercado, está no artigo API oficial ou não oficial do WhatsApp.
Para quem é a API do WhatsApp
A API não é só para empresa grande. Ela faz sentido quando pelo menos uma destas situações aparece:
- Mais de uma pessoa precisa atender no mesmo número. O aplicativo permite até quatro aparelhos ligados ao celular principal (central de ajuda do WhatsApp), sem divisão de conversas por atendente.
- Você quer um agente de IA ou chatbot respondendo. Automação séria precisa de integração autorizada.
- O volume de contatos cresceu. Lead de anúncio, de site, de indicação, tudo chegando no mesmo número.
- Você precisa iniciar conversas em escala, como lembretes, confirmações, campanhas para a base.
- O número é um patrimônio. Perder o WhatsApp por bloqueio significa perder o canal de vendas.
Se nenhum desses pontos é realidade hoje, o aplicativo WhatsApp Business ainda resolve. A comparação lado a lado, com tabela e o que muda no seu número atual, está em WhatsApp Business ou API: qual usar.
O que dá para fazer com a API oficial
A API em si é só a ponte. O que você consegue fazer depende da plataforma ligada a ela. Com um bom CRM ou plataforma de atendimento, dá para:
| O que | Como funciona |
|---|---|
| Vários atendentes no mesmo número | Cada um vê suas conversas no sistema, com histórico salvo |
| Agente de IA ou chatbot | Responde, qualifica e passa para uma pessoa quando precisa |
| Funil de vendas | Cada conversa vira um card que anda pelas etapas |
| Mensagens de modelo (templates) | Lembretes, confirmações, retomadas e campanhas fora da janela de 24 horas |
| Botões e listas | Respostas rápidas com toque, em vez de “digite 1” |
| Integrações | Site, formulário, anúncios e outros sistemas mandando dados para a conversa |
| Relatórios | Quantos leads chegaram, quem atendeu, quanto tempo levou |
Para entender como um robô ou um agente de IA funciona em cima da API, veja o guia de chatbot para WhatsApp.
No vídeo abaixo, o Mário mostra o CRM SVG por dentro, rodando com a API oficial: caixa de entrada, funil, agente de IA e follow-up.
Como conseguir a API oficial do WhatsApp: passo a passo
O caminho é parecido para todo mundo. O que muda é se você faz sozinho, com equipe técnica, ou por meio de um parceiro ou CRM que já tem o cadastro guiado.
1. Tenha uma conta empresarial na Meta
Tudo começa no portfólio empresarial da Meta (antigo Gerenciador de Negócios). A documentação é direta: “você precisa ter um portfólio empresarial para usar a plataforma” (visão geral). Se você já anuncia no Facebook ou Instagram, provavelmente já tem um.
2. Escolha o número
O número precisa ser seu, ter código de país e de área e conseguir receber SMS ou ligação para a verificação. Números curtos não são aceitos. Fixo é permitido, com verificação por ligação (requisitos de número).
Um detalhe importante: um número que já está em uso no WhatsApp não pode ser registrado direto na API sem antes apagar a conta dele. A exceção é a coexistência, explicada no próximo passo.
3. Decida o que fazer com o número atual
Se o número já roda no aplicativo WhatsApp Business, existem dois caminhos:
- Migrar de vez: apagar a conta no app e registrar o número na API. As conversas passam a acontecer só no sistema.
- Coexistência: recurso da Meta que conecta o número do app à Cloud API sem desligar o aplicativo. Contatos e até seis meses de histórico podem ser sincronizados. Em troca, algumas funções do app são desativadas, como listas de transmissão e mensagens temporárias, e a coexistência é feita por meio de um parceiro da Meta (documentação da coexistência).
4. Defina o nome de exibição
Ao registrar o número, você informa o nome que aparece no perfil. Ele passa por análise da Meta e só pode ser usado depois de aprovado (requisitos de número). Use o nome real da empresa, igual ao do site e das redes.
5. Conecte por um parceiro, um CRM ou direto
Aqui entra a sigla que mais confunde: BSP.
- BSP (Business Solution Provider) é o nome antigo de mercado para o que a Meta hoje chama de Solution Partner: um parceiro oficial que pode até faturar o uso da API para você, com linha de crédito própria (parceiros da Meta).
- Tech Provider é a empresa de software que conecta seu número à API pelo cadastro guiado da Meta. Nesse modelo, você cadastra seu próprio meio de pagamento e a Meta cobra as mensagens direto de você.
- Direto na Cloud API: possível para quem tem desenvolvedor e vai construir o próprio sistema.
Para a maioria das pequenas e médias empresas, o caminho mais curto é contratar um CRM que já conecta pela API oficial. Você ganha a ponte e a ferramenta de atendimento de uma vez. É o que a gente faz no CRM SVG: a conexão acontece pela sua conta Meta, e o número fica no seu portfólio.
Como escolher o parceiro ou BSP do WhatsApp
Se você vai usar um parceiro, não escolha só pelo preço. Algumas perguntas separam um bom fornecedor de uma dor de cabeça:
- O número fica registrado no portfólio da minha empresa ou no do fornecedor?
- Quem paga a Meta pelas mensagens: eu, direto no cartão, ou vocês, na fatura?
- O que vem junto com a conexão: caixa de entrada, vários atendentes, funil, agente de IA, relatórios?
- Se eu cancelar, levo o número e o histórico comigo?
- Quem me ajuda a criar e aprovar os modelos de mensagem?
A resposta à primeira pergunta é a mais importante. O número é da sua empresa e deve continuar sendo, qualquer que seja a ferramenta.
6. Cadastre a forma de pagamento
As mensagens cobradas pela Meta precisam de um meio de pagamento na conta do WhatsApp, a não ser que um Solution Partner faça a cobrança por você.
7. Verifique a empresa
A verificação do negócio não é obrigatória para começar, mas faz diferença. Segundo a Meta, o status de verificação libera mais recursos, como maior capacidade de envio e o selo de conta comercial oficial (visão geral). Ela também é um dos caminhos para subir o limite de mensagens, como você vê mais abaixo.
8. Crie os modelos de mensagem
Para iniciar conversa fora da janela de 24 horas, você precisa de mensagens de modelo aprovadas. Cada modelo é analisado e fica com status aprovado, pendente ou rejeitado (categorização de modelos). Comece por dois ou três: uma retomada de atendimento, uma confirmação e, se fizer sentido, uma campanha.
As regras que você precisa conhecer
A API dá mais liberdade que o aplicativo, mas com regras claras. As quatro principais:
Janela de 24 horas
Quando o cliente manda mensagem, abre uma janela de atendimento de 24 horas. Dentro dela, você responde à vontade, com texto, áudio, foto e botões. Depois que ela fecha, só dá para falar com o cliente usando mensagem de modelo (preços da plataforma).
Opt-in
A Meta exige permissão antes de você mandar mensagem para alguém. A pessoa precisa ter passado o número e aceitado receber mensagens da sua empresa, e o pedido precisa deixar claro o nome do negócio. A permissão pode ser coletada em qualquer canal: site, formulário, presencialmente, por ligação (regras de opt-in).
Limites de mensagens
Toda conta tem um teto de pessoas diferentes que pode contatar por dia fora da janela de atendimento. Portfólios novos começam com 250 pessoas em 24 horas. Os degraus seguintes são 2.000, 10.000, 100.000 e ilimitado, e o limite vale para o portfólio inteiro, somando todos os números (limites de mensagens).
Para chegar a 2.000, basta verificar a empresa ou enviar 2.000 mensagens de alta qualidade fora da janela em 30 dias. Depois disso, o limite sobe um degrau sozinho quando a qualidade está alta e você usou pelo menos metade do limite nos últimos sete dias.
Qualidade e políticas
Quem recebe pode bloquear ou denunciar a empresa. A Meta diz que limita o envio de quem mantém qualidade baixa por muito tempo (opt-in e qualidade). Modelos com qualidade muito baixa são pausados por 3 horas, depois 6 horas, e na terceira vez desativados (pausa de modelos).
Também há produtos e serviços que não podem ser vendidos pela plataforma, como drogas, armas, jogos de azar, produtos adultos e esquemas enganosos, como pirâmide (violações de política).
É por causa dessas regras que mandar mensagem para muita gente pela API pede método. O passo a passo está no guia de disparo em massa no WhatsApp sem bloqueio.
Quanto custa a API do WhatsApp
Desde 1º de julho de 2025, a Meta cobra por mensagem de modelo entregue, e não mais por conversa (preços da plataforma). O resumo:
| Tipo de mensagem | É cobrada? |
|---|---|
| Mensagem do cliente para a empresa | Não |
| Resposta da empresa dentro da janela de 24 horas | Não |
| Modelo de utilidade dentro da janela aberta | Não |
| Modelo de marketing | Sim |
| Modelo de utilidade fora da janela | Sim |
| Modelo de autenticação | Sim |
| Qualquer mensagem nas 72 horas após o cliente chegar por anúncio de clique para o WhatsApp ou botão da Página do Facebook | Não |
O valor de cada mensagem varia conforme a categoria e o país do número de quem recebe. O Brasil tem tabela própria, publicada na página de preços do WhatsApp Business.
O custo total, porém, não é só a taxa da Meta. Some a plataforma que você usa para operar a API e a implantação. O detalhamento de cada parte está em quanto custa a API do WhatsApp.
Erros comuns de quem está começando
Achar que a API é um aplicativo. Ela é a ponte. Sem um sistema em cima, não há onde atender.
Comprar “API” que pede para ler QR Code. Se a conexão é feita pelo QR Code do WhatsApp Web, não é a API oficial.
Começar disparando para a base inteira. Portfólio novo começa com 250 contatos por dia fora da janela. E lista sem permissão derruba a qualidade do número logo no começo.
Usar modelo de utilidade para fazer promoção. A Meta revisa as categorias e pode mudar um modelo de utilidade para marketing. Mensagem que mistura aviso e oferta é tratada como marketing (categorização de modelos).
Esquecer do processo. A API não resolve atendimento desorganizado. Antes, defina quem atende, quais as etapas do funil e quando fazer follow-up. O artigo sobre como escolher CRM para WhatsApp ajuda a montar essa lista.
Por onde começar
Se a sua empresa já sente os limites do aplicativo, o caminho mais simples é:
- Separar o número que vai para a API e decidir entre migrar ou usar a coexistência.
- Conferir se o portfólio empresarial da Meta está em ordem e, se possível, verificar a empresa.
- Escolher a plataforma que vai operar a API, olhando conexão oficial, funil, IA, follow-up e suporte.
- Começar pelo atendimento de quem chega e só depois partir para mensagens ativas.
O CRM SVG conecta pela API oficial via conta Meta e já vem com funil, agente de IA que entende áudio e imagem, follow-up e vários atendentes no mesmo número. Se fizer sentido para você, a gente faz a implantação junto.
Todos os guias sobre API do WhatsApp
- WhatsApp Business API ou aplicativo WhatsApp Business: qual usar e quando migrarWhatsApp Business API ou aplicativo WhatsApp Business: tabela comparativa, preço de cada um, quando migrar e o que acontece com o número que você já usa.
- API do WhatsApp preço: quanto custa de verdade usar a API oficialQuanto custa a API do WhatsApp em 2026: como a Meta cobra por mensagem, o que é grátis, o que varia por país e o que soma no custo total com plataforma.
- API não oficial do WhatsApp ou API oficial: diferenças, riscos e como escolherAPI não oficial do WhatsApp x API oficial: como cada uma funciona, o que dizem os termos de uso, o risco de bloqueio e quando cada uma faz sentido.
