API oficial do WhatsApp: como funciona

Resumo: a API oficial do WhatsApp (Cloud API) é o jeito autorizado pela Meta de ligar um sistema ao WhatsApp da empresa. Ela roda na nuvem da Meta, permite várias pessoas atendendo, automações e modelos de mensagem aprovados, e a Meta cobra as mensagens à parte. Este guia explica como funciona, quem pode usar e como conectar.

Neste guia

O que é a API oficial do WhatsApp
As peças: portfólio, conta, número e modelos
Como funciona uma conversa na API oficial
Quem pode usar
Passo a passo para conectar
Coexistência: app e API no mesmo número
Quanto custa
Limites de envio e qualidade do número
Na prática no InvestCRM
Cuidados e limites
Perguntas frequentes

O que é a API oficial do WhatsApp

A API oficial do WhatsApp Business é a interface que a Meta oferece para empresas conectarem sistemas ao WhatsApp: CRMs, plataformas de atendimento, chatbots. Na versão Cloud API, a infraestrutura fica na nuvem da própria Meta. A empresa não precisa manter servidor nem deixar um celular ligado.

Ela é diferente do aplicativo WhatsApp Business. O app é pensado para uma pessoa atendendo pelo celular. A API é pensada para sistemas: várias pessoas no mesmo número, automações, integração com funil de vendas e medição de anúncios.

Também é diferente das conexões por QR code oferecidas por alguns sistemas. Essas conexões ligam o app a um sistema sem autorização da Meta. O WhatsApp não autoriza apps não oficiais, e um número usado assim pode ser restringido ou bloqueado.

As peças: portfólio, conta, número e modelos

Alguns nomes aparecem o tempo todo quando se fala da API oficial:

Portfólio empresarial (Meta Business): a “casa” da empresa na Meta, onde ficam as contas, as páginas e as formas de pagamento.
Conta do WhatsApp Business (WABA): a conta, dentro do portfólio, que reúne os números de WhatsApp e os modelos de mensagem.
Número de telefone: o número que os clientes veem. Ele tem um nome de exibição, um perfil comercial e uma situação (qualidade e limites) acompanhada pela Meta.
Modelo de mensagem (template): uma mensagem pré-aprovada pela Meta, usada para começar conversas. Os modelos têm categorias: Marketing, Utilidade e Autenticação.

Essa estrutura importa porque a Meta pode aplicar limites ou restrições em cada nível: no número, na conta (WABA) ou no portfólio.

Como funciona uma conversa na API oficial

A regra central é a janela de 24 horas:

Quando o cliente manda uma mensagem para a empresa, abre uma janela de 24 horas.
Dentro da janela, a empresa pode responder com mensagens livres (texto, imagem, áudio, documento, botões), sem modelo.
Fora da janela, a empresa só pode puxar a conversa com um modelo de mensagem aprovado.

Na prática, isso muda a forma de fazer follow-up e campanhas. Lembretes, avisos e retomadas depois de 24 horas precisam de modelos aprovados. Por isso vale criar alguns modelos logo no começo: um de retomada de conversa, um de lembrete e, se você faz campanhas, os de marketing.

Os modelos podem ter variáveis (como o primeiro nome do cliente), cabeçalho com imagem, vídeo ou PDF, rodapé e botões. A Meta analisa cada modelo e pode aprovar ou rejeitar, informando o motivo.

Quem pode usar

Em geral, qualquer empresa pode usar a API oficial, desde que:

tenha (ou crie) um portfólio empresarial na Meta;
tenha um número de telefone que consiga receber o código de verificação por SMS ou ligação;
aceite os termos e siga as políticas do WhatsApp para empresas, incluindo a Política do WhatsApp Business, que restringe alguns produtos e serviços e exige permissão (opt-in) para enviar mensagens;
cadastre uma forma de pagamento na Meta para as mensagens cobradas por ela.

Um ponto que costuma gerar dúvida: um número usado na API oficial deixa de funcionar no app WhatsApp Business do jeito tradicional. A exceção é o modo Coexistência, explicado abaixo.

Para aumentar os limites de envio, a Meta pode pedir a verificação do portfólio empresarial. Confira as exigências atuais na documentação oficial.

Passo a passo para conectar

Hoje, a forma mais simples de conectar é pelo Cadastro Incorporado (Embedded Signup): uma janela do Facebook, aberta dentro do sistema que você vai usar, guia todo o processo. Você não precisa criar um aplicativo na Meta nem mexer em código.

Escolha o sistema que vai usar com a API oficial (CRM, plataforma de atendimento).
Abra a tela de conexão e clique para conectar o WhatsApp. A janela do Facebook vai abrir.
Entre com a conta do Facebook que administra a empresa e escolha (ou crie) o portfólio empresarial.
Escolha ou crie a conta do WhatsApp Business e informe o nome de exibição.
Informe o número e confirme o código de verificação. Se quiser continuar usando o app no celular, escolha a Coexistência.
Cadastre a forma de pagamento na Meta.
Crie os primeiros modelos e envie para aprovação.

Depois disso, o número está pronto para receber e responder mensagens pelo sistema.

Coexistência: app e API no mesmo número

A Coexistência permite usar o app WhatsApp Business no celular e a API oficial no mesmo número. A conexão termina com a leitura de um QR code no app, e é possível trazer os contatos e até 6 meses de conversas.

Ela tem limites que precisam ser conhecidos antes:

o app do celular perde algumas funções, como listas de transmissão e mensagens temporárias;
há limite de 20 mensagens por segundo, então o modo serve para atendimento, não para envio em volume;
os grupos não são sincronizados com a API;
o perfil comercial passa a ser editado só pelo celular.

Quanto custa

O custo de usar a API oficial tem duas partes:

As mensagens, cobradas pela Meta. Na API oficial, a Meta cobra as mensagens à parte, por mensagem (não por conversa, desde 01/07/2025), conforme a tabela oficial dela (consultada em 05/10/2026), na forma de pagamento cadastrada na própria Meta. O valor depende da categoria da mensagem e do país do destinatário.
O sistema que você usa com a API (CRM, atendimento, automação), que tem preço próprio.

A tabela da Meta muda de tempos em tempos. Antes de fazer contas, confira a página oficial de preços e a página sobre mensagens sem modelo.

Limites de envio e qualidade do número

A Meta limita quantas pessoas diferentes a empresa pode procurar por dia com modelos de mensagem. Esse limite começa menor e pode crescer conforme o histórico e a qualidade do número. Os valores e as regras atuais estão na documentação oficial.

A qualidade do número cai quando muitas pessoas bloqueiam ou denunciam as mensagens. Se cair muito, a Meta pode limitar o envio ou restringir o número, a conta ou o portfólio. O que mais ajuda a manter a qualidade:

mandar mensagens só para quem pediu (opt-in);
enviar conteúdo relevante, com frequência razoável;
tirar da lista na hora quem pede para sair;
deixar sempre um caminho para falar com uma pessoa.

Na prática no InvestCRM

O InvestCRM usa somente a API Oficial do WhatsApp Business (Meta). Na prática:

a conexão é pelo Cadastro Incorporado, numa janela do Facebook, sem criar aplicativo; cada conta conecta 1 número;
dá para escolher o modo Coexistência e trazer contatos e até 6 meses de conversas;
a tela de conexão mostra a situação do número, o limite de contatos novos por dia e o bloqueio de pagamento, tudo lido da Meta;
os modelos são criados no próprio sistema (Marketing, Utilidade e Autenticação), com variáveis, cabeçalho com imagem, vídeo ou PDF, rodapé, até 3 respostas rápidas, 2 links e 1 botão de ligar, e o status e o motivo da rejeição aparecem na tela;
a caixa de entrada tem filtro de janela de 24 horas aberta ou fechada, para a equipe saber quando precisa de modelo.

Se preferir ajuda para conectar, existe o Setup Assistido, pago uma vez; o valor aparece no app, na tela Assinatura.

Testar o InvestCRM por 7 dias

Cuidados e limites

API oficial não é garantia contra bloqueio. Ela segue as políticas da Meta, que pode limitar números que recebem denúncias ou desrespeitam as regras.
Não confunda “oficial” com “parceiro”. Um sistema pode usar a API oficial sem ser parceiro da Meta. Desconfie de quem promete aprovação garantida de modelos ou envio sem limite.
Planeje os modelos. Sem modelos aprovados, a empresa não consegue retomar conversas depois de 24 horas.
Conheça os limites da Coexistência antes de escolher esse modo, principalmente se você pensa em envio em volume.
Dados de clientes são dados pessoais. Siga a LGPD ao importar contatos e guardar conversas.

Perguntas frequentes

A API oficial do WhatsApp é paga?

Sim. Na API oficial, a Meta cobra as mensagens à parte, por mensagem (não por conversa, desde 01/07/2025), conforme a tabela oficial dela (consultada em 05/10/2026), na forma de pagamento cadastrada na própria Meta. O sistema que você usa com a API costuma ter preço próprio.

Preciso criar um aplicativo na Meta?

Não, se o sistema usar o Cadastro Incorporado. A conexão é feita numa janela do Facebook, sem criar aplicativo.

Posso continuar usando o WhatsApp Business no celular?

Sim, no modo Coexistência, com limites: o app perde listas de transmissão e mensagens temporárias, há limite de 20 mensagens por segundo e os grupos não são sincronizados.

A API oficial garante que meu número nunca será bloqueado?

Não. Ela segue as políticas da Meta, que pode limitar números que recebem denúncias ou violam regras. Opt-in e boas práticas reduzem o risco.

Posso mandar qualquer mensagem a qualquer hora?

Dentro da janela de 24 horas depois da última mensagem do cliente, sim, com texto livre. Fora dela, só com modelo aprovado pela Meta.

Conecte o seu número à API oficial

Teste o InvestCRM por 7 dias, com tudo liberado e sem cartão. A conexão é pela janela da Meta, sem criar aplicativo.