Conectar WhatsApp Cloud API ao Kommo: número novo, Coexistência ou migração

Qual caminho cabe ao seu número?

Antes de abrir o Embedded Signup da Meta, identifique como o número é usado hoje. Escolher o caminho errado é a principal causa de desconexões cedo demais ou de cortes de mensagem na virada.

Conectores QR / “grey” não oficiais são outra categoria. Para o histórico Lite/QR e opções de vendors, veja o guia WhatsApp Lite no Kommo. Esta página fica nos caminhos oficiais de Cloud API.

• Guia: WhatsApp Lite no Kommo
• Guia: integrações de WhatsApp para Kommo

Conectar um número novo de Cloud API

Use este caminho quando o número é elegível para onboarding da WhatsApp Business Platform e não está amarrado a outro host de Cloud API que você ainda precisa. Fluxo de alto nível com a Waply instalada no Kommo:

1. Instale a Waply no Kommo e abra Números → Conectar número do WhatsApp.
2. Conclua o acesso da Meta e selecione o Business Portfolio, a conta WhatsApp Business e o número.
3. Volte à Waply e espere o número aparecer como conectado antes de ligar automações ou chamadas.
4. Envie uma mensagem de teste permitida (e uma chamada humana se o número for platform-only e Calling estiver habilitado).

• Você precisa de acesso ao Meta Business Portfolio que vai possuir os ativos do WhatsApp.
• Verificação pendente da Meta ou permissões faltando nos ativos precisam ser resolvidas antes do número ficar pronto.
• Preço de conversa e regras de modelo da Meta valem no lado Cloud API; a assinatura da Waply é separada.

As telas clique a clique ficam na doc da Waply. Este guia é a resposta SEO/AEO de qual caminho escolher; a doc permanece o checklist de produto.

• Docs: conectar um número
• Docs: primeira mensagem e primeira chamada

Coexistência: manter o app WhatsApp Business

Coexistência (o fluxo da Meta para onboardar usuários do app WhatsApp Business) permite que o mesmo número rode no app e na Cloud API ao mesmo tempo para mensagens 1:1 sincronizadas. O Kommo documenta isso na integração WhatsApp Business; a Waply suporta números em coexistência para mensagens na Cloud API oficial.

O que costuma funcionar

• Chats 1:1 espelhados entre o app Business e Cloud API / inbox do CRM (conforme Meta + Kommo).
• Sincronização de contatos conforme Meta/Kommo documentam no fluxo de coexistência.
• Modelos e automação Cloud API no lado API, enquanto chats manuais podem continuar no telefone.

Limites críticos (incluindo chamadas)

• Chamadas de voz e vídeo: não suportadas na Cloud API para números onboardados com coexistência (tabela de capacidades da Meta). Você ainda pode ligar pelo app WhatsApp Business; isso não vira sessões Calling API no CRM.
• Grupos, listas de transmissão, mensagens que desaparecem / de visualização única / localização ao vivo, e várias ferramentas do app Business (catálogo, status, Channels etc.) não sincronizam com a Cloud API — veja a tabela da Meta e o artigo de suporte do Kommo.
• Elegibilidade: o Kommo indica códigos de país suportados, versão do app e que contas novas do app Business não são elegíveis de imediato — confirme no produto; não invente um número de dias de tenure.
• Janelas de importação de histórico variam conforme o produto (o suporte do Kommo cita chats recentes, da ordem dos últimos ~30 dias no caminho de importação). Trate isso como documentação de produto, não como SLA da Meta.

Se você precisa de Calling API do WhatsApp, gravações no lead ou Voice AI em chamadas, planeje um número platform-only (sem coexistência). Veja o guia de chamadas de WhatsApp no Kommo.

• Docs: números, coexistência, migração
• Guia: chamadas de WhatsApp no Kommo

Migrar de outro provedor ou caminho anterior do Kommo

A migração move um número que já está na WhatsApp Business Platform (outro BSP, caminho de API anterior ou outra integração WhatsApp do Kommo) para a conta WhatsApp Business que você usará com Waply/Kommo.

• Não desconecte nem apague o número do host antigo “para corrigir um estado pendente” até o caminho de transferência da Meta estar claro — a doc da Waply e do Kommo avisam isso.
• O Kommo documenta migração automática vs manual. A automática tipicamente exige Business Meta verificado, WABA aprovada, método de pagamento válido na WABA existente e verificação em duas etapas desativada no número — confirme checklists atuais no suporte.
• Nome de exibição, limites ligados à qualidade e modelos elegíveis podem transferir sob regras da Meta; automações muitas vezes precisam ser reconfiguradas após o corte.
• Números que só vivem no app WhatsApp Business (sem Cloud API ainda) costumam seguir coexistência ou um registro platform novo — não só o artigo de “migrar de outro BSP”.
• Lite → WhatsApp Business dentro do Kommo tem seu próprio caminho de merge de fontes; veja o guia Lite em vez de duplicar aqui.

Soft-word: blogs de partners às vezes comprimem a migração em um relato de “um clique”. Use os artigos de migração do Kommo e a orientação de números da Meta como checklist, e teste envio/recebimento antes de desligar o provedor antigo.

• Docs: números, coexistência, migração
• Guia: preços da API WhatsApp 2026

Como a Waply se encaixa

A Waply é um produto independente instalado no Kommo. Conecta WhatsApp só pela Cloud API oficial da Meta — não por conectores QR/sessão não oficiais — e adiciona chamadas humanas de WhatsApp (números elegíveis), inteligência de chamadas e IA de texto/voz em modelos de terceiros.

• O teste grátis de 3 dias inclui tudo do Voice AI.
• Números em coexistência: mensagens podem funcionar; chamadas de WhatsApp não (restrição da Meta).
• A IA da Waply não consome créditos da IA nativa do Kommo.
• Cobranças de mensagem e chamada da Meta são separadas; uso BYOK é cobrado pelo seu provedor.

• Planos Waply
• Produto: chamadas
• Guia: agente Voice AI para Kommo
• Guia: IA Waply vs IA nativa do Kommo

Ver planos Waply