O WhatsApp Cloud API é a forma oficial de conectar o WhatsApp ao Kommo: ele não viola as regras da Meta, permite disparos legais e roda na infraestrutura da Meta, sem servidor próprio. A conexão leva de 10 a 20 minutos, se o número e a conta Meta estiverem prontos com antecedência. Abaixo: o que preparar e o processo em si, passo a passo.
Se você ainda não decidiu entre o Cloud API oficial e um número "cinza", leia primeiro a comparação dos métodos no hub sobre conectar o WhatsApp. Aqui tratamos só do caminho oficial.
- O Cloud API se conecta direto na interface do Kommo, pelo login na conta do Facebook (Meta).
- Prepare com antecedência: um plano pago ou trial ativo do Kommo, uma conta pessoal do Facebook, o portfólio do Meta Business e um número de telefone separado.
- O número precisa estar livre do WhatsApp, seja novo, seja desvinculado do aplicativo no celular. Se o número já está no WhatsApp Business, ele se conecta pelo coexistence (seção mais abaixo).
- A Meta verifica o nome de exibição (display name), e essa moderação leva tempo.
- Um número = uma conta Kommo: não dá para reconectá-lo em outra conta.
O que você precisa antes de começar
Junte tudo com antecedência, porque correr atrás disso no meio do caminho é desconfortável:
- Plano do Kommo. Pago (Base, Advanced ou Enterprise) ou um trial de 14 dias ativo.
- Conta pessoal do Facebook, é por ela que passa a autorização na Meta.
- Portfólio do Meta Business (Facebook Business Portfolio), onde mora a conta do WhatsApp Business. O ideal é passar pela verificação do negócio com antecedência: sem ela o limite é de 2 números, com ela vai até 20.
- Número de telefone separado com código do país (não um número curto), que receba o código por SMS ou ligação. Três cenários:
- número novo, nunca usado no WhatsApp;
- número de um WhatsApp pessoal, primeiro apague nele a conta do WhatsApp;
- número já no aplicativo WhatsApp Business, aí não desvincule, vá pelo caminho do coexistence (abaixo).
Conectar o Cloud API passo a passo
Na interface do Kommo (número novo):
- Abra a seção WhatsApp no menu da esquerda → Conectar.
- Escolha "Usar outro número de telefone".
- Faça login na sua conta pessoal do Facebook.
- Escolha ou crie uma conta do WhatsApp Business.
- Crie o portfólio do WhatsApp Business (se ainda não existir).
- Preencha o perfil do negócio: nome, categoria, dados.
- Adicione o número e peça a confirmação (SMS ou ligação).
- Digite o código de confirmação.
- Confirme o acesso do Kommo à conta.
- Finalize a configuração na janela do Kommo, o número deve ganhar um checkbox verde.
A partir daí, as mensagens recebidas passam a criar negócios no funil escolhido, o histórico aparece no cartão e vários vendedores conseguem responder pelo mesmo número.
Confirmação do número e moderação do nome
Dois pontos em que os iniciantes tropeçam:
- Confirmação do número. O código chega por SMS ou ligação. O número precisa ser real e não estar conectado ao aplicativo do WhatsApp no celular. Se ele já está logado no aplicativo do telefone, a confirmação não passa.
- Moderação do nome de exibição. A Meta verifica o display name da empresa pelas próprias regras (o nome precisa corresponder à marca, sem palavras a mais nem acréscimos). Isso não é instantâneo: a verificação pode levar de 1 a 3 dias, e até o nome ser aprovado você não consegue usar o WhatsApp Business.
Coexistence: se o número já está no aplicativo WhatsApp Business
Se o cliente não quer abrir mão do aplicativo WhatsApp Business no celular, o número se conecta no modo coexistence, funcionando ao mesmo tempo no aplicativo e no Cloud API dentro do Kommo.
O que é preciso:
- qualquer plano do Kommo ou trial;
- o aplicativo WhatsApp Business na versão 2.24.17 ou superior;
- portfólio do Meta Business;
- código de país suportado (as exceções são Nigéria e África do Sul);
- o número precisa já estar em uso no aplicativo há algum tempo (contas novas exigem histórico de uso).
Como funciona: as mensagens se sincronizam nos dois sentidos em tempo real, o que chega no aplicativo aparece no Kommo e vice-versa, e o histórico é comum. O que você responde à mão pelo celular sai sem custo; você paga só pelas mensagens ativas enviadas via API.
Limitações do coexistence que vale avisar ao cliente:
- importam-se só os chats ativos dos últimos 30 dias;
- os chats em grupo não se sincronizam;
- depois de conectar, edição e exclusão de mensagens são desativadas;
- as mensagens temporárias e o "ver uma vez" ficam indisponíveis;
- as listas de transmissão passam para o modo "somente leitura".
Depois de conectar: janela de 24 horas, modelos, opt-in
O Cloud API vive segundo as regras da Meta. Em resumo:
- Janela de 24 horas. Dá para conversar livremente por 24 horas após a última mensagem do cliente.
- Início só com modelo. Para escrever primeiro ou fora da janela de 24 horas, é preciso enviar um modelo pago aprovado com antecedência. Mesmo a moderação sendo rápida, recomendo criar e enviar para moderação ao menos um modelo logo após conectar, para não ter de esperar depois.
- Opt-in. O cliente precisa concordar em receber mensagens; disparo sem consentimento leva a denúncias e bloqueio do número.
Limites e erros comuns
- Um número, uma conta Kommo. O número conectado não pode ser usado em outra conta.
- Limite de números: sem verificação do negócio, 2; com verificação, até 20 (ampliável sob solicitação).
- Erros comuns: conectar num número já logado no WhatsApp do celular (a confirmação não passa); pular a verificação do negócio e esbarrar no limite; esquecer que o display name é moderado e ficar se perguntando "por que não envia"; disparar sem opt-in e sem um modelo aprovado.
O que vem a seguir
WhatsApp conectado de forma oficial. O próximo passo é não deixar os leads dele esfriarem: controlar a velocidade da primeira resposta (SLA) e distribuir a entrada para um vendedor livre. E se precisar de um bot, ele se configura por regras próprias da Meta (veja a análise sobre o bot e as regras de 2026).