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.
Neste artigo
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 Code | API oficial da Meta | |
|---|---|---|
| Como conecta | Leitura de código, como o WhatsApp Web | Registro do número na plataforma da Meta |
| Tempo para entrar no ar | Minutos | De alguns dias a algumas semanas |
| Celular | Número continua no aplicativo | Número sai do aplicativo comum |
| Custo por mensagem | Não há cobrança da Meta | Há cobrança, por categoria de mensagem |
| Mensagem iniciada pela empresa | Texto livre | Só com modelo aprovado previamente |
| Risco de bloqueio | Existe, se houver uso abusivo | Baixo, por ser caminho homologado |
| Selo de verificação | Não | Possí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:
- Mensalidade da ferramenta que dá a interface de atendimento, funil e relatórios.
- Cobrança da Meta pelas mensagens das categorias tarifadas.
- Eventual taxa do provedor que intermedia o acesso, quando houver — alguns cobram margem sobre o preço da Meta, outros não. Pergunte isso explicitamente antes de assinar.
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:
- 3.000 conversas de atendimento iniciadas pelo cliente: no modelo atual, essa categoria costuma não ser tarifada — confirme na tabela vigente.
- 1.200 mensagens de utilidade × R$ 0,08 (hipotético) = R$ 96
- 800 mensagens de marketing × R$ 0,32 (hipotético) = R$ 256
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:
- Você envia muita mensagem iniciada pela empresa — cobrança, confirmação, campanha recorrente. É o cenário de maior risco no caminho não oficial.
- Uma interrupção do número seria grave. Se meio dia sem WhatsApp para a operação inteira, o caminho homologado passa a valer o custo.
- Você precisa do selo ou de credibilidade formal diante de clientes maiores.
- O volume de conversas simultâneas é alto e a estabilidade virou requisito.
- Existe integração com ERP, e-commerce ou sistema de pedidos que precisa de conexão estável.
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
- 1. Conta comercial na Meta. Criar ou organizar o Business Manager da empresa, com dados que batam com o CNPJ.
- 2. Verificação da empresa. Envio de documentos. É a etapa que mais atrasa, geralmente por divergência entre razão social, endereço e o que está no site.
- 3. Escolha do provedor e da ferramenta. Quem intermedia o acesso e onde o time vai atender.
- 4. Registro do número. Se o número já é usado no aplicativo comum, ele precisa ser desvinculado — e é aqui que mora o ponto sensível: o histórico de conversas do aplicativo não migra. Exporte o que for crítico antes.
- 5. Criação dos modelos. Escreva e submeta os modelos que a operação usa no dia a dia antes de virar a chave, não depois.
- 6. Teste e virada. Rode em paralelo com um número de teste, treine a equipe na nova interface e escolha um dia de menor movimento para virar.
Erros que fazem a migração dar errado
- Migrar sem ferramenta de atendimento definida. O número sai do celular e ninguém tem onde atender direito. É o erro mais caro e o mais frequente.
- Não avisar a equipe. Atendente que procurava a conversa no telefone fica sem chão no primeiro dia.
- Deixar os modelos para depois. Sem modelo aprovado, a empresa fica impedida de iniciar conversa justamente na primeira semana.
- Ignorar a janela de 24 horas ao montar o processo. Equipe que demora um dia para responder passa a precisar de modelo para tudo — e o custo sobe sem motivo.
- Assumir que o selo verde vem junto. Ele é concedido por critério da Meta e depende de presença e relevância da marca, não da migração.
- Não perguntar sobre a margem do provedor. Duas propostas com a mesma mensalidade podem ter custo de mensagem bem diferente.
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.