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

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 existe em duas versões técnicas: a Cloud API, hospedada gratuitamente pela própria Meta (o padrão atual e recomendado), e a antiga On-Premises API, que a Meta está descontinuando. Quando alguém fala em “API oficial do WhatsApp” hoje, quase sempre se refere à Cloud API.

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.

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. Marketing e autenticação já são pagas por mensagem; atendimento (serviço) e utilidade seguem gratuitas até 1º de outubro de 2026, quando passam a ser cobradas (veja a seção sobre a nova precificação). Some a isso o custo da plataforma que conecta você à API.

O custo total tem duas partes independentes:

1. Custo da Meta (mensagens): marketing e autenticação são cobradas por mensagem entregue. As mensagens de utilidade e de atendimento (serviço) são gratuitas até 1º de outubro de 2026 e passam a ser cobradas a partir dessa data. 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 contatos únicos atendidos, a partir de R$ 249,90/mês, com 7 dias grátis.

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

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

A Meta está migrando da cobrança por conversa (a antiga janela de 24 horas) para a cobrança por mensagem. A mudança principal: a partir de 1º de outubro de 2026, as mensagens de utilidade e de atendimento (serviço), hoje gratuitas, passam a ser cobradas por mensagem. Marketing e autenticação já são pagas.

Até então, o custo era calculado por conversa dentro de uma janela de 24 horas. O novo modelo cobra por mensagem entregue, por categoria. Veja o que muda e quando:

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 muda é que responder dentro dela deixa de ser gratuito para as categorias de utilidade e serviço a partir de 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 utilidade e atendimento a partir de outubro de 2026 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 de telefone que não esteja em uso no WhatsApp comum, uma conta no Gerenciador de Negócios da Meta e um parceiro homologado (Meta Tech Provider) para conectar tudo. 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, ainda não registrado no app WhatsApp ou WhatsApp Business (ou pronto para migrar).
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 (marketing e autenticação já são pagas; utilidade e atendimento ficam gratuitos até 1º de outubro de 2026) e paga pela plataforma que conecta você à API e organiza o atendimento.

A Meta vai cobrar pelas conversas de atendimento em 2026?

Sim. A partir de 1º de outubro de 2026, as mensagens de utilidade e de atendimento (serviço) — hoje gratuitas — passam a ser cobradas por mensagem, dentro da migração da Meta de cobrança por conversa para cobrança por mensagem. Marketing e autenticação já são pagas. Consulte a tabela oficial vigente da Meta para o Brasil.

Preciso de um número novo para usar a API do WhatsApp?

O número precisa não estar ativo no aplicativo WhatsApp ou WhatsApp Business no momento da conexão. É possível migrar um número existente, mas ele deixa de funcionar no app comum e passa a operar exclusivamente 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.