---
title: "Migrando da API não oficial para a Oficial"
url: https://ajuda.botconversa.com.br/aula/migrando-para-a-api-oficial
section: "WhatsApp API Oficial"
date_modified: 2026-09-07T17:57:38.210477+00:00
language: pt-BR
---

# Migrando da API não oficial para a Oficial

## Resposta rápida

Em **Conexões → WhatsApp** aparece um banner com o botão **Mudar API**. Você confirma digitando a palavra **Concordar** e valida com um código enviado ao e-mail da conta. **É um caminho sem volta:** depois de migrar, a API não oficial deixa de estar disponível, e o número conectado é desconectado automaticamente.

**Tempo de leitura:** ~6 min**Para quem é:** Quem está na API não oficial

## Devo migrar?

A migração traz ganhos reais, mas cobra um preço. Vale decidir com os dois lados à vista.

O que você ganha

O que você aceita

**Estabilidade e segurança** — entrega mais confiável, na infraestrutura da Meta

**Janela de 24 horas** — fora dela, só modelo aprovado

**Recursos empresariais** — remetente verificado, modelos de mensagem, mídia com entrega garantida

**Custo por mensagem** iniciada pela empresa fora da janela

**Integrações homologadas** pela Meta

**Possível perda de público** ao desconectar o número atual

**Leia antes de clicar:** se você tem um número conectado, ele é **desconectado automaticamente** e precisará ser reconectado. E, depois de mudar para a API da Meta, **a API do BotConversa não fica mais disponível** nessa companhia. Não é uma chave que se liga e desliga.

## Como faço a migração?

![Banner "Mudar para a API do WhatsApp Business da Meta" em Conexões, com o botão Mudar API destacado](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/08-api-oficial/migrando-para-a-api-oficial/passo-1.png)

O banner fica no topo de **Conexões → WhatsApp**. O botão azul à direita é o **Mudar API**.

1.  No painel do BotConversa, vá em **Conexões → WhatsApp**.
2.  No topo da página, localize o banner sobre mudar para a API do WhatsApp Business da Meta e clique em **Mudar API**, o botão azul à direita.
3.  Leia a janela de confirmação inteira — ela lista os benefícios e os pontos de atenção acima.
4.  No campo indicado na parte de baixo, digite a palavra **Concordar**.
5.  Clique em **Mudar API**.
6.  Um **código de verificação** é enviado para o e-mail cadastrado na conta. Copie o código — se não encontrar, **confira a pasta de spam**.
7.  Digite o código nos campos da tela e clique em **Confirmar**.

![Janela de confirmação da migração, com benefícios, pontos de atenção e o campo onde digitar Concordar](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/08-api-oficial/migrando-para-a-api-oficial/passo-2.png)

A janela lista benefícios e pontos de atenção. Na parte de baixo, o campo onde você digita **Concordar**.

![Janela Mudar API pedindo o código de verificação enviado por e-mail, com os seis campos destacados](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/08-api-oficial/migrando-para-a-api-oficial/passo-3.png)

O código de seis dígitos chega no e-mail da conta. Se não aparecer, confira o spam.

Depois disso, o próximo passo é conectar o número pela API Oficial. Se você quer continuar usando o WhatsApp no celular em paralelo, siga [Conectando o WhatsApp por coexistência](/aula/conectando-o-whatsapp-por-coexistencia).

## Como me preparo antes?

-   **Escolha um horário de baixo movimento.** Entre a migração e a reconexão, a automação fica fora do ar.
-   **Tenha acesso ao e-mail da conta** — o código de verificação vai para lá, e sem ele a migração não conclui.
-   **Prepare seus modelos de mensagem.** Depois de migrar, alcançar quem está fora da janela de 24 horas exige modelo aprovado, e a aprovação leva tempo.
-   **Avise a equipe.** Quem está no atendimento precisa saber que o número vai oscilar.

## Dicas

-   **Não migre na véspera de uma campanha.** Os limites de envio da conta nova começam baixos e crescem com o uso saudável.
-   **Revise sua régua de mensagens.** O que era gratuito na API não oficial passa a ter custo quando sai fora da janela — vale repensar o que realmente precisa ser enviado.
-   **Guarde o ID da conta na Meta** assim que conectar. É a primeira informação que o suporte pede.

**🎯 Missão desta aula:** avalie a tabela de ganhos e custos e decida se a migração faz sentido para o seu volume; se decidir migrar, prepare os modelos de mensagem antes.

**Checkpoint:** você tem uma decisão registrada, com data, e a equipe avisada.

## Perguntas frequentes

Dá para voltar para a API não oficial depois?

Depois de mudar, a API do BotConversa não fica mais disponível nessa companhia. Trate como decisão definitiva e, se tiver dúvida, converse com o suporte antes.

Perco meus contatos e fluxos?

Não. Contatos, fluxos, campos e etiquetas continuam na plataforma. A mudança é na camada de conexão com o WhatsApp.

Por que fala em "possível perda de público"?

Porque desconectar o número muda a forma como as conversas em aberto são tratadas. Conversas fora da janela de 24 horas passam a exigir modelo aprovado para serem retomadas.

Não recebi o código de verificação.

Confira a pasta de spam e o endereço cadastrado na conta. Se mesmo assim não chegar, fale com o suporte antes de tentar repetidamente.