Infraestrutura

API oficial do WhatsApp Business: como funciona, custos e quando migrar

Por VeyloCRM · · 10 min de leitura

Migrar para a API oficial da Meta é a decisão técnica que mais confunde empresário — e a que mais é apresentada de forma enviesada por quem vende só um dos caminhos. A escolha muda custo, risco e a forma como a sua equipe trabalha todo dia. Vale entender antes o que exatamente se ganha e o que se perde.

O que é a API oficial (e o que ela não é)

A API oficial do WhatsApp Business é o caminho homologado pela Meta para uma empresa operar um número dentro de sistemas próprios. Ela não é um aplicativo: não se instala, não se abre, não tem tela. É uma porta de entrada que a sua ferramenta de atendimento usa para enviar e receber mensagens em nome da empresa.

Daí vem a consequência que mais surpreende quem migra: o número deixa de funcionar no aplicativo comum do celular. Não dá para atender pelo WhatsApp do telefone "quando for mais fácil". Todo o atendimento passa a acontecer dentro do sistema — e é por isso que migrar sem ter uma ferramenta boa é trocar um problema por outro.

Em troca, a empresa ganha três coisas que o caminho não oficial não oferece: legitimidade perante a Meta, capacidade de operar volume alto sem sustos, e acesso a recursos como catálogo, botões, listas e o selo de conta comercial verificada — este último concedido por critério da própria Meta, não garantido pela migração.

QR Code ou API: a comparação honesta

Conexão por QR CodeAPI oficial da Meta
Como conectaLeitura de código, como o WhatsApp WebRegistro do número na plataforma da Meta
Tempo para entrar no arMinutosDe alguns dias a algumas semanas
CelularNúmero continua no aplicativoNúmero sai do aplicativo comum
Custo por mensagemNão há cobrança da MetaHá cobrança, por categoria de mensagem
Mensagem iniciada pela empresaTexto livreSó com modelo aprovado previamente
Risco de bloqueioExiste, se houver uso abusivoBaixo, por ser caminho homologado
Selo de verificaçãoNãoPossível, a critério da Meta

Nenhum dos dois é "o certo". São escolhas para momentos diferentes, e a maioria das empresas começa no QR Code e migra quando o volume justifica — o que é discutido em detalhe no artigo sobre como escolher um CRM de WhatsApp.

Como funciona por dentro

Modelos de mensagem

Toda mensagem que a empresa inicia precisa usar um modelo aprovado antes pela Meta. O modelo tem texto fixo e campos variáveis — nome, número do pedido, data. Aprovar leva de minutos a alguns dias, e reprovações acontecem por promessa exagerada, texto ambíguo ou categoria errada.

A janela de 24 horas

Quando o cliente escreve para a empresa, abre-se uma janela de 24 horas em que a conversa flui livremente, com texto livre, sem modelo. Passado esse prazo, só é possível retomar com um modelo aprovado. Essa regra molda a operação inteira: responder rápido não é só boa prática comercial, é o que mantém a conversa dentro da janela.

Categorias e cobrança

As mensagens se dividem em categorias — marketing, utilidade (confirmações, avisos de pedido), autenticação (códigos) e atendimento (as iniciadas pelo cliente). Cada categoria tem tratamento e preço próprios, e o modelo de cobrança da Meta já mudou mais de uma vez nos últimos anos. Por isso, não decida orçamento com base em número que você leu em algum artigo — inclusive este: consulte a tabela vigente da Meta para o Brasil antes de fechar a conta.

Limites de envio

Números novos na API começam com um limite diário de contatos iniciados, que cresce conforme o histórico e a qualidade da operação. Qualidade, aqui, é medida por como as pessoas reagem: bloqueios e denúncias derrubam o nível; conversas com resposta o sustentam.

Montando a conta de custo

O custo total tem três partes, e ignorar qualquer uma delas leva a surpresa na fatura:

Exemplo de estimativa — os valores unitários abaixo são hipotéticos, apenas para mostrar como a conta se monta. Empresa com 3.000 conversas mensais iniciadas por clientes, 1.200 confirmações de agendamento e 800 mensagens de campanha:

Custo de mensagens no exemplo: R$ 352 por mês, somados à mensalidade da ferramenta. Note o que a conta revela: o peso está nas mensagens de marketing. Uma empresa que faz muita campanha ativa sente a diferença; uma que basicamente responde quem procura, quase não sente. Antes de migrar, classifique o seu volume por categoria — é isso que determina se a API sai barata ou cara no seu caso.

Erro de orçamento mais comum: comparar a mensalidade da ferramenta com API contra a mensalidade da ferramenta com QR Code e concluir que "a API é mais cara". O custo relevante é o total, incluindo mensagens — e, do outro lado da conta, o custo de ter o número principal bloqueado num dia de pico.

Quando migrar faz sentido

Não é uma questão de tamanho de empresa, e sim de perfil de uso. Migre quando pelo menos dois destes forem verdade:

E o inverso também vale: se a sua empresa basicamente responde a quem chega, com dois ou três atendentes e pouca mensagem ativa, o QR Code resolve — e migrar antes da hora só adiciona custo e rigidez.

Como é a migração, passo a passo

Erros que fazem a migração dar errado

A decisão em uma frase

Se a sua empresa responde mais do que procura, e o número que você usa há anos funciona bem no dia a dia, fique no QR Code e invista o esforço em organizar o atendimento. Se a sua empresa depende de iniciar conversas em volume — confirmar, cobrar, avisar, promover —, a API oficial deixa de ser luxo e passa a ser proteção: você troca um risco difuso de bloqueio por um custo previsível por mensagem.

O melhor cenário, para quem está crescendo, é escolher uma ferramenta que suporte os dois caminhos. Assim a decisão deixa de ser definitiva: começa-se pelo mais simples e migra-se quando o volume pedir, sem trocar de fornecedor, sem refazer processo e sem perder a base de conversas construída até ali.

Perguntas frequentes

O que é a API oficial do WhatsApp Business?

É o caminho homologado pela Meta para uma empresa operar um número de WhatsApp dentro de sistemas próprios. Não é um aplicativo: não tem tela nem instalação, e funciona como uma porta de entrada usada pela ferramenta de atendimento da empresa. Por causa disso, o número registrado na API deixa de funcionar no aplicativo comum do celular — todo o atendimento passa a acontecer no sistema.

Quanto custa usar a API oficial do WhatsApp?

O custo tem três partes: a mensalidade da ferramenta de atendimento, a cobrança da Meta pelas mensagens tarifadas e, em alguns casos, uma margem do provedor que intermedia o acesso. As mensagens são divididas em categorias — marketing, utilidade, autenticação e atendimento — com preços diferentes. Como o modelo de cobrança da Meta já mudou mais de uma vez, consulte a tabela vigente para o Brasil antes de fechar orçamento, e pergunte ao fornecedor se ele acrescenta margem ao preço da Meta.

Preciso trocar de número para usar a API oficial?

Não. O número pode ser mantido, mas precisa ser desvinculado do aplicativo comum, onde deixará de funcionar. O ponto de atenção é o histórico: as conversas que estão no aplicativo não migram para a API, então exporte o que for crítico antes da virada. Quem não pode ficar sem o número no celular deve considerar registrar um segundo número na API.

O que é a janela de 24 horas?

É o período que se abre quando o cliente envia uma mensagem para a empresa. Dentro dessas 24 horas, a conversa flui com texto livre. Depois desse prazo, a empresa só consegue retomar o contato usando um modelo de mensagem aprovado previamente pela Meta. Na prática, isso torna a velocidade de resposta uma questão de custo, e não apenas de qualidade de atendimento.

Migrar para a API garante o selo verde de verificação?

Não. A verificação da conta comercial é concedida a critério da Meta e leva em conta a presença e a relevância da marca, não apenas o uso da API. A migração torna a empresa elegível, mas não assegura a concessão — vale tratar o selo como consequência possível, nunca como motivo principal para migrar.

Os dois caminhos, na mesma ferramenta

O VeyloCRM conecta por QR Code ou pela API oficial da Meta. Comece pelo mais simples e migre quando o volume pedir — sem trocar de fornecedor nem refazer processo.