---
title: "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."
url: "https://wame.api.br/blog/usar-mesmo-numero-sair-cloud-api"
language: "pt-BR"
og:type: "article"
published_time: "2026-09-28"
modified_time: "2026-09-28"
author: "Raphael Serafim"
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"
reading_time: "8 min de leitura"
---

# 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.

**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 (wame.api.br) 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](/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](/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](/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
curl -X PUT "https://server.wame.api.br/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](/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
curl -X POST "https://server.wame.api.br/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
curl -X POST "https://server.wame.api.br/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](/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](/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](/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](/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](/docs).

## 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 (wame.api.br) 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 (wame.api.br), 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 (wame.api.br), fale com o suporte da WAME para avaliar o caso específico.
