AI
← todos os guias

WhatsApp API oficial para cobrança: como funciona

Como conectar a API oficial do WhatsApp para cobrar: conta da Meta, templates, janela de 24h, custo por mensagem e a diferença para o número por QR code.

Decisão · 11 min · 13/11/2026

Resposta curta: a API oficial é o caminho que a Meta, dona do WhatsApp, oferece para empresa mandar mensagem em escala. Você conecta um número da empresa a uma conta da Meta, cadastra templates (mensagens-modelo que a Meta aprova), usa texto livre só nas 24 horas seguintes a uma resposta da pessoa e paga por mensagem entregue, com preço que depende da categoria e do país. O que ela não faz: não escolhe quem cobrar, não negocia e não dispensa regra de consentimento. Este texto explica a mecânica, compara com o app Business e com o número por QR code, e avisa onde ela costuma travar.

Resposta direta: o que a API oficial resolve e o que não resolve

O que resolve: um canal que a Meta reconhece para envio em volume, com templates aprovados, regras claras de custo e a possibilidade de pedir o selo de empresa verificada. O que não resolve: a API é só o encanamento. Alguém (você, um parceiro ou uma ferramenta) ainda precisa decidir quem recebe, o que se oferece, em que horário e quando parar. E ela traz atrito próprio: verificação, aprovação de template, custo por mensagem e limite inicial de envio.

Se você cobra poucas dezenas de pessoas por mês e quem cuida disso é uma pessoa do administrativo, a API oficial provavelmente é mais estrutura do que o problema pede. Se a carteira é de centenas ou milhares de contatos e a cobrança precisa sair todo mês, ela passa a fazer sentido. Se a dúvida for se cobrar pelo WhatsApp é permitido, veja Cobrança por WhatsApp é legal? A lei e as regras da Meta; aqui o foco é o canal.

App, QR code e API oficial: qual serve para quê

Existem três formas de ter um WhatsApp de empresa cobrando, e elas são bem diferentes em risco, custo e escala. A tabela abaixo compara as três. O ponto de partida é este: o app Business foi feito para conversa humana, e a API oficial é o que a Meta oferece para automação. O número conectado por QR code a uma ferramenta de terceiros fica no meio: funciona, mas não é o caminho que a Meta desenhou para isso.

App WhatsApp BusinessNúmero por QR code (sessão web)API oficial (Cloud API)
Para quem serveAtendimento manual, carteira pequenaQuem quer automatizar sem processo na Meta e aceita o risco do númeroCarteira grande e recorrente, quem precisa de canal reconhecido
Como conectaInstala o app no celular com o número da empresaLê um QR code, como no WhatsApp Web, e a ferramenta opera a sessãoConta da Meta, número registrado na plataforma, integração por parceiro ou por código
Automação em escalaSó respostas rápidas e mensagem de ausência, pouco mais que issoSim, pela ferramentaSim, dentro das regras de template e janela
Custo da MetaNenhumNenhumPor mensagem entregue, conforme categoria e país
Janela de 24h e templatesNão se aplicaNão se aplicaObrigatórios: fora da janela, só template aprovado
Risco para o númeroBaixo em uso manual; envio em massa pode gerar restriçãoReal: não é o caminho que a Meta oferece para automação, e volume e denúncias podem levar a restrição do número da empresaMenor, mas existe: qualidade baixa reduz o ritmo de envio e a política pode restringir a conta
Selo de empresa verificadaPossível, sujeito à análise da MetaEm geral nãoPode ser solicitado, sujeito à análise da Meta

Nenhuma das três é a resposta certa para todo mundo. O número por QR code tem a vantagem de começar no mesmo dia, sem template e sem tarifa por mensagem. A API oficial tem a vantagem de ser o canal que a Meta reconhece, ao custo de tempo de configuração e de uma conta por mensagem. Para ver o que o app Business faz sozinho antes de pensar em API, leia Mensagem automática no WhatsApp Business: o que dá para fazer.

Como conectar a API oficial, passo a passo

A sequência abaixo vale para o acesso direto à Cloud API. Se você contratar por um parceiro, boa parte dos passos 1 a 4 é feita com a ajuda dele, mas as contas continuam sendo da sua empresa, e os nomes das telas mudam com frequência. Confira sempre a documentação da Meta.

1Portfólio empresarial da MetaA plataforma exige um portfólio empresarial (o antigo Business Manager). Use o da empresa, com um administrador que seja pessoa de confiança e não saia da empresa, porque perder esse acesso trava tudo.
2Conta do WhatsApp e conta de mensagensNa documentação, a conta do WhatsApp gerencia os números e o nome de exibição, e a conta de mensagens gerencia templates, cobrança e formas de pagamento. Um aplicativo de desenvolvedor associado ao portfólio gera os tokens de acesso.
3Número de telefone da empresaRegistre o número que vai enviar e receber. Se ele já roda no app WhatsApp Business, pergunte ao parceiro se o seu caso cabe na chamada coexistência, que permite manter app e API no mesmo número, com limitações (veja mais abaixo).
4Verificação da empresaA Meta lista a verificação do negócio como um dos caminhos para sair do limite inicial de 250 contatos por 24 horas e subir para 2.000. A lista de documentos aceitos depende do país e é definida pela Meta; confira a do Brasil na hora, em vez de confiar em guia antigo.
5Forma de pagamentoA cobrança da Meta é feita na conta de mensagens. Pergunte em que moeda a conta é faturada e quem emite a fatura. Se o parceiro revende, a fatura chega dele.
6Templates e envio de testeCadastre os templates, espere a análise (até 24 horas, segundo a Meta) e teste com seu próprio número antes de tocar na carteira.
7Integração com quem decide a mensagemA API só entrega. Alguém precisa escolher quem recebe, quando e o que se oferece: sua ferramenta de cobrança, seu sistema ou uma pessoa.

Sobre a coexistência, o que a documentação da Meta diz: o negócio mantém o app e a API no mesmo número, o histórico é sincronizado, mas há limitações (grupos não sincronizam, listas de transmissão ficam só para leitura, aparelhos vinculados são desconectados e o envio pela API tem vazão fixa) e o recurso só é oferecido por parceiro da Meta. A documentação não traz a lista de países atendidos: pergunte ao parceiro se vale para o seu caso.

Direto na Meta ou por um parceiro

Dá para usar a Cloud API direto, falando com a Meta por código (Graph API e webhooks). Quase ninguém que cobra faz isso: exige desenvolvedor, manter integração e tratar status de mensagem. O caminho comum é um parceiro (a Meta chama de Solution Partner ou Tech Provider; no mercado, BSP): ele cuida do onboarding, da integração e muitas vezes da fatura. A verificação feita por parceiro também conta como um dos caminhos de escala de limite, segundo a Meta.

  • Quanto ele cobra por cima da tarifa da Meta, e como separa uma da outra na fatura.
  • Se a conta de mensagens fica no seu portfólio (você leva a conta se sair) ou no dele.
  • Se ele tem experiência com cobrança e já passou template de cobrança pela aprovação.
  • Quem responde quando o número é restrito ou um template é pausado.
  • Se há mensalidade mínima, taxa por número e fidelidade.

Templates de cobrança: categoria e aprovação

Fora da janela de 24 horas, só sai template aprovado. A Meta usa três categorias: marketing (promocional), utilidade (transacional ou informativa) e autenticação (verificação de identidade). A categoria define a tarifa, e a Meta pode recategorizar um template já aprovado: o de utilidade que a Meta entende ser marketing passa a ser tratado como marketing, e a tarifa muda junto.

Em qual categoria cai a cobrança? Pela orientação da Meta, utilidade precisa ser não promocional e específica para a pessoa. A documentação traz como exemplo de utilidade um lembrete de pagamento mensal, e como exemplo de marketing um lembrete que empurra renovação com desconto. Aviso de parcela em atraso não aparece nominalmente: a decisão depende do conteúdo, e conteúdo misto é tratado como marketing. Na prática: o template que informa a pendência tende a ser tratado como utilidade; o que oferece desconto ou condição especial tende a ser marketing. Quem decide é a Meta, caso a caso.

Exemplo de estrutura (ilustrativo, a Meta decide a categoria): “Olá, {{1}}. Aqui é o assistente virtual da {{2}}. A parcela {{3}}, de R$ {{4}}, venceu em {{5}} e consta em aberto. Se já pagou, desconsidere. Para falar sobre o pagamento, responda esta mensagem. Para não receber mais contato, responda SAIR.” Repare no que não está lá: valor com desconto, prazo ameaçador, menção a protesto ou a negativação. O desconto fica para a conversa, dentro da janela que a resposta abre.

Sobre a aprovação: a Meta diz que a decisão pode levar até 24 horas e notifica por e-mail e pelo painel. As causas de rejeição que a documentação lista incluem erro de formatação das variáveis, texto duplicado de outro template e conteúdo que viole a política, como o abusivo ou ameaçador. Template rejeitado pode ser editado e reenviado ou contestado, com análise em até 24 horas. Depois de aprovado, o template recebe uma nota de qualidade (verde, amarela ou vermelha) conforme o retorno dos destinatários: template que recebe retorno negativo ou pouca leitura pode ser pausado ou desativado.

Veja como a régua funcionaria com a sua carteira

Entrar na lista de espera

A janela de 24 horas na régua de cobrança

A janela de atendimento é um relógio de 24 horas que abre quando a pessoa manda mensagem para você e reinicia a cada nova mensagem dela. Dentro dela, você escreve texto livre; fora dela, só template. Para cobrança, isso desenha a régua inteira:

  • Primeiro contato: sempre um template, porque a pessoa ainda não falou com você.
  • Resposta dela: abre a janela. É aqui que a negociação acontece, em texto livre: valor, parcelas, forma de pagamento.
  • Silêncio: se a pessoa não responde, a janela nem abre. A segunda tentativa é outro template.
  • Conversa interrompida: passaram 24 horas desde a última mensagem dela, volta o template.

Por isso o primeiro template tem que ser claro e leve: ele não negocia, só abre a porta. E é a razão de a persistência custar mais na API oficial do que no QR code, porque cada tentativa fora da janela é um template e cada template entregue é uma mensagem cobrada. Para a lógica de quantas vezes e em que horário insistir, veja Como cobrar pelo WhatsApp, passo a passo.

Como a Meta cobra, sem tabela de preço

Desde 1º de julho de 2025, a Meta cobra por mensagem entregue, e não mais por conversa de 24 horas. Cada mensagem cai em uma categoria e gera no máximo uma cobrança. O valor depende da categoria e do código do país do destinatário. Mensagem que a pessoa manda para você não é cobrada, e mensagem que não foi entregue também não. A tabela de tarifas é da Meta, varia por país e categoria e muda: pelo que a documentação diz, a Meta só atualiza preços no primeiro dia de cada trimestre, com aviso prévio. Por isso este texto não traz valor. Confira a tabela oficial no dia da decisão.

  • Template de utilidade enviado dentro de uma janela aberta era gratuito até 30 de setembro de 2026. Desde 1º de outubro de 2026, é cobrado.
  • Mensagem de serviço, a resposta em texto livre dentro da janela, passou a ser cobrada a partir da 1.001ª do mês, com franquia de 1.000 por número. A franquia não acumula para o mês seguinte.

Se o fornecedor revende a Meta, a conta chega com ou sem acréscimo, conforme o contrato dele. Para ver como a tarifa entra numa conta completa de cobrança, com mensalidade e percentual, leia Quanto custa cobrança automática pelo WhatsApp.

Limites de envio e qualidade

Um portfólio novo começa com limite de 250 contatos únicos por 24 horas, contados quando você inicia conversa fora da janela. Completando um caminho de escala (verificar a empresa, ter o parceiro verificado, ou entregar 2.000 mensagens em 30 dias com templates de boa qualidade), o limite sobe para 2.000. A partir daí a Meta escala automaticamente para 10.000, 100.000 e ilimitado, desde que haja volume e mensagens de boa qualidade. O limite vale para o portfólio, somando todos os números.

Para quem cobra, isso significa começar devagar. Subir uma carteira de 1.500 devedores no primeiro dia, com limite de 250, vira fila de uma semana. E qualidade importa: a Meta diz que bloqueios e denúncias derrubam a nota, e que os sistemas dela podem limitar a quantidade de mensagens que uma empresa envia com base no retorno dos usuários. Mensagem de cobrança mal escrita ou para número errado alimenta exatamente esse indicador.

A política da Meta e a cobrança de dívidas

Este é o ponto que a maioria dos guias de fornecedor pula. A Política de Mensagens do WhatsApp Business, na seção de organizações e usos proibidos, lista entre os serviços que a Meta proíbe comprar, vender ou promover, a critério dela: “payday loans, paycheck advances, peer-to-peer lending, debt collection, and bail bonds”, e diz que a proibição vale independentemente de licenças e registros locais.

O texto diz apenas “debt collection”. Não distingue empresa de cobrança de terceiros de uma empresa que lembra o próprio cliente de uma parcela em aberto, e a política não diz como a Meta aplica esse item na prática no Brasil. A leitura mais natural é que ele visa quem oferece cobrança como serviço, mas é leitura, não regra escrita. Antes de investir em conexão, pergunte por escrito ao parceiro e à Meta se o seu caso (cobrar os seus próprios clientes, pelo seu próprio número) está dentro da política, e peça que respondam sobre o tipo de template que você pretende usar. Quem promete que não há problema sem ter passado isso pela aprovação está vendendo certeza que a documentação não dá.

A política da Meta exige que a pessoa tenha dado o número e aceitado receber mensagens da empresa, e que pedidos de parada sejam respeitados; o método de consentimento é responsabilidade da empresa. Na lei, o CDC (arts. 42 e 71) veda cobrança com ameaça, constrangimento ou exposição, e a LGPD (arts. 7º e 10) pede base legal e finalidade para tratar o telefone e o dado da dívida. Isto é orientação geral, não parecer jurídico: para o seu caso, consulte um advogado. As regras estão desenvolvidas em Cobrança por WhatsApp é legal?.

Onde a Quitou entra hoje

A Quitou é uma ferramenta de cobrança: o credor sobe a carteira, e um agente de IA conversa no WhatsApp dentro das regras que ele autorizou (desconto máximo, parcelas, horário, palavras proibidas), se identifica como assistente virtual na primeira mensagem e para quando a pessoa pede. O dinheiro nunca passa pela Quitou: o Pix e o boleto continuam sendo seus. Hoje o canal que funciona é o número de WhatsApp da sua empresa conectado por QR code. A API oficial da Meta ainda não está liberada para clientes da Quitou. Isso tem o custo descrito na tabela: não é o caminho que a Meta oferece para automação, o número pode ser restringido, e o número é o seu. A vantagem é não ter tarifa de template nem janela de 24 horas. A decisão é sua, e ela pesa de forma diferente numa carteira de 200 contatos e numa de 20 mil.

Perguntas frequentes

A API oficial do WhatsApp é paga?

Usar a plataforma não tem mensalidade na Meta, mas ela cobra por mensagem entregue, desde 1º de julho de 2025, conforme a categoria e o país do destinatário. Se você contratar por um parceiro, ele pode cobrar mensalidade ou taxa por cima. A tabela de tarifas é da Meta e muda, então confira a oficial.

Preciso verificar a empresa para usar a API oficial?

A documentação não trata a verificação como obrigatória para começar, mas ela é um dos caminhos para sair do limite inicial de 250 contatos por 24 horas e subir para 2.000. A Meta define a lista de documentos aceitos por país, então confira a do Brasil no processo.

Posso usar o mesmo número do WhatsApp Business na API?

Existe a coexistência, que permite manter o app e a API no mesmo número, com limitações (grupos não sincronizam, listas de transmissão ficam só para leitura, aparelhos vinculados são desconectados) e só por parceiro da Meta. A documentação não lista os países atendidos, então pergunte ao parceiro se vale para você.

Quanto tempo leva para aprovar um template de cobrança?

Segundo a Meta, a decisão pode levar até 24 horas. Se for rejeitado, dá para editar e reenviar ou contestar, e a contestação também é analisada em até 24 horas. A categoria (utilidade ou marketing) é decidida pela Meta e pode ser alterada depois.

Aviso de dívida em atraso conta como mensagem de utilidade?

A Meta não cita o aviso de atraso nominalmente. A orientação diz que utilidade deve ser não promocional e específica para a pessoa, e que conteúdo misto, como aviso com oferta, é tratado como marketing. O template que só informa a pendência tende a ser utilidade, mas quem decide é a Meta.

Qual a diferença entre API oficial e a chamada API não oficial?

A oficial é a Cloud API da Meta, com conta, templates aprovados e cobrança por mensagem. A chamada não oficial normalmente é uma ferramenta que opera uma sessão de WhatsApp conectada por QR code: não tem tarifa por mensagem nem template, mas não é o caminho que a Meta oferece para automação, e o número da empresa pode ser restringido.

A Quitou já trabalha com a API oficial do WhatsApp?

Ainda não. Hoje a Quitou usa o número de WhatsApp da própria empresa, conectado por QR code, e deixa claro o risco desse caminho. A API oficial ainda não está liberada para clientes.

Qual caminho escolher

Carteira pequena e atendimento feito por gente: o app Business basta. Carteira média e recorrente, com tolerância ao risco e pressa: o número por QR code resolve hoje, sabendo que o número é seu e pode ser restringido. Carteira grande, necessidade de um canal que a Meta reconheça e disposição para passar por verificação, templates e custo por mensagem: a API oficial, depois de confirmar a questão da política de cobrança. Nos três casos o que fecha acordo é o mesmo: mensagem respeitosa, regra clara, parada na hora do pedido.

Teste a régua no simulador antes de mandar qualquer mensagem

Entrar na lista de espera

Veja a conta com a sua carteira

Os primeiros 30 dias não custam nada. Depois, R$ 149 por mês mais 5% do que os clientes pagarem depois do primeiro contato da Quitou, sem fidelidade.

Entrar na lista de espera