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
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 Business | Número por QR code (sessão web) | API oficial (Cloud API) | |
|---|---|---|---|
| Para quem serve | Atendimento manual, carteira pequena | Quem quer automatizar sem processo na Meta e aceita o risco do número | Carteira grande e recorrente, quem precisa de canal reconhecido |
| Como conecta | Instala o app no celular com o número da empresa | Lê um QR code, como no WhatsApp Web, e a ferramenta opera a sessão | Conta da Meta, número registrado na plataforma, integração por parceiro ou por código |
| Automação em escala | Só respostas rápidas e mensagem de ausência, pouco mais que isso | Sim, pela ferramenta | Sim, dentro das regras de template e janela |
| Custo da Meta | Nenhum | Nenhum | Por mensagem entregue, conforme categoria e país |
| Janela de 24h e templates | Não se aplica | Não se aplica | Obrigatórios: fora da janela, só template aprovado |
| Risco para o número | Baixo em uso manual; envio em massa pode gerar restrição | Real: 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 empresa | Menor, mas existe: qualidade baixa reduz o ritmo de envio e a política pode restringir a conta |
| Selo de empresa verificada | Possível, sujeito à análise da Meta | Em geral não | Pode 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.
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.
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 esperaA 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á.
Base legal e consentimento
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 esperaVeja 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