Migrando da API não oficial para a Oficial
Por Equipe BotConversa · Atualizado em 7 de setembro de 2026
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.
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?

- No painel do BotConversa, vá em Conexões → WhatsApp.
- 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.
- Leia a janela de confirmação inteira — ela lista os benefícios e os pontos de atenção acima.
- No campo indicado na parte de baixo, digite a palavra Concordar.
- Clique em Mudar API.
- 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.
- Digite o código nos campos da tela e clique em Confirmar.


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