--- title: "Conectar WhatsApp Cloud API ao Kommo — número novo, Coexistência e migração" description: "Como conectar WhatsApp Cloud API ao Kommo: número novo, Coexistência (app Business + API) ou migração de outro provedor. Limites, chamadas e como a Waply se encaixa." lang: pt canonical: https://waply.online/pt/guides/connect-whatsapp-kommo/ sitemap: https://waply.online/sitemap.md --- # Conectar WhatsApp Cloud API ao Kommo: número novo, Coexistência ou migração Atualizado: 2026-09-25 **Você pode conectar o WhatsApp ao Kommo pela Cloud API oficial da Meta de três formas: número novo, Coexistência (mesmo número no app WhatsApp Business e na Cloud API para mensagens) ou migração de outro provedor ou integração anterior do Kommo.** A doc curta da Waply cobre os cliques do produto; este guia é o caminho de decisão completo. A Coexistência mantém o app do telefone para chats 1:1, mas a Meta não habilita a Calling API do WhatsApp em números onboardados com coexistência. A Waply usa apenas Cloud API oficial: mensagens, chamadas humanas em números platform-only elegíveis e IA independente. O suporte e o blog do Kommo já ranqueiam para “conectar WhatsApp ao Kommo” e coexistência. A doc da Waply (conectar número e números/coexistência/migração) é deliberadamente breve. Use este guia para escolher o caminho, entender limites Meta/Kommo (principalmente chamadas) e saber quando instalar a Waply — depois siga a doc linkada para a UI. [Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com tudo do Voice AI. ## 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. **Três caminhos oficiais de Cloud API para times Kommo (set 2026)** | Caminho | Quando usar | App do telefone | Calling API do WhatsApp | | --- | --- | --- | --- | | Número novo | O número está livre para WhatsApp Business Platform, ou você começa do zero | Não está no app WhatsApp Business para esse número | Possível em números platform-only elegíveis | | Coexistência | O número já vive no app WhatsApp Business; você quer mensagem CRM/API sem abrir mão do app | Continua ativo; chats 1:1 podem sincronizar | Não suportada na Cloud API (Meta) | | Migração | O número está em outro BSP, API anterior ou outra integração WhatsApp do Kommo | Em geral não fica no app — platform-only após migrar por completo | Possível após migrar para platform-only (elegibilidade ainda vale) | > 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](/pt/guides/whatsapp-lite-kommo/) - [Guia: integrações de WhatsApp para Kommo](/pt/guides/whatsapp-integrations-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](/pt/docs/connect-number/) - [Docs: primeira mensagem e primeira chamada](/pt/docs/first-message-call/) [Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com tudo do Voice AI. ## 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](/pt/docs/numbers-coexistence-migration/) - [Guia: chamadas de WhatsApp no Kommo](/pt/guides/whatsapp-calls-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](/pt/docs/numbers-coexistence-migration/) - [Guia: preços da API WhatsApp 2026](/pt/guides/whatsapp-api-pricing-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. **Planos Waply (USD, waply.online/pricing)** | Plano | Mensal | Inclusões relevantes para WhatsApp | | --- | --- | --- | | Basic | USD 18 | Mensagens API oficial; chamadas humanas de WhatsApp e gravações (retenção 90 dias) | | AI 24/7 | USD 39 | Tudo do Basic + agentes de IA de texto, allowances de inteligência de chamadas, retenção 365 dias | | Voice AI | USD 89 | Tudo do AI 24/7 + agentes Voice AI em chamadas de WhatsApp (minutos managed/BYOK) | - 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](/pt/pricing/) - [Produto: chamadas](/pt/product/calls/) - [Guia: agente Voice AI para Kommo](/pt/guides/voice-ai-agent-kommo/) - [Guia: IA Waply vs IA nativa do Kommo](/pt/guides/waply-vs-kommo-ai/) [Ver planos Waply](/pt/pricing/) [Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com tudo do Voice AI. ## Perguntas frequentes ### Como conecto WhatsApp Cloud API ao Kommo? Instale uma integração oficial de Cloud API (WhatsApp Business do Kommo e/ou Waply), conclua o Embedded Signup da Meta, selecione Business Portfolio / WABA / número, espere aparecer como conectado e teste mensagens. As telas exatas estão na doc de conectar número da Waply. ### O que é WhatsApp Coexistência no Kommo? Coexistência permite que o mesmo número continue no app WhatsApp Business e entre na Cloud API para mensagens 1:1 sincronizadas. O blog e o suporte do Kommo descrevem requisitos (versão do app, Business Portfolio, países suportados). Não é o produto QR do WhatsApp Lite. ### Posso manter o app Business e ainda usar chamadas de WhatsApp no CRM? Mensagens podem sincronizar sob coexistência. A Meta não suporta Calling API de voz/vídeo na Cloud API para números onboardados com coexistência. Para Calling API, gravações no lead ou Voice AI em chamadas, use um número platform-only elegível. ### Como migro um número de outro provedor? Siga a migração de número da Meta para a WABA que você usará com Kommo/Waply. O Kommo documenta caminhos automáticos vs manuais e pré-requisitos (business verificado, WABA aprovada, método de pagamento, verificação em duas etapas off). Não apague o número do host antigo até o caminho estar claro. ### Devo desconectar meu BSP antigo antes de conectar? Em geral não — não até confirmar os requisitos de migração. Desconectar cedo é uma causa frequente de downtime. Primeiro identifique se precisa de coexistência, migração automática ou liberação manual. ### A Waply usa WhatsApp QR não oficial? Não. A Waply conecta WhatsApp apenas pela Cloud API oficial da Meta. ### Quais são os planos da Waply e há teste? Basic é USD 18/mês, AI 24/7 é USD 39/mês, Voice AI é USD 89/mês. O teste grátis de 3 dias inclui tudo do Voice AI. Cobranças da Meta e BYOK são separadas quando aplicáveis. ### Onde estão os passos clique a clique do produto? Na doc da Waply: conectar um número, e números / coexistência / migração. Este guia explica qual caminho escolher e os limites Meta/Kommo; a doc fica como checklist de UI. ## Conecte por um caminho oficial e prove a mensagem Escolha número novo, coexistência ou migração antes de tocar o host antigo. Instale a Waply quando quiser mensagens Cloud API oficiais no Kommo mais chamadas e IA independente em números elegíveis — com teste de 3 dias Voice AI. [Instalar no Kommo](https://api.waply.online/oauth/kommo/website/start?locale=pt) — Teste grátis de 3 dias com tudo do Voice AI. [Ver planos Waply](/pt/pricing/) ## Fontes - [Docs Waply: conectar um número](https://waply.online/pt/docs/connect-number/) - [Docs Waply: números, coexistência, migração](https://waply.online/pt/docs/numbers-coexistence-migration/) - [Blog Kommo: WhatsApp coexistence](https://www.kommo.com/blog/whatsapp-coexistence/) - [Kommo: Manage WhatsApp chats in both Kommo and the app](https://support.kommo.com/docs/manage-whatsapp-chats-in-both-kommo-and-the-app) - [Kommo: Connect WhatsApp Business app (incl. from Lite)](https://support.kommo.com/docs/whatsapp-business-app-connect) - [Kommo: Connect from different integrations or providers](https://support.kommo.com/docs/connect-to-whatsapp-business-from-different-integrations-or-providers-outside-kommo) - [Kommo: Connect previously used numbers to WhatsApp Business](https://support.kommo.com/docs/connect-previously-used-numbers-to-whatsapp-business) - [Meta: Onboard WhatsApp Business app users (coexistence; calls not supported)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users) - [Waply: preços](https://waply.online/pt/pricing/)