Comparativos

API oficial do WhatsApp vs não oficial: qual escolher?

Compare a API oficial do WhatsApp (Cloud API) e as não oficiais: custos reais, risco de banimento, templates, janela de 24h e o cenário certo para cada uma.

Italo Andrade21 min de leitura

Atualizado em

TL;DR: não existe vencedor absoluto, existe cenário, e quem decide é o seu mix de mensagens. A API oficial (WhatsApp Cloud API) cobra por mensagem de template entregue desde 1º de julho de 2025, e não mais por conversa: no Brasil, integradores observam em 2026 R$0,04 a R$0,05 por utility, R$0,15 a R$0,19 por authentication e R$0,31 a R$0,38 por marketing, com resposta dentro da janela de 24 horas gratuita e ilimitada até 30 de setembro de 2026. A API não oficial cobra assinatura fixa por instância conectada, de R$29 a R$199 por mês com mensagens ilimitadas, mas carrega risco real de banimento. Operação de atendimento, em que o cliente sempre puxa a conversa, sai quase de graça na oficial. Operação de disparo, sobretudo marketing, cruza o ponto de virada rápido e favorece a assinatura fixa. O caminho que mais funciona na prática é o híbrido, com os dois canais coexistindo na mesma integração.

Você precisa integrar WhatsApp no seu sistema. Faz uma busca rápida e descobre que existem dois caminhos: a API oficial, mantida pela Meta e hospedada na nuvem, e as APIs não oficiais, que simulam o WhatsApp Web por engenharia reversa. As duas funcionam. As duas têm problemas.

Esse artigo existe porque a decisão entre API oficial do WhatsApp e API não oficial não é óbvia. Depende do formato do seu tráfego, e não do volume total, do nível de risco que você aceita e de quão rápido precisa colocar algo no ar. Já passamos por esse dilema com dezenas de desenvolvedores e agências de automação, e a resposta quase nunca é "use sempre X".

Vamos direto ao que importa: como cada uma funciona, quanto custa de verdade, quais os riscos que ninguém menciona no material de vendas, e em que situação cada caminho faz sentido.

Como funciona a API oficial do WhatsApp (WhatsApp Cloud API)?

A API oficial do WhatsApp é o serviço que a Meta disponibiliza para empresas enviarem e receberem mensagens de forma programática. O nome técnico é WhatsApp Cloud API, e ela roda nos servidores da própria Meta. Você não precisa hospedar nada.

Para ter acesso, o processo passa por algumas etapas: cadastrar sua empresa no Meta Business Manager (com CNPJ, telefone e site), criar um projeto no painel de desenvolvedor, vincular um número de telefone dedicado e gerar suas credenciais (token de acesso e URL de webhook). Não dá para usar o número do seu celular pessoal.

A conexão é estável. A documentação é boa. Os eventos são previsíveis. Se o WhatsApp mudar alguma coisa no protocolo, a Meta atualiza a API e te avisa. Esse é o principal argumento a favor do canal oficial: previsibilidade.

O que são templates e a janela de 24 horas?

Toda mensagem enviada fora de uma conversa ativa precisa usar um template, uma mensagem padronizada que você cadastra e a Meta aprova antes do uso. Aqui mora a parte que pega muita gente de surpresa.

A Meta divide os templates em três categorias: marketing, utility (notificações transacionais como confirmação, rastreio e lembrete) e authentication (envio de códigos). A categoria não é só burocracia, é o que define o preço. A aprovação costuma ser rápida, mas você não pode improvisar. Se o template não seguir as regras, é rejeitado.

A conversa fica "ativa" por 24 horas depois da última mensagem que o cliente enviou para você. Dentro dessa janela, você responde livremente. Fora dela, só via template aprovado. Muitos devs descobrem isso na hora de colocar o bot em produção, quando as mensagens simplesmente param de ser entregues.

Quanto custa a API oficial do WhatsApp?

A Meta cobra por mensagem de template entregue. Se você leu em algum lugar que a Cloud API cobra por conversa de 24 horas, aquele texto é anterior a julho de 2025: a mudança entrou em vigor em 1º de julho de 2025 e está registrada na documentação de preços da plataforma, que diz que a partir daquela data a cobrança passou a ser feita por mensagem.

Três coisas definem quanto você paga: a categoria do template, o país de quem recebe e o seu volume mensal, porque utility e authentication têm faixas de desconto por volume definidas pela Meta. Marketing não tem faixa e custa o mesmo na primeira e na milionésima mensagem.

O que a Meta não cobra é a resposta dentro da janela de 24 horas. Quando o cliente te escreve, abre uma conversa de serviço, e enquanto ela estiver aberta você responde à vontade, em texto livre, sem template. Antes havia teto de mil conversas de serviço gratuitas por mês; esse teto acabou. A documentação sobre conversas de serviço registra que desde 1º de novembro de 2024 elas são ilimitadas e gratuitas. Conversa que começa com o cliente clicando em um anúncio ganha janela gratuita mais longa, de 72 horas.

Esse gratuito tem data para acabar

A partir de 1º de outubro de 2026 as mensagens de serviço passam a ser cobradas por mensagem enviada, conforme a documentação de cobrança de mensagens não template. Na mesma data, mensagens de utility enviadas dentro da janela de 24 horas, gratuitas desde julho de 2025, também passam a ser cobradas.

Os valores ainda não existem. A Meta promete publicá-los até 1º de setembro de 2026, seguindo a mesma lógica de preço por país já usada em utility e authentication, e avisou que mensagens de serviço não terão desconto por volume. Tudo que este artigo diz sobre resposta gratuita vale até 30 de setembro de 2026, e vale marcar o anúncio de setembro no calendário antes de fechar orçamento para o ano que vem.

Quanto custa cada categoria no Brasil

Um aviso antes da tabela. A Meta mantém os valores por país dentro do painel autenticado, e não em página aberta que dê para citar como referência. O que circula em português vem de levantamentos de integradores, então isso é faixa de mercado e não tabela oficial. Use como ordem de grandeza para orçar e confirme o número da sua conta no painel antes de assinar qualquer coisa.

Categoria de mensagemQuando se aplicaFaixa observada por integradores em 2026
Service (janela de 24h)Resposta dentro da conversa aberta pelo clienteR$0,00 até 30/09/2026
UtilityConfirmação de pedido, rastreio, lembrete, cobrançaR$0,04 a R$0,05 por mensagem
AuthenticationCódigo de verificação e loginR$0,15 a R$0,19 por mensagem
MarketingPromoção, oferta, reativação, novidadeR$0,31 a R$0,38 por mensagem

Marketing custa quase oito vezes o preço de utility no meio da faixa. Guarde essa proporção, porque é dela que sai toda a decisão entre os dois modelos. A conta aberta, com fórmula e ponto de virada por categoria, está no artigo sobre quanto custa automatizar o WhatsApp da empresa.

Uma mudança recente ajuda quem orça em real: desde 1º de julho de 2026, contas de empresas com endereço de cobrança no Brasil são faturadas em reais, pela entidade brasileira da Meta. Some a variação cambial mês a mês. Quem já operava em dólar tem até 30 de junho de 2027 para migrar, e deixar a data passar é risco de interrupção de faturamento.

Não existe cobrança por número conectado, só pelo volume de templates disparados. O canal oficial também dá acesso ao selo verde (aquele check de empresa verificada), estatísticas de entrega e leitura, e prioridade no suporte da Meta caso algo dê errado.

Como funciona a API não oficial do WhatsApp?

A API não oficial do WhatsApp funciona de um jeito completamente diferente: em vez de usar a infraestrutura da Meta, ela simula uma sessão do WhatsApp Web. Bibliotecas como o Baileys fazem engenharia reversa do protocolo de comunicação entre o navegador e os servidores do WhatsApp, replicando tudo que um humano faria ao usar o WhatsApp Web.

Na prática, você escaneia um QR code com o celular, a sessão é criada, e a partir daí seu sistema pode enviar e receber mensagens como se fosse uma pessoa usando o WhatsApp no computador. Não precisa de aprovação da Meta, não precisa de CNPJ, não precisa cadastrar templates. Qualquer número de WhatsApp serve.

O que muda na prática

Sem janela de 24 horas. Se o número está conectado, você manda mensagem a qualquer momento, seja 10 minutos ou 10 dias depois do último contato. Isso muda radicalmente como você desenha automações.

Sem templates obrigatórios. Toda mensagem é texto livre. Quem já precisou encaixar um fluxo de chatbot dentro das regras de templates da Meta sabe como isso facilita a vida.

Você também consegue enviar mensagens para grupos, alterar status, usar botões personalizados sem aprovação e acessar funcionalidades que simplesmente não existem na API oficial. Para MVPs e automações rápidas, essa flexibilidade faz muita diferença.

Os riscos que vêm junto

Nada disso é de graça. A API não oficial do WhatsApp depende de engenharia reversa. Se o WhatsApp atualizar o protocolo do WhatsApp Web amanhã, sua conexão pode quebrar até que a biblioteca seja atualizada. Já aconteceu.

O risco mais sério é o banimento. O WhatsApp pode bloquear seu número a qualquer momento se identificar padrão de uso automatizado fora das regras, conforme os termos de serviço para empresas. Sem aviso, sem recurso, sem SLA. Se você depende de um único número para toda a operação de atendimento, isso é um problema grave.

API oficial vs não oficial: qual a diferença na prática?

A diferença começa na tecnologia (servidores da Meta contra emulação do WhatsApp Web) e termina no modelo de cobrança, que é o que mais impacta a sua conta no fim do mês. A tabela abaixo resume os critérios que realmente pesam na decisão:

CritérioAPI oficial (Cloud API)API não oficial (QR code)
Como conectaMeta Business Manager + número dedicadoQR code no WhatsApp Web
Requer CNPJSimNão
Tempo de setupDias a semanas (verificação)Minutos
Modelo de cobrançaPor mensagem de template entregueAssinatura por instância (R$29 a R$199/mês)
Escala o custo comTemplates disparados, por categoriaQuantidade de números conectados
Resposta ao cliente na janela de 24hGrátis e ilimitada até 30/09/2026Incluída na assinatura
TemplatesObrigatórios fora da janelaNão existem, texto livre
Janela de 24 horasSimNão
Risco de banimentoPraticamente nuloReal e sem recurso
EstabilidadeAlta, protocolo mantido pela MetaDepende da biblioteca acompanhar o protocolo
Selo verde de empresaSimNão
Grupos e listas amplasNãoSim
Botões personalizadosSó via template aprovadoLivres
Métricas de entrega e leituraPainel oficial da MetaDepende do provedor
SLA e suporte da MetaSimNenhum
Compliance e auditoriaAdequadoInadequado para setores regulados

Quanto custa cada caminho na prática?

Os dois modelos cobram por eixos opostos: a oficial cobra pelos templates que você dispara, a não oficial cobra pelos números que você mantém conectados. Nenhum dos dois olha para o eixo do outro, e é por isso que a mesma empresa pode ter respostas diferentes mudando só o formato do tráfego.

Na API oficial, o custo é o total de templates enviados vezes o preço da categoria. Conectar dez números não muda nada na fatura. E enquanto a janela de 24 horas for gratuita, o que vale até 30 de setembro de 2026, tudo que é resposta a cliente sai por zero.

Na API não oficial, o custo é a quantidade de instâncias vezes a assinatura. O mercado brasileiro cobra entre R$29 e R$199 por instância por mês com mensagens ilimitadas, e a Z-API publica R$99,99 por instância, que serve bem como meio de faixa. Uma instância que manda 200 mensagens custa o mesmo que uma que manda 200 mil.

Contra uma instância de R$99 por mês, o ponto de virada fica perto de 290 mensagens de marketing, 580 de authentication ou 2.200 de utility. Abaixo disso a oficial custa menos. Acima, a assinatura fixa começa a compensar.

Cenário realCusto na API oficialCusto na API não oficial
Suporte com 20.000 mensagens/mês dentro da janela, 1 númeroR$0 nas respostas até 30/09/2026cerca de R$99
1 número, 1.200 mensagens de utility de pedido e rastreioR$48 a R$60cerca de R$99
10 números, 2.000 mensagens de marketing no totalR$620 a R$760cerca de R$990
Agência, 30 números, 800 mensagens de marketing por númeroR$7.440 a R$9.120R$2.970, previsível
Campanha de marketing para 5.000 contatosR$1.550 a R$1.900custo da instância, com risco de bloqueio

A primeira linha derruba o preconceito mais comum do mercado. Operação de atendimento, em que é sempre o cliente que puxa a conversa, é hoje o cenário em que a API oficial custa menos, não mais. Quem foge da oficial "porque cobra por mensagem" está pagando assinatura para evitar um custo que ainda nem existe.

E é a linha que mais muda em outubro de 2026. Quando a mensagem de serviço ganhar preço, o atendimento passa a ter ponto de virada próprio, e essa tabela precisa ser refeita com o valor que a Meta publicar em setembro. Para rodar a conta com os seus números, e não com os meus, use a calculadora de custos do WhatsApp.

Olhe agora a linha da agência, que é o espelho invertido. Trinta números com tráfego modesto, quase tudo marketing, e a assinatura fixa sai três vezes mais barata. A diferença cresce a cada cliente novo.

Duas empresas com o mesmo volume total de mensagens podem ter respostas opostas, então a conta começa separando o tráfego em dois baldes: quanto é o cliente te chamando e quanto é você chamando o cliente. O primeiro balde é gratuito na oficial. O segundo tem preço por categoria, e é ele que decide.

Quais são os riscos que ninguém conta?

Os dois caminhos têm riscos sérios, e nenhum material de vendas fala dos dois lados. Vamos ser honestos.

A API não oficial pode resultar em banimento permanente do número. Já vimos projetos pararem no meio de uma campanha de vendas porque o número foi bloqueado sem aviso. O CRM inteiro ficou inoperante até conseguirem um número novo e reconectar tudo. A engenharia reversa pode quebrar quando o WhatsApp atualiza o protocolo, e não existe prazo para correção, depende da comunidade open source ou do provedor. Não tem SLA, não tem suporte da Meta, não tem garantia de nada.

A API oficial tem outro tipo de problema. A burocracia do Meta Business Manager é real: verificação de empresa pode demorar, documentação pode ser recusada, e muitas PMEs simplesmente não conseguem passar pelo processo. A janela de 24 horas obriga você a repensar todo o fluxo do seu bot ou automação. Templates engessam campanhas de última hora, cada um precisa de aprovação individual. E o custo por mensagem não tem teto, então uma campanha grande vira fatura grande, linearmente, sem desconto nenhum no caso de marketing.

Nenhum dos dois caminhos é perfeito. Se alguém te diz o contrário, está vendendo algo.

O que cada modelo permite (e o que não permite)?

A API oficial entrega governança, a não oficial entrega liberdade. A API oficial dá acesso ao selo verde de empresa verificada, algo que só existe no canal oficial. Você também tem métricas de entrega, leitura e resposta direto no painel da Meta, envio de templates com variáveis dinâmicas e bloqueio proativo de spam. Para empresas que precisam de auditoria e rastreabilidade, é o único caminho viável.

A API não oficial permite coisas que a oficial simplesmente não faz. Envio para grupos, alteração de status, listas de transmissão sem limite, botões personalizados sem aprovação prévia, fluxos de conversa sem restrição de janela de tempo. Se seu caso de uso envolve interações criativas ou fora do padrão, a não oficial dá muito mais liberdade.

RecursoAPI oficialAPI não oficial
Texto, mídia e arquivosSimSim
Webhooks e REST APISimSim
Make, n8n e ZapierSimSim
Selo verde de verificaçãoSimNão
Métricas oficiais de entrega e leituraSimNão
Templates com variáveis dinâmicasSimNão se aplica, texto livre
Envio para gruposNãoSim
Alteração de statusNãoSim
Listas de transmissão amplasNãoSim
Botões sem aprovação préviaNãoSim

As duas compartilham o básico: envio e recebimento de texto, mídia e arquivos, integração via webhooks e REST API, e compatibilidade com ferramentas de automação como Make, n8n e Zapier. Se você quer entender melhor como essas integrações funcionam na prática, temos um guia completo sobre API de WhatsApp que cobre isso em detalhe.

Qual escolher? Recomendações por cenário

Pare de pensar em "melhor ou pior" e pense em "qual resolve meu problema agora". Depois de acompanhar dezenas de projetos, essa é a recomendação por cenário:

Seu cenárioCanal recomendadoPor quê
Campanhas de marketing em massaOficialCusta mais por mensagem, mas você não perde o número no meio da campanha
Setor regulado (financeiro, saúde, grande varejo)OficialCompliance, auditoria e LGPD não deixam alternativa
MVP, protótipo ou pilotoNão oficialNo ar em horas, sem burocracia nem aprovação de template
Atendimento interno com pouco volumeNão oficialCusto fixo baixo e nenhuma restrição de janela
Agência que dispara marketing para 20 a 30 clientesNão oficialO custo por instância vence o preço por mensagem de marketing
Atendimento de alto volume dentro da janela de 24hOficialResposta ao cliente não é cobrada até 30 de setembro de 2026
Notificação transacional em alto volume, 1 númeroOficial, mesmo custando maisO preço favorece a instância, mas dezenas de milhares de envios numa linha de QR code é o padrão que faz o WhatsApp bloquear

Se você precisa fazer campanhas de marketing em massa, use a API oficial mesmo sabendo que ela sai mais cara. Marketing é a categoria mais salgada da tabela e não tem desconto por volume, então a conta sobe linear com o disparo. Ainda assim compensa: segmentação, rastreamento de entrega e nenhuma chance de perder a linha no meio da campanha. Se seu setor exige compliance, auditoria ou LGPD, não tem alternativa: oficial.

Se você está validando um MVP, montando um protótipo ou precisa de algo funcionando em horas e não em semanas, a API não oficial é mais rápida de configurar. Sem burocracia, sem aprovação de templates, custo fixo baixo. O risco de ban existe, mas para um piloto com volume baixo, geralmente é aceitável.

O cenário que mais vemos funcionar bem é o híbrido. A empresa começa com o não oficial para validar rápido, ganha tração, e migra os números de maior volume ou maior risco para a API oficial. Os dois canais coexistem, cada um fazendo o que faz melhor.

E se você pudesse usar as duas na mesma plataforma?

Esse é o problema que a Zapster API resolve. Você cria instâncias oficiais e não oficiais na mesma conta, com a mesma API, o mesmo dashboard e os mesmos webhooks. Se um número precisa migrar de QR code para Cloud API, você troca o canal sem alterar uma linha de código na sua integração.

Na prática, três perguntas ajudam a decidir qual canal usar para cada número:

  • O número atende clientes que exigem compliance ou auditoria? Cloud API.
  • É um número de teste, MVP ou vendedor individual com baixo volume? Não oficial, com migração futura se precisar.
  • Quem inicia a maior parte das conversas nesse número? Se é o cliente, Cloud API sai quase de graça. Se é você, com template de marketing, a instância fixa sai mais barata.

Se você quer comparar a Zapster com outras opções do mercado, publicamos um comparativo completo das melhores APIs de WhatsApp em 2026. Para quem vem da Evolution API, temos um guia prático de migração para a nuvem. E para quem está entre Zapster e Z-API, tem o comparativo de preços e diferenças.

Quem quer testar na prática, a Zapster tem sandbox gratuita com ambos os canais disponíveis. Você cria a conta, conecta um número e testa em minutos. Se quiser entender como integrar com CRMs, temos um tutorial que cobre isso em menos de 30 minutos.

Principais conclusões

  • A API oficial cobra por mensagem de template entregue desde 1º de julho de 2025, e não mais por conversa de 24 horas. Qualquer material que fale em preço por conversa está desatualizado.
  • Responder o cliente dentro da janela de 24 horas é gratuito e ilimitado desde 1º de novembro de 2024, e o teto antigo de mil conversas por mês não existe mais. Esse gratuito vale até 30 de setembro de 2026: a partir de 1º de outubro a Meta cobra também as mensagens de serviço, com valores anunciados até setembro e sem desconto por volume.
  • No Brasil, integradores observam em 2026 R$0,04 a R$0,05 por mensagem de utility, R$0,15 a R$0,19 de authentication e R$0,31 a R$0,38 de marketing. Confirme o valor da sua conta no painel da Meta.
  • A API não oficial dá flexibilidade, custo fixo entre R$29 e R$199 por instância e velocidade de setup, mas tem risco real de banimento e depende de engenharia reversa acompanhar o protocolo.
  • O que decide a conta é o mix, não o volume total. Tráfego iniciado pelo cliente favorece a oficial. Disparo de template, sobretudo marketing, favorece a instância fixa.
  • Marketing em massa, setor regulado e necessidade de selo verde eliminam a dúvida: oficial, mesmo custando mais.
  • MVP, protótipo, atendimento interno e agência que dispara para muitas linhas: não oficial resolve mais rápido e mais barato.
  • Contas brasileiras são faturadas em reais desde 1º de julho de 2026, e quem ainda está em dólar tem até 30 de junho de 2027 para migrar.
  • O erro mais comum é escolher um canal e ficar preso nele. Construa a integração de forma que trocar de canal seja trivial, não um projeto de refatoração.

Conclusão

A melhor decisão que você pode tomar agora não é escolher um lado, é reduzir o custo de trocar de lado. Se sua integração depende de um único canal e esse canal falha, você perde dias (ou semanas) migrando.

Se quiser entender mais sobre como a API oficial funciona em detalhe, temos um guia prático de integração e escala com a API oficial.


Fontes

Perguntas frequentes

Pronto para enviar sua primeira mensagem?

Crie uma conta e conecte um número em poucos minutos, sem servidor nem Docker.

Começar agora

Continue lendo