> For the complete documentation index, see [llms.txt](https://ajuda.botconversa.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.botconversa.com.br/comece-por-aqui-aulas-sequenciais/primeiros-passos-botconversa-api-oficial/aula-3-como-conectar-seu-whatsapp-no-botconversa-oficial-com-coexistencia/por-que-a-conexao-do-seu-whatsapp-falhou-incompatibilidade-de-moeda.md).
# Por que a conexão do seu WhatsApp falhou: incompatibilidade de moeda
#### O que aconteceu
A Meta realizou alterações no funcionamento da linha de crédito — a cobrança que cobre o custo das suas mensagens — passou a operar em BRL. A Meta só permite compartilhar uma linha de crédito com uma Conta do WhatsApp Business (WABA) que use a mesma moeda. Se a sua WABA está em USD, a Meta recusa o pareamento — e é esse o erro que aparece.
#### Quem é afetado
O que determina o problema é a **moeda da WABA** — não a data em que ela foi criada nem o país do seu negócio.
* **Você é afetado** se a sua WABA está em USD (ou qualquer moeda diferente de BRL). Nesse caso, ela não conecta à nossa linha de crédito em BRL.
* **Você não é afetado** se a sua WABA ainda não tem moeda definida ou já está em BRL. Nesses casos, a conexão funciona normalmente.
Para conferir a moeda da sua WABA, acesse o Gerenciador de Negócios da Meta em Configurações do negócio → Contas do WhatsApp. Na dúvida, siga a solução abaixo — ela resolve nos dois casos.
Abaixo, separamos o procedimento exato que você deve seguir caso sua conexão seja em **Coexistência.**
#### 🔄 Seu número utiliza Modo Coexistência (Com Coex)
Se você utiliza o BotConversa em modo de Coexistência (conectado na API e simultaneamente com o aplicativo de celular funcionando), a Meta possui um mecanismo de cache que impede a simples exclusão.
Se você tentar apenas apagar e recriar a WABA, a Meta recriará a conta com o mesmo ID, o mesmo nome e a mesma moeda (USD). Para "quebrar" esse vínculo e forçar a criação em BRL, escolha um dos dois caminhos abaixo:
**Método 1: Migração via WhatsApp Pessoal (Recomendado - Preserva Conversas)**
*Este método limpa o registro de API na Meta, mas mantém todas as conversas e contatos salvos no seu celular.*
1. **Faça Backup:** No aplicativo WhatsApp Business do seu celular, vá em *Configurações > Conversas > Backup de conversas* e faça um backup completo.
2. **Migre para o WhatsApp Messenger (Pessoal):**
* Baixe o aplicativo do WhatsApp Pessoal no celular.
* Insira seu número de telefone e faça a confirmação por SMS.
* Restaure o backup das suas conversas. *(Neste momento, seu número deixará de ser uma conta comercial temporariamente, o que limpa o cache da API nos servidores da Meta).*
3. **Retorne para o WhatsApp Business:**
* Abra novamente o aplicativo do WhatsApp Business.
* Faça a confirmação do número e migre as conversas de volta para a versão Business.
4. **Conecte no BotConversa:**
* No painel do BotConversa, inicie o processo de conexão.
* Como o registro antigo da API foi totalmente desfeito pelo processo de migração, a Meta criará uma **WABA totalmente nova com a moeda em Real (BRL)**.
> ⚠️ **Importante:** Este processo preserva seus chats e contatos no aparelho celular, mas como uma nova WABA é gerada do zero, as configurações anteriores da API (como templates e variáveis salvas) precisarão ser reconfiguradas. Ao recriar as mensagens automáticas no painel do BotConversa, lembre-se de sempre utilizar variáveis em chaves simples, como por exemplo: {nome} ou {telefone}.
**Método 2: Formatação Física do Aplicativo (Rápido - Apaga Conversas)**
*Use este método apenas se você não se importar em perder o histórico de conversas existentes no celular do cliente.*
1. **Desinstale o Aplicativo:** Desinstale completamente o aplicativo WhatsApp Business do seu celular. **Não faça backup**.
2. **Limpeza de Registro:** Aguarde cerca de 5 a 10 minutos para garantir que os servidores da Meta atualizem o status de desconexão do número.
3. **Reinstale e Reconecte:** Instale o aplicativo novamente, ative o número e faça a nova conexão pelo painel do BotConversa. O sistema gerará a nova WABA em BRL.
Se tiver qualquer dúvida durante o processo de migração de moedas de sua WABA, entre em contato com o nosso time de suporte técnico abrindo um chat direto na plataforma!
#### 🔄 Seu número utiliza Modo SEM Coexistência (Sem Coex)
A Meta não permite alterar a moeda de uma WABA já criada. Por isso, a conexão precisa ser feita com uma WABA em BRL. Seu número não é perdido: ele pode ser registrado na nova conta.
Antes de começar:
* **Modelos de mensagem não são transferidos.** Os templates pertencem à WABA. Salve uma cópia (nome, categoria e texto de cada um) para reenviar depois.
* **Qualidade e limites recomeçam.** A nova WABA começa do zero e os limites de envio se reconstroem nos primeiros dias de uso.
* **Seus dados na plataforma permanecem.** Contatos, fluxos e automações não são afetados — a mudança é só na camada da conta na Meta.
Passo a passo:
1. **Desconecte o número atual** nas configurações do canal na plataforma.
2. **Libere o número da WABA antiga** (ou exclua a WABA antiga, se ela não tiver outros números que você use), no Gerenciador de Negócios → Contas do WhatsApp. O número precisa estar livre para ser registrado em outra conta.
3. **Inicie uma nova conexão** na plataforma, pelo fluxo normal pelo PopUp de Conexão, e escolha **criar uma nova Conta do WhatsApp Business**, em vez de selecionar uma existente. A nova conta é criada sem moeda definida.
4. **Registre o número** na nova WABA e conclua a verificação (SMS ou ligação).
5. **Pronto.** Ao compartilharmos nossa linha de crédito, a nova WABA passa a operar em BRL e o número volta a funcionar.
Depois de conectar, **reenvie seus modelos de mensagem** para que campanhas e automações que dependem deles continuem funcionando.
#### Perguntas frequentes
**Vou pagar algo a mais por isso?** Não. Recriar a WABA é gratuito e o preço das mensagens não muda — o que muda é apenas a moeda da cobrança.
**Meus clientes vão notar alguma coisa?** Não. Número, nome de exibição e perfil continuam os mesmos.
**A Meta não pode simplesmente migrar minha conta para BRL?** Hoje a única forma de migração é via API, e ainda estamos validando esse caminho. Por enquanto, o procedimento suportado é conectar uma WABA em BRL, como descrito acima.
#### Ainda com problema?
Se você seguiu os passos e a conexão continua falhando, fale com o nosso suporte pelo chat e mencione este artigo. Informe o **ID da sua WABA** (disponível no Gerenciador de Negócios da Meta) para agilizarmos o diagnóstico.\
\
Suporte pelo WhatsApp:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ajuda.botconversa.com.br/comece-por-aqui-aulas-sequenciais/primeiros-passos-botconversa-api-oficial/aula-3-como-conectar-seu-whatsapp-no-botconversa-oficial-com-coexistencia/por-que-a-conexao-do-seu-whatsapp-falhou-incompatibilidade-de-moeda.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.