waplyGuia
API não oficial vs Cloud API do WhatsApp no Kommo: riscos e quando migrar
·
Uma conexão não oficial usa a sessão do WhatsApp de um celular vinculada por QR code; a Cloud API é a WhatsApp Business Platform da Meta para empresas. A via não oficial pode servir para começar, mas não tem respaldo da Meta e, segundo os termos do WhatsApp, o uso automatizado ou não autorizado pode levar à suspensão da conta. A Cloud API funciona com modelos aprovados, limites de mensagens publicados e chamadas por API, com as cobranças que a Meta publica na sua página de preços.
Este guia é para equipes que hoje conectam o WhatsApp ao Kommo escaneando um QR code ou com um conector que replica o WhatsApp Web, e querem entender os riscos que assumem e quando vale passar para a API oficial. Ele não compara produtos nem detalha a migração passo a passo: explica o porquê e deixa os links para esses guias.
Teste grátis de 3 dias com todo o Voice AI.
O que é uma API não oficial e o que é a Cloud API do WhatsApp
Conexão não oficial: um serviço vincula seu número como mais um dispositivo do WhatsApp, normalmente escaneando um QR code, e automatiza essa sessão (estilo WhatsApp Web). A Meta não oferece essa via como produto para empresas, então o funcionamento depende do conector e do celular.
Cloud API: é a WhatsApp Business Platform da Meta. O número é registrado em uma conta do WhatsApp Business (WABA) dentro do seu portfólio empresarial, e as mensagens passam pela infraestrutura da Meta, com regras e preços publicados. O Kommo e provedores como a Waply se conectam a ela.
Comparação: API não oficial vs Cloud API
Diferenças entre uma conexão não oficial por QR e a Cloud API da Meta (revisado em 14 de outubro de 2026)
| Critério | Conexão não oficial (QR ou sessão web) | Cloud API (WhatsApp Business Platform) |
|---|---|---|
| Respaldo da Meta | Não é um produto da Meta para empresas. | Produto oficial da Meta, com documentação e políticas publicadas. |
| Risco de bloqueio do número | Segundo os termos do WhatsApp, o uso automatizado ou não autorizado pode levar à suspensão da conta. | A Meta pode limitar ou suspender contas que descumprem suas políticas; as regras são publicadas. |
| Modelos e mensagens iniciadas pela empresa | Não há modelos aprovados pela Meta; envios em massa podem ser considerados uso não permitido. | Fora da janela de 24 horas, a conversa começa com modelos aprovados pela Meta. |
| Chamadas | Não fazem parte de uma API da Meta; dependem de cada conector. | Calling API da Meta, com requisitos próprios; números em coexistência não podem fazer chamadas. |
| Limites e qualidade | Sem limites nem classificação de qualidade publicados pela Meta. | Limites de mensagens e classificação de qualidade visíveis no WhatsApp Manager. |
| Verificação da empresa | Não se aplica. | A Meta pode pedir a verificação da empresa, por exemplo para aumentar limites. |
| Estabilidade da sessão | Depende do celular vinculado; a sessão pode fechar ou desconectar. | Conexão entre servidores da Meta e do provedor, sem depender de um celular ligado. |
| Custo | Sem cobranças da Meta; você paga a tarifa do conector. | Cobranças da Meta por modelo conforme sua tabela, mais a tarifa do provedor. |
Riscos de usar uma API não oficial do WhatsApp
- Suspensão do número: os Termos de Serviço do WhatsApp proíbem acessar o serviço por meios automatizados ou não autorizados e enviar mensagens em massa ou automáticas; se forem descumpridos, o WhatsApp pode desativar ou suspender a conta.
- Perda de acesso ao WhatsApp Business: segundo a Política de Mensagens do WhatsApp Business, a Meta pode limitar ou remover o acesso de quem usa um serviço que utiliza o WhatsApp de forma não autorizada, por exemplo para enviar mensagens em escala.
- Sessão frágil: se o celular ficar sem conexão, a sessão vinculada for encerrada ou o app mudar, o conector pode parar de receber ou enviar mensagens até você escanear o QR de novo.
- Sem ferramentas oficiais: você não tem modelos aprovados, classificação de qualidade nem suporte da Meta para revisar um bloqueio.
Esses riscos não significam que todo número será bloqueado: dependem do uso, do volume e de como a Meta aplica seus termos. O que é claro é que a via não oficial fica fora do que a Meta oferece para empresas.
Quando o não oficial pode bastar e quando a API oficial é melhor
Uma conexão não oficial pode bastar se você tem poucas conversas, todas iniciadas pelos clientes, aceita que o número pode desconectar ou ser suspenso e não precisa de modelos nem de chamadas por API.
A Cloud API é a melhor escolha se o WhatsApp é um canal de vendas ou suporte que não pode cair, se você escreve primeiro aos clientes com lembretes ou campanhas, se várias pessoas atendem pelo Kommo, se você quer chamadas de WhatsApp ou agentes de IA, ou se precisa de regras e custos que possa consultar na documentação da Meta.
Como passar de uma API não oficial para a Cloud API
- Decida qual número usar: um novo, ou o que você já usa no app WhatsApp Business, mantendo o app em coexistência.
- Se você usava um conector não oficial, confirme com esse provedor como desconectá-lo antes de registrar o número na API oficial.
- Conecte o número à Cloud API pelo Kommo com um provedor oficial e crie seus modelos.
Se você quer continuar usando o app WhatsApp Business no celular, confira os requisitos de coexistência antes de começar. O passo a passo completo está nestes guias:
Onde a Waply entra
- Usa a API oficial do WhatsApp: a Meta fatura suas cobranças diretamente, sem acréscimo da Waply, na moeda da sua WABA.
- Chamadas de WhatsApp gravadas, agentes de IA com bases de conhecimento e a opção de usar sua própria API key (BYOK).
- Planos Basic USD 18, AI 24/7 USD 39 e Voice AI USD 89, com teste grátis de 3 dias que inclui o Voice AI.
- Chamadas: números em coexistência não podem fazer chamadas, e a documentação da Meta exige um limite diário de mensagens de pelo menos 2.000 destinatários únicos para usar a Calling API.
Perguntas frequentes
Meu número pode ser bloqueado por usar uma API não oficial do WhatsApp?
Pode acontecer. Os Termos de Serviço do WhatsApp proíbem o acesso por meios automatizados ou não autorizados e as mensagens em massa ou automáticas, e o WhatsApp pode suspender contas que os descumprem. Não existe um número público de quantos números são bloqueados.
A Cloud API do WhatsApp cobra por cada mensagem?
A Meta cobra pelos modelos conforme sua tabela por país e categoria. As respostas dentro da janela de atendimento de 24 horas seguem as regras de preço que a Meta publica. A isso se soma a tarifa do provedor que conecta o Kommo.
Posso continuar usando o app WhatsApp Business se passar para a Cloud API?
Sim, com a coexistência da Meta, se o seu número cumprir os requisitos. Em coexistência você pode enviar e receber mensagens pela API, mas não fazer chamadas.
Requisitos para conectar um número do app WhatsApp Business (coexistência)
Posso fazer chamadas de WhatsApp no Kommo com a Cloud API?
Sim, com a Calling API da Meta e um provedor que a integre. Segundo a documentação da Meta, o número precisa estar em uso com a Cloud API, não com o app, e a empresa precisa de um limite diário de mensagens de pelo menos 2.000 destinatários únicos.
Quando uma conexão não oficial é suficiente?
Quando o volume é baixo, os clientes escrevem primeiro e uma desconexão ou suspensão do número não para o seu negócio. Se você depende do WhatsApp para vender ou atender, a API oficial é a opção mais estável.
Passe para a API oficial do WhatsApp no Kommo
Instale a Waply no Kommo e use o teste grátis de 3 dias com todo o Voice AI: conecte seu número à Cloud API, crie seus modelos e teste chamadas e agentes de IA.
Teste grátis de 3 dias com todo o Voice AI.