--- title: "Mesmo número ao sair da Cloud API: como migrar" description: "Sim, dá para levar o número da API oficial do WhatsApp para a não oficial: remova da Cloud API, ative no app e conecte na WAME. Passo a passo e ressalvas." url: "https://api-wa.me/blog/usar-mesmo-numero-sair-cloud-api" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Dá para usar o mesmo número ao sair da Cloud API? Como migrar o número para a não oficial Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura Compartilhar # Dá para usar o mesmo número ao sair da Cloud API? Como migrar o número para a não oficial Sim, dá para levar o número da API oficial do WhatsApp para a não oficial: remova da Cloud API, ative no app e conecte na WAME. Passo a passo e ressalvas. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/usar-mesmo-numero-sair-cloud-api.md) **Sim: dá para levar o mesmo número da API oficial do WhatsApp para a API não oficial. O caminho é remover o número da Cloud API, voltar a ativá-lo no aplicativo WhatsApp Business e conectá-lo à WAME (api-wa.me) por QR Code ou código de pareamento. O que não dá é usar o mesmo número nos dois lados ao mesmo tempo — para isso, a estratégia é ter dois números.** A pergunta ficou frequente com a nova cobrança da Meta: a partir de 1º de outubro de 2026, toda mensagem de serviço enviada pela Cloud API é cobrada, desde a primeira, sem faixa grátis (detalhes em [WhatsApp API mais cara em outubro](https://api-wa.me/blog/mudanca-cobranca-whatsapp-api-outubro-2026)). Quem decide mover o atendimento quase sempre quer manter o número que os clientes já conhecem. Este guia mostra como, e o que fica para trás. ## Por que o número não pode ficar nos dois lados? Porque as duas APIs usam o número de formas incompatíveis: - **Cloud API**: o número é registrado nos servidores da Meta e deixa de funcionar no aplicativo comum. - **API não oficial**: a WAME se conecta como um **aparelho conectado** ao WhatsApp que roda no celular — igual ao WhatsApp Web. Para isso, o número precisa estar **ativo no app**. Um número só pode estar em um desses estados. Por isso "migrar" significa tirá-lo de um e colocá-lo no outro. ## Mesmo número, número novo ou híbrido? Antes do passo a passo, vale decidir se migrar o número é mesmo a melhor opção: | Opção | Quando escolher | Vantagem | Ressalva | | --- | --- | --- | --- | | Mesmo número na não oficial | O número é conhecido e quase tudo é atendimento | Clientes continuam no mesmo contato | Perde templates e histórico oficial | | Número novo na não oficial | Você quer testar antes ou manter o oficial intacto | Zero risco para o número atual | Precisa divulgar o número novo | | Híbrido (oficial + não oficial) | Você ainda precisa de templates, OTP ou campanhas | Mantém o melhor dos dois lados | Dois números para gerenciar | O modelo híbrido — oficial para template, não oficial para conversa — está detalhado em [estratégia híbrida](https://api-wa.me/blog/estrategia-hibrida-api-oficial-nao-oficial-whatsapp). Se a sua dúvida é migrar sem risco, veja também [migrar o WhatsApp em paralelo, sem risco](https://api-wa.me/blog/migrar-whatsapp-em-paralelo-sem-risco). ## Passo a passo para levar o mesmo número ### 1\. Prepare o sistema antes de desligar Deixe a integração com a WAME pronta **antes** de tirar o número da Cloud API, para que a janela sem atendimento seja de minutos: - Crie a instância não oficial na WAME. - Aponte o webhook com o formato da Meta, para o seu sistema continuar lendo o mesmo envelope: bash Copiar ``` curl -X PUT "https://us.api-wa.me/SUA_KEY_NOVA/instance" \ -H "Content-Type: application/json" \ -d '{ "allowWebhook": true, "allowNumber": "all", "webhookMessage": "https://seu-dominio.com/webhook/SEGREDO", "webhookConnection": "https://seu-dominio.com/conexao/SEGREDO", "webhookFormat": "meta" }' ``` - Troque, no seu código, a URL base e a autenticação. O corpo de envio continua o da Cloud API em `POST /{key}/message`. A lista completa de ajustes está em [trocar graph.facebook.com pela WAME](https://api-wa.me/blog/trocar-graph-facebook-por-wame-checklist). ### 2\. Guarde o que não vai junto - **Lista de quem optou por receber mensagens** e o histórico de conversas que está no seu sistema. - **O PIN de verificação em duas etapas** do número, se foi definido na Cloud API — ele pode ser pedido quando o número for ativado no app. - **Textos dos templates**, se quiser reaproveitar como mensagens comuns. Na não oficial não há template: o texto é livre. ### 3\. Remova o número da Cloud API - **Se o número está numa instância oficial da WAME**: use o endpoint de remoção do registro. bash Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY_OFICIAL/instance/official/deregister" ``` - **Se está em outro provedor (BSP)**: peça a remoção do registro ao provedor ou faça pelo painel dele. Dependendo de como o número foi cadastrado na conta da Meta, também pode ser preciso **remover o número da conta do WhatsApp Business no WhatsApp Manager** antes de o aplicativo aceitar a verificação. Se o app recusar, esse costuma ser o motivo. ### 4\. Ative o número no aplicativo WhatsApp Business Instale o WhatsApp Business num celular, informe o número e confirme o código recebido por SMS ou ligação. Configure nome, foto e descrição — o perfil completo ajuda o número a parecer o que ele é: uma empresa real. ### 5\. Conecte na WAME No app: **Aparelhos conectados > Conectar um aparelho**. Leia o QR Code do painel da WAME ou use o código de pareamento: bash Copiar ``` curl -X POST "https://us.api-wa.me/SUA_KEY_NOVA/instance/pairing-code" \ -H "Content-Type: application/json" \ -d '{ "phoneNumber": "5511999999999" }' ``` A resposta traz o código em `code`. Se você só tem o celular à mão, siga [como conectar pelo celular, sem QR Code](https://api-wa.me/blog/conectar-whatsapp-api-pelo-celular-sem-qr-code). ### 6\. Volte a atender, com calma no começo O número tem histórico com os seus clientes, mas é um aparelho novo conectado. Nos primeiros dias, priorize **responder quem chama** e segure disparos ativos. O plano de ritmo está em [como aquecer um número na API não oficial](https://api-wa.me/blog/aquecer-numero-whatsapp-api-nao-oficial). ## O que fica para trás? | Item | Continua | Não continua | | --- | --- | --- | | Número de telefone | Sim | — | | Contatos que já falaram com você | Sim | — | | Seu sistema e seu webhook (formato Meta) | Sim | — | | Templates aprovados | — | Não existem na não oficial | | Quality rating e limites da conta oficial | — | Ficam na Cloud API | | Conversas feitas pela API no app | — | Não aparecem no app | | Mensagens de serviço cobradas por mensagem | — | Deixam de existir: plano fixo por instância | ## E se o número estiver em Coexistência? Coexistência é o modo em que o número fica **no app WhatsApp Business e na Cloud API ao mesmo tempo**. É um caso diferente do descrito acima, e não vamos prometer como ele se comporta ao ser conectado também como aparelho na API não oficial. Se o seu número está em Coexistência, **fale com o suporte da WAME** antes de conectar. Para entender o modo, veja [API oficial sem perder o celular](https://api-wa.me/blog/whatsapp-api-oficial-manter-no-celular). ## Riscos que valem a pena conhecer A camada não oficial não é afiliada nem endossada pela Meta, e o uso é responsabilidade de quem envia. Para quem migra o **atendimento** — responder clientes que falam com você —, o risco de bloqueio é muito baixo para quem usa do jeito certo. O que derruba número é spam, e a WAME não apoia spam: a API recusa envio para muitos números novos por minuto e texto repetido em massa, e avisa pelo webhook de conexão quando o número dá sinal de restrição. A análise completa está em [riscos de trocar a API oficial pela não oficial](https://api-wa.me/blog/riscos-trocar-api-oficial-por-nao-oficial). ## Em resumo - Dá para usar o mesmo número, mas não nos dois lados ao mesmo tempo. - Ordem: preparar o sistema, guardar o que não vai junto, remover da Cloud API, ativar no app, conectar na WAME. - Instância oficial da WAME: remoção com `POST /{key}/instance/official/deregister`. - Templates, quality rating e histórico da conta oficial ficam para trás; número e clientes continuam. - Coexistência é caso à parte: fale com o suporte antes. ## Conclusão Migrar o número da Cloud API para a API não oficial é um processo de poucos passos, e o que ele preserva é justamente o que importa para o atendimento: o número que o cliente já salvou. O que fica para trás — templates, quality rating, histórico da conta oficial — pesa só para quem ainda depende de campanhas e autenticação, e para esses casos o híbrido com dois números resolve melhor. Com o sistema preparado antes, a troca dura minutos, e o seu código continua lendo o mesmo envelope da Meta. A referência dos endpoints está na [documentação](https://api-wa.me/docs). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## Perguntas frequentes Posso usar o mesmo número depois de sair da API oficial do WhatsApp?+ Sim. Um número registrado na WhatsApp Cloud API pode voltar a ser usado no aplicativo do WhatsApp ou do WhatsApp Business depois de ser removido da Cloud API. Com o número ativo no app, ele pode ser conectado à API não oficial da WAME (api-wa.me) por QR Code ou código de pareamento, como um aparelho conectado. Um número pode estar na Cloud API e na API não oficial ao mesmo tempo?+ Não. Enquanto o número está registrado na WhatsApp Cloud API, ele não fica ativo no aplicativo do WhatsApp, e a API não oficial precisa do número ativo no app para conectar por QR Code ou código de pareamento. Para usar os dois lados ao mesmo tempo, o caminho é ter dois números: um oficial e um não oficial. O que eu perco ao tirar o número da Cloud API?+ Ao sair da Cloud API, o número deixa de enviar templates aprovados e perde o histórico ligado à conta oficial, como os templates cadastrados e a classificação de qualidade (quality rating). As conversas feitas pela API também não aparecem no aplicativo. O número, os contatos que já falaram com você e a sua marca continuam. Como removo o número da Cloud API se ele está na WAME?+ Se o número está numa instância oficial da WAME (api-wa.me), a remoção do registro na Cloud API é feita com POST /{key}/instance/official/deregister. Dependendo de como o número foi cadastrado na conta da Meta, também pode ser necessário removê-lo da conta do WhatsApp Business no WhatsApp Manager antes de o aplicativo aceitar a verificação. Meu número está em Coexistência. Posso conectá-lo na API não oficial?+ Números em Coexistência já estão no aplicativo WhatsApp Business e na Cloud API ao mesmo tempo, o que é um caso diferente. Antes de conectar um número em Coexistência à API não oficial da WAME (api-wa.me), fale com o suporte da WAME para avaliar o caso específico. ## Continue lendo [### Alternativa à API oficial do WhatsApp depois do aumento de outubro de 2026 A partir de 1º de outubro de 2026 a Meta cobra toda mensagem de serviço. Veja as alternativas à API oficial e por que a WAME migra sem reescrever o sistema.](https://api-wa.me/blog/alternativa-api-oficial-whatsapp-outubro-2026)[### A API oficial do WhatsApp ainda vale a pena em 2026? Quando sim, quando não Com a cobrança de mensagem de serviço de outubro de 2026, veja quando a API oficial do WhatsApp compensa, quando a não oficial é melhor e quando usar as duas.](https://api-wa.me/blog/api-oficial-whatsapp-vale-a-pena-2026)[### API de WhatsApp mais barata em 2026: comparando os modelos de cobrança Cobrança por mensagem, plano fixo por instância ou self-host: qual API de WhatsApp sai mais barata em 2026, com a fórmula para calcular o seu caso.](https://api-wa.me/blog/api-whatsapp-mais-barata-2026) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Dá para usar o mesmo número ao sair da Cloud API? Como migrar o número para a não oficial", "description": "Sim, dá para levar o número da API oficial do WhatsApp para a não oficial: remova da Cloud API, ative no app e conecte na WAME. Passo a passo e ressalvas.", "image": "https://api-wa.me/blog/usar-mesmo-numero-sair-cloud-api/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/usar-mesmo-numero-sair-cloud-api" }, "keywords": "mesmo número api oficial whatsapp, sair da cloud api whatsapp, migrar api oficial whatsapp, api whatsapp não oficial, alternativa api oficial whatsapp, remover número cloud api, migrar número whatsapp para api não oficial", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Dá para usar o mesmo número ao sair da Cloud API? Como migrar o número para a não oficial", "item": "https://api-wa.me/blog/usar-mesmo-numero-sair-cloud-api" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Posso usar o mesmo número depois de sair da API oficial do WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Um número registrado na WhatsApp Cloud API pode voltar a ser usado no aplicativo do WhatsApp ou do WhatsApp Business depois de ser removido da Cloud API. Com o número ativo no app, ele pode ser conectado à API não oficial da WAME (api-wa.me) por QR Code ou código de pareamento, como um aparelho conectado." } }, { "@type": "Question", "name": "Um número pode estar na Cloud API e na API não oficial ao mesmo tempo?", "acceptedAnswer": { "@type": "Answer", "text": "Não. Enquanto o número está registrado na WhatsApp Cloud API, ele não fica ativo no aplicativo do WhatsApp, e a API não oficial precisa do número ativo no app para conectar por QR Code ou código de pareamento. Para usar os dois lados ao mesmo tempo, o caminho é ter dois números: um oficial e um não oficial." } }, { "@type": "Question", "name": "O que eu perco ao tirar o número da Cloud API?", "acceptedAnswer": { "@type": "Answer", "text": "Ao sair da Cloud API, o número deixa de enviar templates aprovados e perde o histórico ligado à conta oficial, como os templates cadastrados e a classificação de qualidade (quality rating). As conversas feitas pela API também não aparecem no aplicativo. O número, os contatos que já falaram com você e a sua marca continuam." } }, { "@type": "Question", "name": "Como removo o número da Cloud API se ele está na WAME?", "acceptedAnswer": { "@type": "Answer", "text": "Se o número está numa instância oficial da WAME (api-wa.me), a remoção do registro na Cloud API é feita com POST /{key}/instance/official/deregister. Dependendo de como o número foi cadastrado na conta da Meta, também pode ser necessário removê-lo da conta do WhatsApp Business no WhatsApp Manager antes de o aplicativo aceitar a verificação." } }, { "@type": "Question", "name": "Meu número está em Coexistência. Posso conectá-lo na API não oficial?", "acceptedAnswer": { "@type": "Answer", "text": "Números em Coexistência já estão no aplicativo WhatsApp Business e na Cloud API ao mesmo tempo, o que é um caso diferente. Antes de conectar um número em Coexistência à API não oficial da WAME (api-wa.me), fale com o suporte da WAME para avaliar o caso específico." } } ] } ```