WhatsApp Business API · guia honesto · 2026

API Oficial do WhatsApp

A API oficial é o único caminho legítimo para escalar o WhatsApp — mas não é o que os fornecedores pintam. O guia explica o modelo de custo por conversa, as regras de template e o que ela não resolve: a prospecção fria.

Metaplataforma oficial (Cloud API)
R$/conversamodelo de cobrança real
R$97pagamento único · 22 campos por empresa

A API oficial do WhatsApp (Cloud API da Meta) conecta seu número a sistemas — CRM, atendimento, automações — com envio ativo permitido via templates aprovados. O custo é por conversa (tabela da Meta, em geral repassada por um provedor/BSP com margem), e a regra de ouro que ninguém destaca: mensagem ativa para quem nunca interagiu exige template aprovado, e qualidade baixa derruba o número mesmo na API. Escala, sim; atalho para spam, não.

Fundamentos

Como a API funciona na prática

Três peças: o número (migrado para a API — deixa o app), o provedor (BSP ou Cloud API direta) e os templates — mensagens pré-aprovadas pela Meta para iniciar conversa ativa.

Quando o cliente responde, abre-se a janela de conversa livre (24h) — aí vale mensagem normal, humano ou bot. Fora da janela, só template. É esse desenho que separa a API do disparo selvagem: a Meta cobra por conversa e pune qualidade baixa com limites e bloqueio.

Custos reais: a tarifa por conversa da Meta varia por categoria (marketing custa mais que utilidade) + a mensalidade/margem do provedor + o custo de quem atende. Para times pequenos, a conta só fecha quando o canal é central na operação.

Decisão honesta

App Business ou API: quando migrar

WhatsApp Business (app) × API oficial
CritérioApp Business (grátis)API oficial
Quem atende1 pessoa (multi-dispositivo limitado)Time inteiro no mesmo número
Prospecção fria 1 a 1Sim — o desenho ideal para abrir relacionamentoPossível via template, mas frio em volume degrada qualidade
Automação/integraçãoMínimaTotal: CRM, bots, sistemas
CustoZeroPor conversa + provedor
Momento certoInício e operações 1 a 1Base opt-in + time + volume de atendimento

Antes da API, a lista

API sem contatos é infraestrutura vazia: monte a base do ICP com telefone cadastral e opere com qualidade desde o app.

Montar minha base
Na prática

O caminho de adoção que não desperdiça

Fase 1: app Business + lista — prove o canal. Fase 2: número corporativo + extensão/CRM — organize. Fase 3: API com a base opt-in que as fases anteriores construíram.

Quem contrata API no dia zero paga por conversa antes de ter com quem conversar. A base opt-in é o ativo — e ela nasce do 1 a 1 bem-feito sobre lista qualificada.

Glossário rápido
Template
Mensagem pré-aprovada pela Meta para envio ativo na API oficial — única forma de iniciar conversa em escala.
Janela de 24h
Após resposta do cliente, 24 horas de conversa livre sem template.
BSP
Business Solution Provider — provedor oficial que intermedia a API do WhatsApp.
Aquecimento
Crescimento gradual de volume de um número novo para não disparar os filtros de spam.
Opt-out
O pedido de saída — respeitado e registrado, é o que mantém número e reputação vivos.
Como a Meta cobra

Categorias de mensagem: o que muda no custo e na aprovação

A API cobra por conversa de 24 horas, com preço por categoria — entender as categorias evita tanto o bloqueio de template quanto a fatura surpresa.

Categorias de conversa na API oficial
CategoriaPara que serveO que a aprovação exige
MarketingOferta, novidade, reativação — a mensagem ativa comercial.Template claro, opt-out explícito e histórico de qualidade do número; é a categoria mais cara e mais escrutinada.
UtilityConfirmação de pedido, status, aviso operacional ligado a uma transação.Vínculo claro com a transação; sem conteúdo promocional embutido.
AuthenticationCódigo de verificação e login.Formato padronizado com código; a mais barata e de aprovação mais simples.
Serviço (resposta)Conversa iniciada pelo cliente — você responde em até 24h.Nenhum template: dentro da janela, texto livre. É onde a operação madura concentra o jogo.
Antes de escalar

O checklist de aprovação que evita o "template rejeitado"

Empresa verificada no Business Manager

A verificação da empresa (documentos + domínio) destrava limites de conversa e é pré-requisito para volume.

Número aquecido em faixas

A API libera volume por degraus conforme a qualidade: começar nos limites baixos e subir é o desenho — não uma punição.

Template sem "isca"

Rejeição clássica: template vago ("temos uma novidade para você") que esconde a intenção. A Meta aprova clareza, não mistério.

Opt-out funcional

A instrução de descadastro precisa funcionar de verdade — e o pedido tem de ser honrado na base, não só na conversa.

Por onde entrar

Cloud API direta ou provedor (BSP): a primeira decisão de arquitetura

Caminhos de implantação da API
CaminhoComo funcionaPara quem
Cloud API direto na MetaSua equipe registra o número, configura webhooks e constrói a aplicação sobre a API.Times com desenvolvedor: custo menor por conversa, controle total, e toda a manutenção é sua.
BSP / plataforma parceiraO provedor hospeda a integração e entrega caixa de entrada, chatbot e relatórios prontos.A maioria das PMEs: implantação em dias, custo da plataforma somado ao da Meta, zero código.
CRM com API embutidaO próprio CRM conecta o número oficial como canal nativo.Quem já vive no CRM: um fornecedor a menos, com a limitação dos recursos que o CRM oferecer.
O que evitar no início

Os 4 erros clássicos da primeira implantação

Migrar o número principal sem plano

O número entra na API e sai do aplicativo — o histórico local não migra. Planeje o corte: exporte o que importa e avise a carteira ativa.

Escalar template de marketing no dia 1

Número novo tem limite de conversas e reputação zero. Comece por utility e serviço; o marketing entra quando a qualidade estabiliza.

Ignorar o rating de qualidade

A Meta mostra a saúde do número (verde/amarelo/vermelho). Amarelo é o último aviso barato que você recebe — reaja reduzindo volume e revisando template.

Chatbot sem saída humana

Robô que prende o cliente num loop gera denúncia — e denúncia derruba rating. Toda árvore precisa do atalho "falar com atendente".

Do zero ao ativo

Implantação em 2 semanas: a linha do tempo realista

  1. Dias 1-2: pré-requisitosBusiness Manager verificado, número dedicado (novo ou migrado com plano), e a escolha do caminho: BSP/plataforma ou Cloud API direta.
  2. Dias 3-5: número no arRegistro do número na API, perfil comercial completo e webhook/caixa de entrada funcionando. Teste com o próprio time.
  3. Dias 6-8: templates aprovadosSubmeta os 3-5 templates essenciais (utility primeiro). Escreva claro e específico — a rejeição típica é template vago.
  4. Dias 9-11: integração e filaCRM conectado, distribuição de conversas definida e o chatbot de triagem com saída humana obrigatória.
  5. Dias 12-14: piloto controladoUm recorte pequeno da carteira ativa, medição de qualidade diária, e só então o plano de volume — respeitando os degraus de limite da Meta.
Dúvidas comuns

Perguntas frequentes

O que é a API oficial do WhatsApp?

É a Cloud API da Meta (WhatsApp Business Platform): a forma oficial de conectar um número a sistemas — CRM, plataformas de atendimento, automações — com envio ativo por templates aprovados e atendimento em equipe. É produto para operação, não um app: exige provedor (ou integração direta) e tem custo por conversa.

Quanto custa a API oficial do WhatsApp?

O modelo é por conversa iniciada, com tarifas da Meta que variam por categoria (marketing > utilidade > serviço) — somadas à mensalidade ou margem do provedor (BSP). Os valores mudam; o desenho não: quem paga por conversa aprende rápido a valorizar qualidade sobre volume. Confirme a tabela vigente na documentação oficial.

A API oficial permite disparo em massa?

Permite envio ativo em escala via templates aprovados — o que não é sinônimo de spam liberado: qualidade baixa (bloqueios, denúncias) reduz seus limites e pode suspender o número mesmo na API. Prospecção fria indiscriminada continua sendo má ideia em qualquer camada; o desenho da API favorece relacionamento com quem já aceitou.

Preciso de provedor (BSP) ou posso usar direto?

A Cloud API permite integração direta com a Meta — tecnicamente viável para quem tem desenvolvimento. Provedores (BSPs) simplificam: interface pronta, suporte e integrações nativas com CRMs, em troca de margem sobre as conversas. Para a maioria das PMEs, o provedor compensa; para operações técnicas, a via direta economiza.

Vale migrar meu número para a API?

Migre quando: mais de uma pessoa precisa atender o mesmo número, o CRM precisa registrar as conversas automaticamente, ou o volume de atendimento justifica bot + templates. Não migre para "disparar mais" — esse motivo termina mal em qualquer plataforma.

De onde vêm os contatos para usar com a API?

A API não fornece contatos — ela envia para quem você já tem. A base nasce da lista qualificada (na LeadJet: CNPJs do seu ICP com telefone, por CNAE, cidade e porte) trabalhada primeiro no 1 a 1; conforme os aceites chegam, sua base opt-in cresce e a API passa a fazer sentido.

Posso usar o mesmo número no app e na API?

Não — a migração para a API tira o número do aplicativo: tudo passa pela plataforma conectada. Por isso o momento importa: migre quando o time e o fluxo estiverem prontos, e mantenha um número secundário no app para o 1 a 1 de prospecção se fizer sentido.

Template reprovado: e agora?

Ajuste e reenvie — os motivos clássicos: tom promocional demais na categoria errada, variáveis mal formatadas, conteúdo vago. Templates de utilidade (confirmações, avisos) aprovam mais fácil que marketing; escreva específico e honesto.