API oficial do WhatsApp sem QR code: como sair da API não oficial sem trocar de número

A API oficial do WhatsApp não usa QR code. O número é conectado à plataforma da Meta por um provedor oficial, em poucos cliques, e você pode continuar usando o mesmo número no aplicativo WhatsApp Business do celular. Abaixo, por que vale sair da conexão por QR code e como fazer isso sem parar o seu sistema.

Por que a conexão por QR code é arriscada

As APIs não oficiais funcionam simulando o WhatsApp Web: você lê um QR code e o seu sistema passa a controlar a sessão do aplicativo. Funciona, mas com problemas conhecidos:

• Risco de bloqueio do número. Os termos do WhatsApp não permitem automatizar o aplicativo por meios não autorizados. Quem envia em volume por QR code corre o risco de perder o número, e com ele o histórico e os contatos.
• Sessão que cai. Se o celular perde a conexão, atualiza o app ou desconecta os aparelhos, a sessão cai e as mensagens param até alguém ler o QR code de novo.
• Sem garantia. Uma mudança no WhatsApp pode quebrar a integração de um dia para o outro, sem aviso.

O que muda com a API oficial

• Conexão estável, direto na plataforma da Meta, sem depender de uma sessão do celular aberta.
• Avisos por webhook quando o cliente escreve e quando a mensagem é entregue, lida ou não chega (com o motivo).
• Regras claras: texto livre para quem escreveu nas últimas 24 horas; fora disso, templates (modelos de mensagem) aprovados pela Meta.
• Sem risco de bloqueio por usar automação: a automação é o uso previsto da API.

Dá para manter o mesmo número?

Sim. Com a coexistência, um recurso oficial da Meta, o número continua no app WhatsApp Business do celular e, ao mesmo tempo, funciona pela API no seu sistema. Na hora de conectar, dá para trazer as conversas dos últimos 6 meses.

Algumas funções do app mudam com o número nos dois lugares: mensagens temporárias e de visualização única ficam desligadas, listas de transmissão viram só leitura, e grupos e ligações continuam só no celular. Também é preciso abrir o WhatsApp Business no celular pelo menos uma vez a cada duas semanas para manter a conexão ativa.

Quanto custa a API oficial

São duas partes:

• A Meta cobra por mensagem entregue, direto no cartão cadastrado na conta da empresa. O valor depende da categoria e do país. No Brasil, a tabela da Meta indica US$ 0,0625 por mensagem de marketing e US$ 0,0068 por mensagem de utilidade ou de atendimento. Confira sempre a tabela oficial da Meta.
• O provedor oficial cobra pela conexão. No OneSendz Developers, a partir de R$ 59 por conexão por mês, sem taxa por mensagem da nossa parte.

Como migrar em 5 passos

1. Monte tudo no modo teste

   Com uma chave de teste, o seu código chama a API de verdade, mas nenhum envio sai: tudo é simulado num ambiente separado. Veja Começar em 5 minutos.

2. Separe o que é resposta do que é aviso

   Resposta a quem acabou de escrever vai como texto (enviar_mensagem). Aviso que você dispara (pedido enviado, lembrete, cobrança) vai como template aprovado (enviar_template).

3. Troque a sessão do QR code por webhooks

   Em vez de ler mensagens de uma sessão aberta, receba mensagem.recebida no seu servidor, com assinatura para conferir. Veja webhooks.

4. Conecte o número

   Pelo fluxo oficial da Meta, escolhendo usar o mesmo número do celular (coexistência).

5. Vá para produção

   Troque a chave de teste pela de produção. Nada mais muda no código.

Perguntas frequentes

Leia também