A API oficial do WhatsApp é o caminho autorizado pela Meta para empresas conversarem com clientes em escala e automatizarem o atendimento via WhatsApp. Na prática, ela liga o número comercial à Meta para que plataformas, agentes de IA e equipes atendam dentro das regras.
O tema ganhou peso entre 2025 e 2026: a Meta encerrou a versão em servidores próprios, mudou a cobrança e criou a coexistência com o app. Em novembro de 2025, uma onda de bloqueios atingiu contas no Brasil, segundo o Times Brasil.
Quem já sofreu com um WhatsApp banido sabe que o canal é parte da operação. Este guia explica a API oficial do WhatsApp: diferenças para o app, funcionamento, acesso, requisitos, preços, limites, riscos, casos de uso, LGPD e desafios.
Principais Conclusões
- A API oficial do WhatsApp é a WhatsApp Business Platform da Meta, hoje concentrada na Cloud API, e é o meio autorizado para automatizar conversas em escala.
- Desde julho de 2025 a cobrança é por modelo entregue, e as mensagens sem modelo dentro da janela de 24 horas são gratuitas.
- A coexistência permite usar o mesmo número no app WhatsApp Business e na API, facilitando a adoção de agentes de IA.
O Que É a API Oficial do WhatsApp
Antes de preços e passo a passo, vale entender o que a Meta chama de API oficial. O nome popular esconde um conjunto de serviços com funções diferentes, todos mantidos pela Meta.
Definição e Componentes da Plataforma
Segundo a documentação da WhatsApp Business Platform, a plataforma permite que empresas conversem com clientes em escala por meio de APIs. Ela funciona sobre a Graph API da Meta, com requisições HTTP e autenticação OAuth, e se divide em três partes.
- Cloud API: envia e recebe mensagens e chamadas, com texto, mídia, mensagens interativas, grupos e voz.
- Business Management API: administra números, modelos de mensagem, métricas e custos.
- Marketing Messages API: voltada a campanhas, com rastreio de conversões e, segundo a Meta, até 9% mais entregas de mensagens de marketing.
Quando o mercado fala em WhatsApp Business API ou WhatsApp Cloud API, fala desse conjunto. A hospedagem é da Meta, e a empresa ou o parceiro só integra os seus sistemas à API.
Fim da Versão On-Premises
Por anos existiu uma versão On-Premises, instalada nos servidores da empresa ou do parceiro. A Meta foi desligando essa opção em etapas, e desde janeiro de 2024 os recursos novos saem só na Cloud API.
Desde julho de 2024, números novos só podem ser registrados na Cloud API. Em 23 de outubro de 2025, a última versão On-Premises expirou e as mensagens de números ainda registrados nela deixaram de ser entregues.
Hoje, a API oficial do WhatsApp é, na prática, a Cloud API hospedada pela Meta. Sem servidor próprio para manter, o foco passa a ser a plataforma que usa a API, como um CRM ou um chatbot com IA.
App WhatsApp Business, API e Coexistência
Muitas empresas começam pelo app gratuito e, ao crescer, esbarram nos limites dele. Entender as três opções ajuda a decidir o momento de migrar e o formato mais adequado.
Diferenças Entre o App e a API
O WhatsApp Business em aplicativo é gratuito e pensado para pequenas empresas. Segundo a comparação publicada pelo WhatsApp Business, ele usa um número por conta e não foi feito para equipes com vários usuários.
A plataforma com API permite vários números, integração com CRM e operação com milhares de atendentes e bots. É o formato indicado para quem precisa de um WhatsApp com múltiplos atendentes, automação e relatórios.
| Critério | App WhatsApp Business | API oficial do WhatsApp |
|---|---|---|
| Custo de uso | Gratuito | Cobrança por modelo entregue |
| Números | Um por conta | Vários números e nomes de exibição |
| Equipe | Pensado para poucos usuários | Muitos atendentes e bots ao mesmo tempo |
| Integrações | Sem integração via API | CRM, sistemas internos e IA |
Como Funciona a Coexistência
A coexistência conecta o número do app WhatsApp Business à Cloud API por meio de um parceiro, com o cadastro incorporado. Pela documentação de coexistência da Meta, o app precisa estar na versão 2.24.17 ou superior.
Com a coexistência, a equipe continua usando o celular enquanto a API atende em paralelo, e as mensagens enviadas pelo app seguem gratuitas. Isso permite adotar agentes de IA sem trocar o número que os clientes já conhecem.
A vazão nesse modo é de 20 mensagens por segundo, contra 80 no uso padrão. O formato também tem limitações de recursos e de uso do celular, tratadas na seção de desafios.
Como Funciona a WhatsApp Cloud API
O funcionamento da API gira em torno de três conceitos: a janela de atendimento, os modelos aprovados e os webhooks. Juntos, eles definem quando e como a empresa pode falar com cada cliente.
Mensagens de Serviço e Janela de 24 Horas
Segundo a documentação da Meta, quando um usuário envia mensagem ou liga para a empresa, começa um timer de 24 horas chamado janela de atendimento. Cada nova mensagem ou ligação do cliente reinicia essa contagem.
Com a janela aberta, a empresa pode enviar qualquer mensagem de serviço: texto com prévia de link, áudio, documento, imagem, vídeo, figurinha, botões de resposta, listas, pedido de localização, contatos, reações e mensagens de catálogo.
Os Flows merecem destaque: são formulários de várias etapas dentro da conversa para agendar horários, navegar por produtos, coletar feedback ou gerar leads, com consulta em tempo real a sistemas como uma agenda.
Modelos de Mensagem Aprovados
Fora da janela de 24 horas, a empresa só pode iniciar conversas com modelos de mensagem aprovados, também chamados de templates. Segundo a Meta, eles se dividem em três categorias: marketing, utilidade e autenticação.
O modelo de utilidade serve para confirmações e lembretes, e o de autenticação envia códigos de acesso. O de marketing cobre promoções e reengajamento, com botões e a opção de descadastro para o cliente sair da lista.
Webhooks e Integração com Sistemas
Todas as mensagens recebidas e os status de entrega chegam por webhook, uma notificação automática da Meta ao sistema da empresa. É assim que um CRM sabe que o cliente respondeu ou leu a mensagem.
A vazão padrão é de 80 mensagens por segundo por número, e de uma mensagem a cada 6 segundos para o mesmo usuário. Esse desenho é a base para automatizar o atendimento no WhatsApp sem perder mensagens.
Formas de Acesso à API do WhatsApp
Há dois caminhos para ativar a API do WhatsApp: integrar direto com a Meta ou contratar uma plataforma parceira. A escolha depende da equipe técnica disponível e do nível de suporte desejado.
Acesso Direto pela Meta
O acesso direto exige conta no Facebook ou conta gerenciada da Meta, cadastro de desenvolvedor, um app Meta com o caso de uso WhatsApp, uma conta WhatsApp Business (WABA) e um número de telefone.
Depois, a empresa precisa desenvolver a integração e a interface de atendimento, ou montar um chatbot para WhatsApp do zero. É um caminho viável para quem tem time de engenharia, mas pesado para quem só quer atender e vender.
Parceiros e Cadastro Incorporado
A Meta descreve os parceiros na página de provedores de soluções. O Solution Partner é Meta Business Partner, oferece serviço completo e pode estender a própria linha de crédito ao cliente, faturando o uso da API.
O Tech Provider também pode oferecer serviço completo, mas sem linha de crédito: o cliente cadastra o próprio meio de pagamento, a Meta cobra o uso da API e o provedor cobra os seus serviços.
Nos dois casos, a ativação usa o cadastro incorporado (Embedded Signup), que abre no site do parceiro, cria os ativos do WhatsApp do cliente e autoriza o app. Depois, a equipe trabalha em telas prontas de automação de suporte.
Requisitos e Passo a Passo para Começar
Com o caminho de acesso definido, a ativação segue uma sequência previsível. Preparar os requisitos antes evita retrabalho e atrasos na aprovação do número e do nome de exibição.
Requisitos da Conta e do Número
O primeiro requisito é o Portfólio Empresarial da Meta, antigo Business Manager, que reúne as contas WhatsApp Business. A verificação da empresa libera mais vazão e é pré-requisito para o selo de conta oficial.
Pelas regras da Meta, o número precisa ser da empresa, ter código de país e DDD e receber SMS ou ligação. Short codes não são aceitos, e um número banido precisa de recurso antes.
Se o número já estiver ativo no WhatsApp, ele precisa ser apagado do app antes do registro, exceto no modo coexistência. Por isso, vale decidir cedo entre um número novo e o número atual.
Um portfólio novo começa com até 2 números, e o limite sobe para 20 com a verificação da empresa ou ao atingir o limite de mensagens de 2.000 destinatários únicos em 24 horas.
Passo a Passo da Ativação
Com a plataforma parceira, a ativação costuma seguir esta ordem:
- Portfólio: criar ou revisar o Portfólio Empresarial e iniciar a verificação da empresa.
- Número: escolher entre um número novo ou o número atual com coexistência.
- Cadastro: fazer o cadastro incorporado e registrar o número com o PIN de verificação em duas etapas.
- Nome de exibição: enviar um nome ligado à empresa e aguardar a aprovação.
- Modelos: criar os primeiros modelos de utilidade e marketing e aguardar a análise.
O nome de exibição pode ficar pendente, ser aprovado, recusado ou expirar, e só vale depois de aprovado. Um nome recusado pode ser corrigido ou contestado, e a aprovação chega por webhook.
Com o número ativo, a equipe deve definir horários, tom de voz e regras de encaminhamento, seguindo boas práticas de atendimento, antes de ligar agentes de IA e modelos.
Preços da WhatsApp Business API
A cobrança mudou em 2025 e é um dos pontos que mais geram dúvida. Saber o que é pago e o que é gratuito ajuda a planejar campanhas e atendimento.
Cobrança por Modelo Entregue
Segundo a página de preços da Meta, desde 1º de julho de 2025 a cobrança é por modelo de mensagem entregue, e não por conversa. O valor varia conforme a categoria: marketing, utilidade ou autenticação.
Assim, o custo acompanha o tipo de uso: uma campanha de marketing para milhares de contatos gera cobrança por modelo entregue, enquanto um atendimento iniciado pelo cliente pode ficar quase todo nas mensagens gratuitas.
O Que É Gratuito e a Regra para Provedores de IA
As mensagens sem modelo, enviadas dentro da janela de 24 horas, são gratuitas. Os modelos de utilidade também não são cobrados com a janela aberta, o que favorece confirmações e avisos durante a conversa.
No Brasil há uma regra específica. Desde 11 de março de 2026, a Meta cobra dos provedores de IA, ou seja, assistentes de uso geral, pelas mensagens fora de modelo enviadas para números +55.
Empresas que usam IA no próprio atendimento não entram nessa regra: quem coloca um agente para responder os seus clientes, como no uso do ChatGPT no WhatsApp, segue a tabela comum.
Limites de Envio e Qualidade do Número
A API oficial tem regras de volume e qualidade. A Meta controla quantos clientes novos cada empresa pode abordar por dia e acompanha a reação das pessoas às mensagens.
Níveis de Limite de Mensagens
Pela documentação de limites de mensagens, o limite conta destinatários únicos em 24 horas e sobe em degraus: 250, 2.000, 10.000, 100.000 e ilimitado. Ele vale para conversas iniciadas pela empresa com modelos.
Desde outubro de 2025, segundo a Meta, o limite passou a valer por portfólio, e não por número. Além disso, uma queda de qualidade deixou de rebaixar o limite já alcançado pela empresa.
Nota de Qualidade e Pausa de Modelos
Cada modelo de mensagem recebe uma nota de qualidade alta, média ou baixa, calculada com sinais dos últimos 7 dias, como bloqueios e denúncias. Acompanhar esse indicador junto das métricas de atendimento mostra se a comunicação está agradando.
Pelas regras de pausa de modelos, um modelo com muitas reações negativas é pausado por 3 horas, depois por 6 horas e, se o problema persistir, desativado. A nota funciona como aviso antecipado, antes que um problema pequeno vire bloqueio.
API Oficial x Soluções Não Oficiais
Ferramentas que simulam o WhatsApp Web ou usam aplicativos modificados ainda são vendidas como alternativa barata. A diferença para a API oficial vai além do preço.
Riscos das Ferramentas Não Oficiais
Os Termos de Serviço do WhatsApp proíbem mensagens em massa e automáticas, discagem automática, apps modificados e integrações por meios não autorizados. Contas que violem a letra ou o espírito dessas regras podem ser suspensas ou encerradas.
Quem automatiza por fora da API corre o risco de ter a conta suspensa ou banida e perder o número como canal de atendimento. O guia sobre como evitar um número banido detalha os tipos de bloqueio e o caminho de recurso.
Vantagens de Operar Dentro das Regras
A API oficial oferece regras públicas, modelos revisados, limites conhecidos e nota de qualidade visível. Isso não garante que o número nunca será bloqueado, mas coloca a operação dentro do que a Meta autoriza e dá sinais claros antes de um problema.
Outra vantagem é a governança. Com a API, cada mensagem fica registrada, a equipe trabalha em uma única caixa de entrada e a empresa escolhe ferramentas de IA para WhatsApp sem depender de um único celular para atender.
Casos de Uso da API Oficial do WhatsApp
A API oficial abre espaço para usos que o app não comporta. Os mais comuns combinam atendimento automatizado, comunicação ativa com a base e integração com os sistemas da empresa.
Atendimento com Agentes de IA
Um dos usos de maior impacto são os agentes de IA, que entendem a pergunta do jeito do cliente, consultam a base da empresa e executam ações. Eles vão além de um chat bot no WhatsApp baseado em menus.
O passo a passo para criar agentes de inteligência artificial para WhatsApp mostra como preparar base de conhecimento, instruções e integrações. Negócios de nicho podem ir além com agentes verticais de IA, treinados para um setor.
Disparos, Lembretes e Repescagem
Com modelos aprovados, a empresa pode enviar promoções para quem deu consentimento, lembretes de consulta, avisos de entrega e cobranças. Esse uso apoia estratégias de automação para retenção de clientes sem recorrer a listas compradas.
A repescagem retoma contatos que pararam de responder, com mensagens espaçadas e relevantes. Com ferramentas de follow-up de vendas, ela ajuda a recuperar oportunidades em cada etapa do funil de vendas.
Integração com CRM e Outros Sistemas
Os webhooks permitem registrar cada conversa no CRM, atualizar o status do lead e disparar mensagens a partir de eventos, como um pedido aprovado. A integração de WhatsApp com CRM evita o retrabalho de copiar dados entre telas.
Um restaurante, por exemplo, pode ligar o cardápio e o sistema de pedidos a um chatbot de IA para delivery, que recebe o pedido, confirma o endereço e envia o status até a entrega.
Segurança, Privacidade e LGPD na API do WhatsApp
Automatizar o WhatsApp significa tratar dados pessoais em volume. A segurança técnica da plataforma precisa vir acompanhada de processos internos alinhados à LGPD.
Criptografia e Selo de Conta Oficial
Segundo a Meta, as mensagens usam criptografia com o protocolo Signal entre o cliente e a Cloud API, hospedada pela própria Meta. Na empresa, o cuidado é proteger tokens de acesso, restringir permissões e revisar quem vê as conversas.
A Conta Comercial Oficial exibe selo azul e exige portfólio verificado, verificação em duas etapas, nome de exibição aprovado, ao menos 30 dias na plataforma e respeito às políticas. O selo reforça a confiança de quem recebe.
Consentimento, Descadastro e LGPD
A Política do WhatsApp Business exige opt-in, ou seja, que a pessoa tenha fornecido o número e dado permissão para receber mensagens. Pedidos de descadastro também precisam ser respeitados em todos os envios.
No Brasil, o número de telefone é dado pessoal protegido pela Lei 13.709/2018 (LGPD), e o uso em campanhas precisa de base legal. Consentimento registrado é a primeira linha de defesa contra denúncias e contra problemas com a LGPD.
Com agentes de IA, entra ainda a proteção contra manipulação das instruções, tema do conteúdo sobre prompt hacking. Limitar o que o agente pode acessar e registrar as ações executadas completa a governança.
Desafios e Limitações da API Oficial do WhatsApp
A API oficial resolve problemas do app, mas traz custos, regras e ajustes de rotina. Conhecer esses pontos antes evita surpresas no orçamento e na operação.
Custos e Aprovação de Modelos
Cada modelo de marketing entregue gera cobrança, e campanhas frequentes para bases grandes pesam no orçamento. Além disso, todo modelo passa por análise antes do uso, o que exige planejar textos e prazos com antecedência.
Modelos com muitas reações negativas são pausados e podem ser desativados, interrompendo campanhas no meio. Por isso, a qualidade do conteúdo e o consentimento da base pesam tanto quanto o volume de envios.
Limitações da Coexistência e da Nota de Qualidade
Quem mantém o número no app com coexistência precisa aceitar alguns ajustes:
- Listas de transmissão: ficam só para leitura depois da conexão com a API.
- Recursos desligados: mensagens temporárias, de visualização única e localização ao vivo deixam de funcionar.
- Uso do celular: cerca de 14 dias sem abrir o app desconectam o número da API.
Na nota de qualidade, o desafio é que ela reage a quem recebe: bloqueios e denúncias dos últimos 7 dias afetam os modelos, mesmo com envios dentro das regras.
Como a ConverZap Aplica a API Oficial
A ConverZap é uma plataforma de agentes de IA para WhatsApp conectada à API oficial com coexistência. Os agentes consultam banco de dados e CRM, respondem com o conhecimento da empresa e levam a IA no atendimento ao cliente para a rotina.
A plataforma também faz disparo em massa seguro com modelos aprovados e descadastro, lembretes, repescagem e dashboards. Quem quer levar a automação de atendimento para a API oficial pode conhecer a plataforma da ConverZap.
Perguntas Frequentes sobre a API Oficial do WhatsApp
As respostas abaixo reúnem as dúvidas mais comuns sobre a API oficial do WhatsApp em atendimento, marketing e vendas.
Desde julho de 2025, a Meta cobra por modelo de mensagem entregue, com valores que variam por categoria. Mensagens sem modelo dentro da janela de 24 horas são gratuitas, assim como modelos de utilidade com a janela aberta. A plataforma escolhida cobra à parte.
Sim, pela coexistência. O número do app é conectado à Cloud API por meio de um parceiro, e a equipe continua usando o celular enquanto a API atende em paralelo. O app precisa estar na versão 2.24.17 ou superior e deve ser aberto com regularidade.
Não existe garantia absoluta. O WhatsApp pode suspender contas que violem os Termos, e modelos com muitas denúncias são pausados e depois desativados. A vantagem da API oficial é operar dentro das regras, com opt-in, limites conhecidos e nota de qualidade visível.
Fora da janela, só é possível usar modelos de mensagem aprovados pela Meta, nas categorias marketing, utilidade ou autenticação. O contato precisa ter dado opt-in, e pedidos de descadastro devem ser respeitados para proteger a nota de qualidade do número.
No acesso direto pela Meta, sim, porque a empresa precisa desenvolver a integração com webhooks e envio de mensagens. Com uma plataforma parceira, a ativação é feita pelo cadastro incorporado, e a equipe trabalha em telas prontas, sem escrever código.
A API permite ligar agentes de IA ao número da empresa, integrar CRM e sistemas e registrar cada conversa. Somada a boas práticas de atendimento, ela reduz o tempo de resposta e permite atender fora do horário comercial sem sair das regras do WhatsApp.
