API do WhatsApp

API oficial do WhatsApp (Cloud API): o que é, como funciona e quanto custa

Equipe RuvzAtualizado em 10 min de leitura

A API oficial do WhatsApp é o caminho que a Meta oferece para empresas atenderem, venderem e enviarem notificações em escala — com vários atendentes, automação e IA, sem o risco de bloqueio das soluções não oficiais. Este guia explica, em português claro, o que ela é, como funciona na prática, quanto custa de verdade e o que você precisa para começar.

O que é a API oficial do WhatsApp?

A API oficial do WhatsApp (WhatsApp Business Platform) é a interface que a Meta disponibiliza para empresas conectarem o WhatsApp a sistemas próprios — CRM, automação e IA. Ao contrário do aplicativo comum, ela permite vários atendentes no mesmo número, disparo de campanhas por modelo e integração com software, tudo dentro das regras da Meta.

Ela aparece com vários nomes: API do WhatsApp, WhatsApp API, WhatsApp Business API e WhatsApp Cloud API. Hoje são a mesma coisa: a Cloud API, hospedada pela própria Meta. A versão On-Premises, que a empresa instalava no próprio servidor, foi descontinuada pela Meta em outubro de 2025.

Na prática, você não usa a API diretamente: conecta sua empresa a ela por meio de um parceiro homologado pela Meta (um Meta Tech Provider / BSP, como a Ruvz), que cuida da infraestrutura e entrega uma interface pronta de atendimento, campanhas e IA.

Qual a diferença entre API oficial, WhatsApp Business (app) e APIs não oficiais?

O app WhatsApp Business serve para um único operador em um celular. A API oficial serve para times: vários atendentes no mesmo número, automação, IA e campanhas por modelo aprovado. Já as APIs não oficiais (que automatizam o app) violam os termos da Meta e podem levar ao banimento do número a qualquer momento.

RecursoApp WhatsApp BusinessAPI oficial (Cloud API)API não oficial
Vários atendentes no mesmo númeroNãoSimSim
Automação e IALimitadaSimSim
Campanhas por modelo aprovadoNãoSimNão
Selo de conta verificadaNãoSimNão
Risco de bloqueio/banimentoBaixoBaixo (dentro das regras)Alto
Homologado pela MetaSimSimNão

O resumo: o app é para quem atende sozinho; a API oficial é para operações que precisam de escala e continuidade; e a API não oficial economiza no curto prazo, mas coloca o seu número — e o seu atendimento — em risco permanente.

Como funciona a API do WhatsApp na prática?

Funciona por sessões de 24 horas. Quando um cliente envia uma mensagem, abre-se uma janela de 24h em que a empresa pode responder livremente. Fora dessa janela, para iniciar a conversa a empresa só pode enviar mensagens em modelos (templates) previamente aprovados pela Meta — o que evita spam.

Os modelos (também chamados de HSM) são mensagens pré-cadastradas — confirmação de pedido, lembrete de agendamento, promoção — que passam por aprovação da Meta antes de poderem ser disparadas. Depois de aprovados, você os usa em campanhas e automações sem risco de bloqueio.

  • Cliente manda mensagem → abre a janela de 24h de atendimento livre.
  • Dentro das 24h → você responde qualquer texto, imagem ou áudio.
  • Fora das 24h → só é possível reabrir a conversa com um modelo aprovado.
  • A Meta acompanha a qualidade do seu número (classificação verde, amarela ou vermelha) com base em bloqueios e denúncias.

Quanto custa a API oficial do WhatsApp?

A Cloud API não cobra pela infraestrutura — hospedar é gratuito. O que a Meta cobra são as mensagens, por categoria. Os modelos de marketing, autenticação e utilidade são pagos por mensagem; as respostas de atendimento dentro da janela de 24h são cobradas acima de 1.000 por mês por número desde 1º de outubro de 2026. Some a isso o custo da plataforma que conecta você à API.

O custo total tem duas partes independentes:

  1. Custo da Meta (mensagens): os modelos de marketing, autenticação e utilidade são cobrados por mensagem entregue, inclusive dentro da janela de 24h. As respostas de atendimento são cobradas depois das 1.000 grátis por mês, por número. Os valores variam por país e categoria — consulte sempre a tabela oficial vigente da Meta para o Brasil.
  2. Custo da plataforma/CRM: o software que conecta sua empresa à API, organiza os atendimentos e roda a automação e a IA. Na Ruvz, isso é um plano mensal por volume de clientes únicos atendidos pela IA, a partir de R$ 249,90/mês.

Ou seja: não existe uma “taxa da API” única. Você paga a Meta pelas mensagens fora da cota grátis e paga a plataforma pela camada de atendimento, campanhas e IA que torna o número utilizável por um time.

O que mudou na precificação do WhatsApp em 2026?

Desde julho de 2025 a Meta cobra por mensagem entregue, e não mais por conversa. Em 2026, a mudança principal: desde 1º de outubro, as respostas de atendimento (serviço) e os modelos de utilidade enviados dentro da janela de 24h, antes gratuitos, são cobrados. Cada número tem 1.000 mensagens de atendimento grátis por mês.

Veja o que mudou e quando:

Tipo de mensagemSituaçãoA partir de
Modelo de marketingPaga por mensagemJá em vigor
Modelo de autenticaçãoPaga por mensagemJá em vigor
Modelo de utilidade fora da janelaPaga por mensagemJá em vigor
Modelo de utilidade dentro da janelaEra gratuita, agora paga por mensagem1º de outubro de 2026
Atendimento (serviço)Era gratuita, agora paga acima de 1.000 por mês, por número1º de outubro de 2026
Meta Business Agent (IA da própria Meta)Cobrada por token1º de agosto de 2026

A janela de 24 horas de atendimento continua existindo — ela ainda abre a cada mensagem do cliente e define quando você pode responder em texto livre sem modelo. O que mudou é que responder dentro dela deixou de ser gratuito em outubro de 2026. Os detalhes, com preços no Brasil e exemplos de custo, estão no guia sobre a nova cobrança do WhatsApp em outubro de 2026.

Os valores por mensagem variam por país e por categoria e são atualizados pela Meta ao longo do tempo. Consulte sempre a tabela oficial vigente para o Brasil na documentação da Meta (developers.facebook.com), e não uma referência antiga — foi justamente esse o ponto que mudou.

Na prática, o recado é planejar o orçamento de mensagens de atendimento e de utilidade dentro da janela e priorizar automações que resolvam na primeira resposta. Na Ruvz, o consumo por contato fica visível no painel, o que ajuda a acompanhar esse custo.

Como usar a API sem risco de bloqueio ou banimento?

Use a API oficial (nunca soluções que automatizam o app comum), envie campanhas apenas por modelos aprovados, colete opt-in de quem vai receber mensagens e mantenha a qualidade do número evitando denúncias. Dentro dessas regras, a própria Meta protege o seu número — o banimento acontece justamente fora delas.

  • Conecte-se pela API oficial via um Meta Tech Provider homologado — não por “robôs” que pilotam o WhatsApp comum.
  • Envie mensagens iniciadas pela empresa somente com modelos aprovados pela Meta.
  • Tenha opt-in: só envie campanhas para quem concordou em receber.
  • Monitore a qualidade do número (verde/amarelo/vermelho) e reduza disparos se a classificação cair.
  • Respeite a LGPD no tratamento dos dados dos contatos.

O que eu preciso para começar?

Você precisa de um número comercial, uma conta no Gerenciador de Negócios da Meta e um parceiro homologado (Meta Tech Provider) para conectar tudo. Quem já usa o app WhatsApp Business pode manter o mesmo número pela coexistência. Com a Ruvz, esse processo é guiado: você conecta o número, aprova os primeiros modelos e começa a atender no mesmo dia.

  1. Um número de telefone dedicado ao negócio: pode ser o que você já usa no app WhatsApp Business, pela coexistência, ou um número novo.
  2. Uma conta no Gerenciador de Negócios (Meta Business Manager).
  3. Conexão à Cloud API por meio de um Meta Tech Provider homologado, como a Ruvz.
  4. Nome de exibição e primeiros modelos aprovados pela Meta.

A Ruvz é uma parceira oficial homologada pela Meta (Meta Tech Provider): sua conexão roda na API oficial do WhatsApp e Instagram, com selo de verificação, campanhas por modelo aprovado e dados na infraestrutura da própria Meta, em conformidade com a LGPD.

Perguntas frequentes

A API oficial do WhatsApp é gratuita?
A Cloud API não cobra pela infraestrutura — hospedar é gratuito. Você paga a Meta pelas mensagens (os modelos são pagos; as respostas de atendimento dentro da janela de 24h são grátis até 1.000 por mês, por número) e paga pela plataforma que conecta você à API e organiza o atendimento.
A Meta cobra pelas conversas de atendimento?
Sim. Desde 1º de outubro de 2026, as respostas de atendimento (serviço) são cobradas por mensagem acima de 1.000 por mês por número, e os modelos de utilidade enviados dentro da janela de 24h são cobrados desde a primeira. No Brasil, as duas custam R$ 0,035 por mensagem.
Preciso de um número novo para usar a API do WhatsApp?
Não. Pela coexistência, o modo oficial da Meta, o número do app WhatsApp Business continua funcionando no celular e na API ao mesmo tempo, e o que a equipe responde pelo app também aparece na Ruvz. Fora da coexistência, um número migrado deixa de funcionar no app e passa a operar só pela API.
Posso enviar campanhas em massa pela API oficial?
Sim, desde que use modelos aprovados pela Meta e envie apenas para contatos com opt-in. Isso é o que diferencia o disparo pela API oficial dos “robôs” não oficiais, que levam ao banimento do número.
O que é um Meta Tech Provider?
É uma empresa homologada pela Meta para conectar outras empresas à API oficial do WhatsApp e Instagram. A Ruvz é um Meta Tech Provider: cuida da infraestrutura e entrega uma plataforma pronta de atendimento, campanhas e IA.
Como integrar a API do WhatsApp ao meu sistema?
Pelo parceiro que conecta o seu número: o seu sistema envia mensagens por uma chamada HTTP e recebe as respostas num webhook. Na Ruvz, o plano API custa R$ 149 por mês no primeiro número, com desconto a partir do segundo, sem limite de mensagens; a documentação e um exemplo de envio estão na página da API.
Quanto custa a API oficial do WhatsApp por mês?
São duas contas: a da Meta, por mensagem, conforme a categoria e a tabela dela, cobrada direto na conta da empresa; e a da plataforma que conecta o número. Na Ruvz, o plano sem IA (API, disparo ou equipe na caixa de entrada) sai a partir de R$ 149 por número, e os planos com IA, a partir de R$ 249,90.