Migrar da API não oficial para a coexistência leva à API oficial do WhatsApp o número que os clientes já conhecem, sem tirá-lo do celular. A empresa conecta o WhatsApp Business App à Cloud API por um parceiro e automatiza dentro das regras da Meta.
Este guia reúne os pré-requisitos, o passo a passo da conexão, o destino de contatos e automações antigas, o opt-in para voltar a disparar e um checklist para o dia da troca.
Principais Conclusões
- A coexistência conecta à Cloud API o número que já está no WhatsApp Business App, e ele continua funcionando no celular.
- Antes da conexão: app Business na versão 2.24.17 ou superior, sessões não oficiais encerradas e número fora da API e de outras plataformas.
- Fluxos, listas e disparos da ferramenta antiga não migram: viram agente pela API e templates aprovados, enviados só para quem deu opt-in.
- Quando a operação precisa de mais de 20 mensagens por segundo ou atende só pela plataforma, o número dedicado na Cloud API tende a servir melhor.
Por Que Sair da API Não Oficial do WhatsApp
Sair da API não oficial do WhatsApp significa trocar uma automação feita fora das regras da Meta por uma conexão oferecida pela própria Meta. Para quem quer manter o número, a coexistência é o caminho que preserva o app e o histórico.
Do WhatsApp Web Automatizado para a API Oficial
Ferramentas não oficiais costumam automatizar uma sessão do WhatsApp Web ou do aplicativo, sem passar pela plataforma oficial. Os riscos, do banimento à falta de suporte, estão detalhados no guia API oficial x não oficial: riscos e como migrar.
Quem já recebeu avisos ou bloqueios encontra causas e caminhos de recuperação no artigo sobre WhatsApp banido. Aqui o foco é outro: o roteiro prático para levar o número atual até a API oficial, sem recomeçar do zero com os clientes.
Por Que a Coexistência Mantém o Número
A Meta chama o recurso de onboarding de usuários do WhatsApp Business App, também conhecido como coexistência. A empresa conecta à Cloud API o número que já usa no app e continua conversando pelo celular, com o histórico sincronizado entre os dois lados.
Na prática, o cliente segue falando com o mesmo número, e a automação passa a rodar pela API oficial. O guia completo de WhatsApp coexistência explica o recurso em detalhes; este artigo cobre a migração de quem vem de uma ferramenta não oficial.
Coexistência Sem Perder o Número: o Que Fica e o Que Muda
Na coexistência, o número continua no WhatsApp Business App, mas alguns recursos do app mudam de comportamento. Saber o que fica e o que muda evita surpresas para a equipe e para os clientes no primeiro dia depois da troca.
O Que Continua Igual no App
Segundo a documentação da Meta consultada em outubro de 2026, grupos, chamadas de voz e vídeo, catálogo, status e perfil comercial seguem no app sem mudança. Esses recursos, porém, não passam a funcionar pela API depois da conexão.
A empresa também pode manter até quatro dispositivos conectados, como o WhatsApp Web. Só o WhatsApp para Windows e o WhatsApp para Wear OS não são suportados. O celular principal continua sendo o centro da conta, e não a plataforma.
O Que Muda Depois da Conexão
Nos chats individuais, mensagens temporárias, visualização única e localização em tempo real são desativadas. As listas de transmissão ficam só para leitura, e novas listas não podem ser criadas no app depois da migração.
Os templates só podem ser enviados pela Cloud API, nunca pela interface do app. A velocidade também tem teto: segundo a documentação de throughput, o número em coexistência tem 20 mensagens por segundo fixas, somando as enviadas e as recebidas.
Pré-Requisitos Antes de Migrar
Os pré-requisitos da migração são três: o número no WhatsApp Business App atualizado, nenhuma sessão não oficial ativa e nenhum registro do número na API ou em outra plataforma. Cada um evita um erro conhecido na hora da conexão.
Número no WhatsApp Business App Atualizado
A Meta exige o WhatsApp Business App na versão 2.24.17 ou superior. Quem roda a automação não oficial sobre o WhatsApp comum precisa antes passar o número para o app Business; sem isso, o fluxo retorna erro de número não registrado.
Pela lista oficial de erros do cadastro incorporado, a elegibilidade também depende de atividade no app, e a Meta não publica um prazo mínimo. Um número vinculado a uma Página do Facebook precisa ser desvinculado antes, no Meta Business Suite.
Desligar Sessões e Automações Não Oficiais
No app, a empresa deve abrir a lista de dispositivos conectados e encerrar a sessão usada pela ferramenta não oficial. Também vale pausar fluxos, disparos agendados e respostas automáticas configurados nela antes do dia da troca.
No momento da conexão, a Meta desvincula todos os dispositivos conectados ao número. Ainda assim, desligar a ferramenta antes evita mensagens disparadas no meio do processo e deixa claro que nada não oficial volta a ser vinculado depois.
Número Fora da API e de Outras Plataformas
Um número já registrado na Cloud API precisa ser desregistrado; depois da desconexão, a Meta avisa que ele pode levar até 3 minutos para ficar livre. Se estiver ligado a outro parceiro de coexistência, a desconexão é feita no app, com espera de 15 minutos.
Uma conta do WhatsApp Business que usa a API de mensagens de marketing também não serve para esse fluxo. Os códigos e as soluções oficiais de cada caso estão reunidos no guia de erros da coexistência do WhatsApp.
Como Migrar API Não Oficial para Coexistência: Passo a Passo
Para migrar da API não oficial para a coexistência, a empresa conecta o WhatsApp Business App à Cloud API pelo cadastro incorporado (Embedded Signup) de um parceiro da Meta. O processo acontece no navegador e no celular, em poucos passos.
Escolher o Parceiro Que Faz a Conexão
A conexão é feita por um Solution Partner ou por um Tech Provider, que oferece o cadastro incorporado dentro da própria plataforma. A Meta exige que esse parceiro já use a Cloud API e tenha webhooks para receber os eventos da conta.
Vale confirmar se o parceiro já usa a versão 4 do cadastro incorporado: segundo a Meta, a versão 2 será descontinuada em 15/10/2026. Também convém perguntar como ele recebe as mensagens enviadas pelo app e como avisa quedas de conexão.
Os Passos no Cadastro e no App
Na documentação da Meta consultada em outubro de 2026, o fluxo de quem já usa o WhatsApp Business App segue esta ordem, com pequenas variações conforme a versão usada pelo parceiro:
- Entrar com a conta do Facebook e escolher ou criar o portfólio empresarial.
- Escolher a opção de conectar a conta existente do WhatsApp Business App.
- Informar o número que está no app.
- Confirmar a conexão pelo app, com código ou QR code, conforme a versão do fluxo.
- Decidir, no app, se o histórico de conversas será compartilhado.
- Concluir o cadastro e manter o app aberto durante a sincronização.
Na versão atual, a confirmação chega no app como mensagem da conta oficial “Facebook Business”, com os botões para conectar à plataforma comercial. Nenhuma etapa pede para apagar a conta do app, e é isso que mantém o número.
Como Confirmar Que a Conexão Funcionou
Ao fim do processo, o WhatsApp Business App atualiza sozinho e mostra que o número está conectado à API. Do lado técnico, o parceiro confere na API se o número aparece ao mesmo tempo no app e na Cloud API.
O teste final é simples: uma mensagem enviada de outro celular precisa aparecer no app e na plataforma, e uma resposta dada pelo app precisa ser vista na plataforma. Só depois disso a automação nova deve ser ligada.
Contatos, Histórico e Automações Antigas: o Que Fazer
Contatos e conversas individuais podem ir para a plataforma oficial; automações, listas e disparos da ferramenta antiga não migram e precisam ser refeitos. Separar esses dois grupos é o centro do planejamento da migração com o mesmo número.
Contatos e Histórico de Conversas
A coexistência pode sincronizar os contatos com WhatsApp e, se a empresa autorizar, as conversas individuais dos últimos seis meses. Grupos ficam de fora, e as mídias só chegam completas quando foram enviadas nos 14 dias anteriores à conexão.
O parceiro tem 24 horas para fazer essa sincronização, que só pode ser pedida uma vez. Exportar da ferramenta antiga o que for útil antes do corte, como etiquetas e anotações, evita perder dados que a Meta não sincroniza.
Automações, Listas e Grupos
Fluxos de chatbot, respostas automáticas e envios em lote da ferramenta não oficial não são transferidos para a API. Cada um ganha um destino novo dentro da API oficial, como resume a tabela a seguir.
| Recurso usado antes da migração | Destino depois da migração para a coexistência |
|---|---|
| Chatbot ou fluxo automático | Agente ou fluxo ligado à Cloud API pela plataforma do parceiro |
| Disparos em massa | Templates aprovados, enviados pela API só para contatos com opt-in |
| Listas de transmissão do app | Ficam só para leitura; o envio em volume passa a ser por template |
| Automação em grupos | Não migra: os grupos seguem no app, sem Groups API na coexistência |
| Saudação e ausência do app | Continuam no app; convém revisar para não responder junto com o agente |
| Etiquetas e respostas rápidas | Continuam no app, sem integração com a API |
Os grupos pedem atenção: a Groups API da Cloud API não está disponível para números em coexistência. Já as mensagens automáticas do WhatsApp Business continuam ativas no app e podem disparar junto com o agente, gerando duas respostas.
Conversas Abertas no Dia da Troca
A janela de atendimento da API só abre quando o cliente escreve depois da conexão. Conversas recebidas antes dela só podem ser respondidas pela API com template, como explica o guia da janela de 24 horas do WhatsApp.
A saída mais simples é responder pelo próprio app, que não segue a janela de 24 horas. As mensagens enviadas pelo app continuam gratuitas e não abrem, estendem nem afetam as janelas e a cobrança da Cloud API.
Opt-in e Templates para Voltar a Disparar
Depois da migração, os disparos só voltam com opt-in registrado e templates aprovados pela Meta. É a mudança que mais pesa para quem enviava mensagens em lote pela ferramenta não oficial, sem nenhuma revisão prévia do conteúdo.
Contato Sincronizado Não É Opt-in
O guia oficial de opt-in da Meta exige permissão antes de qualquer mensagem. A pessoa precisa ter informado o número e aceitado receber mensagens daquela empresa, que deve ser identificada pelo nome de forma clara.
Por isso, uma lista importada ou sincronizada não equivale a uma base com consentimento. O guia de opt-in no WhatsApp mostra como registrar a permissão, e o de prospecção pelo WhatsApp explica o que vale para contatos novos.
Os Primeiros Templates Aprovados
Templates são modelos de mensagem classificados como marketing, utilidade ou autenticação. Segundo a documentação de templates da Meta, eles só podem ser enviados com o status aprovado, e a revisão pode levar até 24 horas.
Vale criar os modelos antes do dia D, começando pelos transacionais. O guia de template no WhatsApp explica cada categoria, e o kit de templates para WhatsApp traz modelos prontos para adaptar à operação.
Retomar o Volume aos Poucos
Os limites de mensagens começam em 250 usuários únicos a cada 24 horas e sobem em etapas para 2.000, 10.000, 100.000 e ilimitado. Empresas que entram pelo cadastro incorporado começam com os limites padrão.
Subir o volume aos poucos ajuda a proteger a nota de qualidade, explicada no guia de nota de qualidade do WhatsApp. O passo a passo de campanhas está no artigo de disparo em massa pela API oficial, com segmentação e descadastro.
Checklist de Corte: o Dia D da Migração
O dia D da migração é o momento em que a ferramenta não oficial é desligada e o número passa a operar pela API oficial na coexistência. Um checklist em três tempos reduz o período em que o atendimento fica sem cobertura.
Na Véspera
- Atualizar o WhatsApp Business App no celular principal.
- Exportar contatos, etiquetas e anotações da ferramenta antiga.
- Revisar a base e separar quem tem opt-in registrado.
- Enviar os primeiros templates para aprovação.
- Avisar a equipe sobre o horário da troca.
Escolher um horário de pouco movimento ajuda. O celular que ficará como aparelho principal deve ser definido nessa etapa, de preferência um aparelho que a equipe use todos os dias, e não um celular guardado na gaveta.
No Dia D
- Pausar fluxos e disparos da ferramenta não oficial.
- Encerrar a sessão dela em dispositivos conectados.
- Conectar o número pelo cadastro incorporado do parceiro.
- Manter o app aberto durante a sincronização.
- Testar mensagens nos dois sentidos.
- Ligar o agente e as regras de atendimento.
Responder pelo app as conversas que chegaram antes da conexão evita clientes sem retorno. Se algo falhar, os códigos de erro do fluxo indicam a causa antes de qualquer nova tentativa de conexão.
Na Primeira Semana
- Abrir o app no celular principal com regularidade.
- Conferir se as mensagens do app aparecem na plataforma.
- Acompanhar a aprovação dos templates e a nota de qualidade.
- Ajustar as respostas do agente com base nas conversas reais.
A conexão cai quando o celular principal fica cerca de 14 dias inativo, segundo a referência do evento account_update. O checklist de migração para a API oficial, em PDF, ajuda a organizar as etapas com a equipe.
Quando a Cloud API com Número Dedicado Faz Mais Sentido
A Cloud API com número dedicado faz mais sentido quando a operação precisa de mais velocidade, de recursos que a coexistência não oferece ou de um atendimento que não dependa do celular. Nesse modelo, o número fica só na API.
Sinais de Que a Coexistência Não Basta
- Disparos que precisam de mais de 20 mensagens por segundo; a Cloud API pura começa em 80 e pode chegar a 1.000 quando o número é elegível.
- Necessidade de grupos ou chamadas pela API, que não funcionam com o número em coexistência.
- Equipe que atende só pela plataforma, sem ninguém usando o celular principal.
- Vontade de separar o número das campanhas do número de atendimento.
O comparativo coexistência ou Cloud API detalha a escolha critério a critério, e o guia da WhatsApp Cloud API explica como começar com um número dedicado. Os dois caminhos são API oficial; muda onde o número vive.
Número Banido ou Sem Elegibilidade
Se o número foi banido na ferramenta antiga, o primeiro passo é o pedido de análise ao WhatsApp, e não a migração. Sem a conta liberada, não há número ativo no app para conectar, e o caminho passa a ser um número novo.
Já um número recusado por falta de elegibilidade pode ganhar mais uso no app e tentar de novo depois. Quando o prazo pesa, um número novo direto na Cloud API tende a ser o caminho mais rápido para a operação.
Trocar a API Não Oficial pela Oficial com Agentes de IA
Trocar a API não oficial pela oficial não significa abrir mão da automação: o agente de IA passa a responder pela Cloud API, dentro das regras da Meta. Na coexistência, ele divide o mesmo número com quem atende pelo app.
Agente de IA e Equipe no Mesmo Número
Cada mensagem enviada pelo app gera um evento de eco para a plataforma. Com isso, a plataforma permite que o agente perceba quando um humano assumiu a conversa e pare de responder, evitando respostas duplicadas.
Um agente de IA integrado ao CRM consulta pedidos, agenda e cadastros antes de responder. O guia de atendimento humano e IA no WhatsApp mostra como dividir o trabalho, e o de múltiplos atendentes ajuda a organizar a equipe.
Como Começar pela API Oficial com a ConverZAP
A ConverZAP trabalha com a API oficial do WhatsApp: agentes de IA que executam ações, caixa de entrada com vários atendentes e disparos com templates aprovados, opt-in e descadastro, sem nenhuma automação fora das regras.
O ponto de partida é sair do que é não oficial com um plano; o tipo de conexão depende da operação. A página de planos da ConverZAP mostra recursos e preços; a calculadora de custo da API estima a conta da Meta.
Perguntas Frequentes sobre Migrar da API Não Oficial para a Coexistência
Não. A coexistência parte de um número registrado no WhatsApp Business App, e com o WhatsApp comum o fluxo retorna erro de número não registrado. Depois da conexão, registrar o número de novo no WhatsApp comum desfaz a ligação com a API.
Sim. O Brasil nunca apareceu na lista de países não suportados da documentação da Meta. Como existe um erro oficial para regiões indisponíveis, o parceiro confirma a elegibilidade do número no momento da conexão.
Mensagens enviadas pelo app continuam gratuitas; as da API seguem a tabela da Cloud API. A partir de 01/10/2026, a Meta cobra as mensagens de serviço e as de utilidade dentro da janela de 24 horas, com franquia de 1.000 mensagens de serviço por número a cada mês, segundo a página oficial de mensagens sem template. Os valores estão no guia WhatsApp vai cobrar?.
A Meta não publica um prazo total. A conexão é feita em poucos passos, a sincronização do histórico pode levar vários minutos com o app aberto, e a revisão de cada template pode levar até 24 horas.
A conexão com a API é desfeita e, no novo registro, o app oferece reconectar os produtos que estavam ligados. Se a opção for mantida, a reconexão automática acontece em poucos minutos, mas o histórico desse intervalo não é sincronizado.
Sim. A empresa desconecta pelo próprio app, em Configurações > Conta > Plataforma comercial. A API de desregistro não pode ser usada para números em coexistência, e uma nova conexão com outro parceiro exige esperar 15 minutos.
