Retents
← Todos os posts

WhatsApp API oficial: como funciona e quanto custa

10 de julho de 2026 por Equipe Retents 12 min de leitura

A API oficial do WhatsApp — chamada pela Meta de WhatsApp Business Platform — é a infraestrutura para conectar o canal a sistemas, automações e equipes. Ela faz sentido quando a empresa precisa sair do uso isolado do aplicativo e operar conversas com integração, controle e escala.

A resposta curta sobre custo é: a Meta cobra por mensagem entregue sujeita à cobrança, conforme a categoria e as exceções aplicáveis. No Brasil, a tabela vigente desde 1º de julho de 2026 cobra R$ 0,3217 por mensagem de marketing e R$ 0,0350 por mensagem tarifável de utilidade ou autenticação. Modelos de utilidade enviados em resposta ao usuário e entregues dentro de uma janela aberta de atendimento não são cobrados. Mensagens de serviço não têm tarifa Meta nessa tabela. A partir de 1º de outubro de 2026, a tarifa nominal anunciada para serviço é de R$ 0,0350, mas cada número comercial tem 1.000 mensagens de serviço gratuitas por mês; a cobrança começa na 1.001ª.

Esses valores são só a tarifa da Meta. Mensalidade de BSP ou plataforma, implantação, integrações, atendimento, automação e impostos podem ser cobrados à parte. Por isso, comparar apenas o preço unitário da mensagem quase nunca revela o custo total da operação.

O que é a API oficial do WhatsApp

A API é uma interface: ela permite que sistemas enviem e recebam mensagens pelo WhatsApp seguindo as regras da Meta. Diferentemente do WhatsApp Business App, a API foi desenhada para ser conectada a uma camada de software. Essa camada pode organizar a caixa de entrada, distribuir conversas, consultar dados do pedido, acionar automações e registrar histórico.

Isso também explica um mal-entendido comum: contratar acesso à API não entrega, por si só, um painel completo, um CRM ou uma operação pronta. A infraestrutura oficial habilita essas capacidades; o resultado depende da plataforma escolhida, das integrações e do processo do time. Se a decisão ainda está na camada de ferramenta, veja como avaliar uma plataforma de WhatsApp para empresas .

Na prática, uma operação pode usar a Cloud API diretamente, com desenvolvimento próprio, ou contratar um provedor e uma plataforma que abstraiam parte do trabalho técnico. Em ambos os casos, é preciso cuidar de configuração, consentimento, modelos de mensagem, roteamento, dados e acompanhamento.

API oficial, WhatsApp Business App e plataforma: qual é a diferença?

  • WhatsApp Business App: aplicativo voltado à operação mais simples, normalmente manual e com recursos nativos do próprio app.
  • WhatsApp Business Platform/API: infraestrutura oficial da Meta para integrar o WhatsApp a sistemas e fluxos programáveis.
  • BSP: provedor que pode facilitar acesso, configuração, suporte e cobrança, conforme a oferta contratada.
  • Plataforma de atendimento ou CRM: camada usada pelo time para atender, distribuir filas, automatizar tarefas, consultar contexto e medir resultados.

Essas peças podem estar reunidas em um mesmo fornecedor, mas não são sinônimos. Antes de contratar, peça que a proposta separe tarifa Meta, mensalidade da plataforma, serviços, integrações e impostos.

Quanto custa a API oficial do WhatsApp no Brasil?

A cobrança oficial considerada aqui é por mensagem entregue sujeita à cobrança e usa a categoria atribuída à mensagem. Não entram na conta mensagens às quais se aplica uma exceção da Meta: entre elas, modelos de utilidade enviados em resposta ao usuário e entregues dentro de uma janela aberta de atendimento. A partir de 1º de outubro de 2026, também não entram as primeiras 1.000 mensagens de serviço de cada número comercial em cada mês. Os valores abaixo foram extraídos das tabelas oficiais da Meta em BRL para o mercado Brasil.

Tarifas oficiais da Meta para o Brasil

  • Marketing — vigente desde 01/07/2026: R$ 0,3217 por mensagem; a partir de 01/10/2026: R$ 0,3217.
  • Utilidade — vigente desde 01/07/2026: R$ 0,0350 por mensagem; a partir de 01/10/2026: R$ 0,0350.
  • Autenticação — vigente desde 01/07/2026: R$ 0,0350 por mensagem; a partir de 01/10/2026: R$ 0,0350.
  • Serviço — vigente desde 01/07/2026: sem tarifa Meta; a partir de 01/10/2026: R$ 0,0350 nominal, com 1.000 mensagens gratuitas por número/mês.

“Sem tarifa Meta” significa que a tabela vigente não atribui preço Meta à categoria de serviço. Não significa que toda a operação seja gratuita: o fornecedor ainda pode cobrar plataforma, atendimento, infraestrutura, serviços e impostos. Na tabela futura, R$ 0,0350 é a tarifa nominal de serviço, aplicada somente depois da franquia mensal de 1.000 mensagens gratuitas de serviço por número comercial. A tabela futura é um aviso de mudança programada; até entrar em vigor, o cálculo aplicável continua sendo o da tabela vigente.

O que significa cada categoria

  • Marketing: mensagens promocionais, ofertas, recomendações ou comunicações destinadas a estimular uma compra ou ação comercial.
  • Utilidade: atualizações ligadas a uma transação ou solicitação do cliente, como informações de pedido, pagamento ou entrega, desde que o conteúdo corresponda à categoria aprovada. Um modelo de utilidade enviado em resposta ao usuário e entregue dentro de uma janela aberta de atendimento não é cobrado; fora dessas condições, a mensagem de utilidade entregue é tarifável.
  • Autenticação: códigos e fluxos de verificação de identidade.
  • Serviço: respostas no contexto de atendimento iniciado pelo cliente, conforme as regras e a janela aplicável da Meta.

A categoria não deve ser escolhida apenas pelo menor preço. O conteúdo e a finalidade precisam corresponder às regras da Meta, e a classificação pode afetar aprovação e cobrança. Consulte sempre a documentação oficial de preços do WhatsApp e a seção oficial sobre tarifas de serviço a partir de 1º de outubro de 2026 antes de fechar orçamento ou campanha.

Como calcular o custo: fórmula e três cenários

A conta-base usa somente mensagens entregues sujeitas à cobrança: quantidade tarifável em cada categoria × tarifa unitária da categoria. Depois, somam-se as categorias. Em utilidade, exclua os modelos enviados em resposta ao usuário e entregues dentro de uma janela aberta de atendimento. Para serviço a partir de 1º de outubro de 2026, subtraia a franquia de 1.000 mensagens por número comercial/mês, sem deixar o resultado ficar negativo. Para chegar ao custo total, acrescente os itens comerciais do fornecedor e os impostos aplicáveis.

Fórmula da tarifa Meta = (marketing tarifável × R$ 0,3217) + (utilidade tarifável × R$ 0,0350) + (autenticação tarifável × R$ 0,0350) + (serviço tarifável × tarifa vigente). A partir de 01/10/2026, serviço tarifável por número/mês = máximo entre zero e (mensagens de serviço entregues − 1.000).

Cenário 1: 10 mil mensagens de utilidade

Hipótese: 10.000 mensagens entregues, todas corretamente classificadas como utilidade e tarifáveis, ou seja, nenhuma foi enviada em resposta ao usuário e entregue dentro de uma janela aberta de atendimento. Cálculo: 10.000 × R$ 0,0350 = R$ 350,00 de tarifa Meta. Plataforma, BSP, implantação, integrações e impostos não estão incluídos.

Cenário 2: 5 mil mensagens de marketing e 15 mil de utilidade

Hipótese: todas as 5.000 mensagens de marketing e as 15.000 de utilidade entregues são tarifáveis; portanto, nenhuma mensagem de utilidade está na exceção de resposta ao usuário dentro da janela aberta de atendimento. Marketing: 5.000 × R$ 0,3217 = R$ 1.608,50. Utilidade: 15.000 × R$ 0,0350 = R$ 525,00. Total: R$ 2.133,50 de tarifa Meta. O exemplo mostra por que o mix importa: mesmo com menos volume, marketing representa a maior parte da conta.

Cenário 3: operação mista antes e depois de 1º de outubro

Hipótese: 3.000 mensagens de marketing e 12.000 de utilidade tarifáveis, além de 5.000 mensagens de serviço entregues por um único número comercial em um único mês, sem outras mensagens de serviço nesse número/mês. Nenhuma mensagem de utilidade está na exceção de resposta ao usuário dentro da janela aberta de atendimento. Marketing: 3.000 × R$ 0,3217 = R$ 965,10. Utilidade: 12.000 × R$ 0,0350 = R$ 420,00.

Pela tabela vigente desde 1º de julho, serviço não tem tarifa Meta: total de R$ 1.385,10. Pela regra anunciada para 1º de outubro, as primeiras 1.000 mensagens de serviço do número no mês são gratuitas e a cobrança começa na 1.001ª. Assim, 5.000 − 1.000 = 4.000 mensagens de serviço tarifadas; 4.000 × R$ 0,0350 = R$ 140,00. O total futuro é R$ 1.525,10, uma diferença de R$ 140,00 neste cenário.

Os cenários são simulações aritméticas, não dados de clientes nem orçamento comercial. O valor real depende do volume entregue sujeito à cobrança e classificado em cada categoria, das exceções aplicáveis, da quantidade de números comerciais, das condições do fornecedor e dos tributos.

O que entra no custo total além da tarifa Meta

Um orçamento responsável separa pelo menos cinco blocos:

  1. Tarifa Meta: volume entregue sujeito à cobrança por categoria multiplicado pela tabela aplicável, depois das exceções e franquias pertinentes.
  2. BSP ou plataforma: mensalidade, franquia, markup ou outra regra comercial do fornecedor.
  3. Implantação e integração: configuração do número, templates, webhooks, CRM, ERP, e-commerce e migração de processos.
  4. Operação: atendentes, desenho de fila, supervisão, manutenção de automações e análise.
  5. Impostos: variam conforme fornecedor, contrato e regime tributário.

Também vale medir o custo por desfecho, não só por mensagem. Uma campanha barata que gera conversas irrelevantes pode sair cara; uma mensagem de utilidade bem conectada ao pedido pode reduzir contatos repetidos. Volume é uma parte da decisão, não a decisão inteira.

Quando a API oficial costuma valer a pena

  • Mais de uma pessoa precisa atuar no mesmo número com distribuição e supervisão.
  • O WhatsApp precisa consultar ou atualizar CRM, ERP, loja ou dados de pedido.
  • Existem fluxos recorrentes e bem definidos para automatizar.
  • O negócio precisa acompanhar tempo de resposta, fila, conversão, recuperação ou retenção.
  • O canal já participa de vendas, pós-venda ou recompra e não pode depender de improviso.

Se o gargalo principal é coordenação entre pessoas, aprofunde a decisão no guia de multiatendimento no WhatsApp . Se o desafio é histórico e contexto comercial, veja os critérios de um CRM para WhatsApp .

Quando pode ser cedo demais

A API pode adicionar custo e complexidade sem retorno quando o volume é baixo, os casos de uso ainda são vagos ou ninguém será responsável pela operação. Também é cedo quando a empresa espera que a tecnologia corrija, sozinha, fila mal desenhada, falta de consentimento, dados ruins ou ausência de prioridade.

Nessa situação, vale primeiro mapear por que as pessoas entram em contato, quais conversas exigem humano, quais dados estão disponíveis e que resultado será acompanhado. Só então fica mais fácil decidir entre app, API direta, BSP, plataforma de atendimento ou CRM.

Como escolher e implementar sem comprar complexidade

1. Comece por dois ou três casos de uso

Escolha fluxos com começo, regra e resultado claros: atualização de pedido, triagem de pré-venda, pagamento pendente ou reposição. Uma lista extensa no primeiro dia aumenta o risco de automações sem contexto.

2. Modele o volume por categoria

Use dados próprios de mensagens entregues, se já existirem. Separe marketing, utilidade, autenticação e serviço; identifique quais mensagens estão sujeitas à cobrança; aplique as exceções e franquias por número/mês; use a tarifa da data do orçamento; crie uma margem para sazonalidade; e registre as hipóteses. Não use uma média única para categorias com preços tão diferentes.

3. Exija uma proposta de custo aberta

Peça ao fornecedor uma linha para tarifa Meta e outras para plataforma, BSP, implantação, suporte, integrações e impostos. Confirme também como reajustes e mudanças da Meta serão repassados.

4. Desenhe a passagem entre automação e humano

Defina quando a automação resolve, quando coleta contexto e quando transfere. O atendente precisa receber histórico suficiente para não obrigar o cliente a repetir tudo. A arquitetura pode combinar triggers comportamentais com uma camada humana bem organizada, desde que cada acionamento tenha finalidade e consentimento adequados.

5. Meça qualidade e resultado

Acompanhe entrega, bloqueios, qualidade dos modelos, tempo de resposta e transferência. Depois conecte essas métricas a desfechos de negócio: pedido concluído, problema resolvido, recompra ou retenção. Se houver automação conversacional, avalie também a cobertura, os erros e a necessidade de intervenção humana antes de ampliar o escopo.

Perguntas frequentes

A API oficial do WhatsApp é gratuita?

Não como regra geral. A Meta cobra mensagens entregues sujeitas à cobrança, conforme categoria, tabela e exceções aplicáveis. Modelos de utilidade enviados em resposta ao usuário e entregues dentro de uma janela aberta de atendimento não são cobrados. Na tabela brasileira vigente desde 1º de julho de 2026, serviço aparece sem tarifa Meta; a partir de 1º de outubro, cada número comercial mantém 1.000 mensagens de serviço gratuitas por mês antes da tarifa nominal. Outros custos do fornecedor e impostos podem existir.

Quanto custa uma mensagem pela API no Brasil?

Na tabela vigente desde 1º de julho de 2026: marketing custa R$ 0,3217; utilidade tarifável, R$ 0,0350; autenticação, R$ 0,0350; e serviço não tem tarifa Meta. Na tabela anunciada para 1º de outubro de 2026, os três primeiros valores permanecem e serviço tem tarifa nominal de R$ 0,0350, com 1.000 mensagens de serviço gratuitas por número comercial/mês e cobrança a partir da 1.001ª.

A Meta cobra por conversa ou por mensagem?

As tabelas usadas neste artigo informam custo por mensagem entregue sujeita à cobrança na WhatsApp Business Platform. Para orçamento, conte as mensagens tarifáveis por categoria depois de excluir as exceções — como utilidade em resposta ao usuário dentro da janela aberta de atendimento — e aplicar a franquia de serviço pertinente; consulte também as regras oficiais vigentes na data de uso.

API oficial já inclui painel e multiatendimento?

Não necessariamente. A API é a infraestrutura. Painel, distribuição de fila, CRM, automações e relatórios dependem da solução conectada ou desenvolvida pela empresa.

É obrigatório contratar um BSP?

A empresa pode avaliar integração direta com a Cloud API ou uma oferta de provedor/plataforma. A melhor rota depende da capacidade técnica, do suporte necessário, das integrações e do modelo de custo.

Como evitar que o orçamento fique desatualizado?

Registre a data da tabela, separe cada categoria e confirme a página oficial de preços antes de aprovar o orçamento. Mudanças anunciadas para uma data futura não devem ser tratadas como vigentes antes dela.

Conclusão

A API oficial do WhatsApp é indicada quando o canal precisa conversar com sistemas, distribuir trabalho e sustentar automações com governança. Para decidir, não basta perguntar quanto custa “a API”: é preciso projetar mensagens entregues sujeitas à cobrança por categoria, aplicar exceções e franquias e somar plataforma, BSP, implantação, operação e impostos.

No Brasil, a diferença entre marketing e utilidade é grande, e a cobrança anunciada para serviço a partir de 1º de outubro de 2026 muda o planejamento de operações com muito atendimento iniciado pelo cliente, embora preserve 1.000 mensagens de serviço gratuitas por número comercial/mês. Faça a conta com o mix real, mantenha a data da tarifa visível e revise o modelo antes de cada ciclo de orçamento.

Se a próxima etapa for combinar infraestrutura oficial, contexto do e-commerce e automação conversacional, conheça como funciona um agente de IA para vendas e avalie onde a passagem para o time humano precisa permanecer.

Fontes oficiais