WhatsApp API oficial x conexão não oficial (QR Code): qual usar
Custo, risco, número e volume — o que muda entre os dois modos e quando cada um faz sentido.
Falar com a Nuvem Lab no WhatsAppAtualizado em 2026-09-01.
A API oficial do WhatsApp (WhatsApp Business Platform, da Meta) usa um número homologado, é estável e cobra por conversa iniciada fora da janela de 24 horas. A conexão não oficial via QR Code funciona como o WhatsApp Web, não tem custo por mensagem e permite usar um número existente, mas tem risco de bloqueio pela Meta. O WA Atendimentos suporta as duas.
As duas formas de conectar um sistema ao WhatsApp
Todo sistema de atendimento precisa de uma "ponte" com o WhatsApp. Existem dois caminhos:
- API oficial (WhatsApp Business Platform / Cloud API): a Meta fornece acesso oficial ao número, registrado no CNPJ da empresa. É o modelo homologado.
- Conexão não oficial (via QR Code): o sistema se conecta lendo um QR Code, como o WhatsApp Web faz. Não é um produto oficial da Meta para automação.
Comparação lado a lado
| Critério | API oficial da Meta | Conexão não oficial (QR Code) |
|---|---|---|
| Homologação | Oficial, suportada pela Meta | Não oficial |
| Estabilidade | Alta | Média — pode cair e exigir reconexão |
| Risco de bloqueio | Muito baixo | Existe |
| Custo | Por conversa fora da janela de 24h (template pago); dentro da janela, sem custo | Sem custo por mensagem |
| Número | Dedicado à API; não usar no app comum | Pode ser um número que a empresa já usa |
| Tempo para começar | Dias (cadastro, verificação do negócio) | Rápido (ler o QR Code) |
| Envio ativo (primeiro contato) | Só com template aprovado | Livre, com bom senso para não ser bloqueado |
| Volume recomendado | Médio e alto | Baixo e médio |
| Recursos oficiais | Templates, catálogos, botões, métricas da Meta | Recursos básicos de mensagem |
Quando usar a API oficial
- Operação com alto volume e necessidade de previsibilidade.
- Necessidade de disparar mensagens ativas (notificações, avisos) em escala, com templates.
- Empresa que não pode correr risco de ter o número bloqueado.
- Já tem CNPJ e pode dedicar um número à API.
Quando a conexão via QR Code faz sentido
- Começar rápido e validar o processo de atendimento.
- Volume menor, atendimento majoritariamente reativo (o cliente inicia).
- Aproveitar um número que os clientes já conhecem.
- Custo por mensagem é um fator decisivo no momento.
A janela de 24 horas (vale para a API oficial)
Na API oficial, quando o cliente manda uma mensagem, abre-se uma janela de 24 horas em que a empresa pode responder livremente, sem custo por conversa. Passadas as 24 horas sem nova mensagem do cliente, para reabrir a conversa a empresa precisa enviar um template aprovado, e essa conversa é tarifada. Entender isso é essencial para calcular custo.
Como o WA Atendimentos lida com os dois modos
O WA Atendimentos foi feito para operar nos dois modos. É comum começar pela conexão via QR Code para validar o fluxo de atendimento e migrar para a API oficial quando o volume cresce — sem trocar de sistema. A Nuvem Lab ajuda a escolher e a fazer a transição.
Tirar essa dúvida com a Nuvem Lab no WhatsAppPerguntas frequentes
A conexão via QR Code é proibida?
Não é um produto oficial da Meta para automação e viola os termos de uso para automação; por isso existe risco de bloqueio. A decisão é da empresa, ciente do risco.
Quanto custa a API oficial?
A Meta cobra por conversa iniciada fora da janela de 24 horas, com preço que varia por categoria de template e país. Dentro da janela de 24h, respostas não têm custo de conversa.
Posso migrar de um modo para o outro depois?
Sim. Com o WA Atendimentos a migração não exige trocar de sistema; muda a forma de conexão.
Na API oficial eu perco meu número atual?
O número da API é dedicado. Dá para migrar um número existente para a API, mas ele deixa de funcionar no app comum.
Qual modo vocês recomendam?
Depende de volume, necessidade de envio ativo e tolerância a risco. A Nuvem Lab avalia o caso antes de recomendar.