Para conectar um número à API Oficial do WhatsApp dentro da Clint utilizando o modo de Coexistência (Coex), alguns pré-requisitos técnicos e configurações precisam estar corretamente ajustados.
⚠️ Este artigo se aplica exclusivamente para casos em que o número será conectado em modo de coexistência na Clint.
O que pode impedir a conexão?
A falha na conexão pode acontecer por diferentes motivos. Abaixo estão os mais comuns:
Coexistência já está ativa em outra plataforma: Se o número já está em uso simultâneo no WhatsApp Business App e em outra API, podem existir limitações para conexão ou migração entre WABAs.
Forma de pagamento ou linha de crédito vinculada à WABA: Se a conta do WhatsApp (WABA) já possui uma forma de pagamento ou linha de crédito vinculada, isso pode impedir a conexão com a Clint.
Como seguir?
Se você se encaixa em um dos cenários acima, existem três caminhos possíveis:
Opção 1 - Migrar o número para outro portfólio na Meta
Esta opção mantém o seu número atual. Você remove a WABA do portfólio atual e a vincula a outro portfólio que não tenha forma de pagamento configurada.
Com isso, a Clint consegue realizar a vinculação à linha de crédito e concluir a conexão.
📌 Quando faz sentido:
Você quer manter o número que já usa
Você já possui outro portfólio na Meta sem forma de pagamento vinculada
Passo a passo para migrar o número para outro portfólio na Meta:
1) Coloque o número offline no WhatsApp Business App
Antes de remover a WABA do portfólio, o número precisa estar offline.
No WhatsApp Business App:
Acesse Configurações > Conta > Plataforma do WhatsApp Business
Selecione a plataforma que o número está conectado e clique em Desconectar
⚠️ Atenção: Não desinstale o app. Apenas certifique-se de que ele não está em uso no momento.
2) Acesse o Meta Business Suite e localize sua WABA
Acesse business.facebook.com
No menu lateral, vá em Configurações > Contas > Contas do WhatsApp Business
Clique na WABA do número que deseja migrar
3) Remova a WABA do portfólio atual
Dentro da WABA, clique no ícone de três pontos (⋯) no canto superior
direito e selecione "Remover do portfólio empresarial".
⚠️ Atenção: Esta ação remove a WABA do portfólio atual, mas não exclui a conta nem o número. Nenhuma conversa ou template será perdido.
4) Acesse o portfólio de destino e vincule a WABA
Ainda no Meta Business Suite, troque para o portfólio que receberá
a WABA (use o seletor de contas no topo da página)
Vá em Configurações > Contas > Contas do WhatsApp Business
Clique em + Adicionar e selecione "Vincular uma conta do WhatsApp Business"
Siga as instruções da Meta para concluir a vinculação.
⚠️ Atenção: Certifique-se de que o portfólio de destino não possui forma de pagamento vinculada. Caso contrário, o bloqueio se repetirá.
5) Retorne a Clint para concluir a conexão
Com a WABA no novo portfólio, realize novamente a conexão na Clint.
Opção 2 - Conectar um número diferente
Esta é a opção mais rápida. Em vez de ajustar a configuração atual, você
conecta um número de telefone que não tenha forma de pagamento vinculada à WABA nem Co-Ex ativo.
📌 Quando faz sentido:
Você tem flexibilidade para usar outro número na operação
Quer iniciar o uso da API Oficial o quanto antes
Passo a passo para conectar um número diferente:
1) Escolha o número que será conectado
O número precisa atender a um dos critérios abaixo:
Nunca foi registrado em nenhuma WABA anteriormente
Está registrado em uma WABA sem forma de pagamento direta e sem Co-Ex ativo
⚠️ Atenção: Se o número escolhido ainda não estiver ativo no WhatsApp Business App, será necessário realizar a configuração inicial do número.
2) Garanta acesso ao número para verificação
Durante o processo, você precisará receber um código de verificação por
SMS ou ligação. Certifique-se de ter acesso ao número no momento
da conexão.
3) Inicie a conexão pelo painel da Clint
Acesse Configurações > Canais > WhatsApp API Oficial
Clique em Adicionar número
Siga o fluxo de Embedded Signup, você será direcionado para
autenticação na Meta.
4) Complete o Embedded Signup
Durante o Embedded Signup você irá:
Fazer login no Facebook com a conta administradora do portfólio
Selecionar ou criar a WABA onde o número será registrado
Inserir o número de telefone
Verificar com o código recebido por SMS ou ligação
5) Aguarde a ativação
Após o Embedded Signup, a Clint realiza automaticamente a vinculação à
linha de crédito. A ativação costuma ser imediata, mas pode levar alguns minutos.
Opção 3 - Converter para API Oficial e reconectar o número atual
Esta opção remove o modo de coexistência, convertendo o número para
API Oficial exclusiva. Com isso, a restrição de migração entre WABAs
é eliminada e o processo de conexão pode ser refeito corretamente.
📌 Quando faz sentido:
Você quer manter o número atual
Está disposto a descontinuar o uso do WhatsApp Business App neste número
⚠️ Atenção: Após a conversão, não será mais possível usar o WhatsApp Business App com este número. Todo o gerenciamento de mensagens passará a ser feito exclusivamente pela Clint.
O que muda com a remoção do Co-Ex?
No modo Co-Ex, o número funciona tanto no WhatsApp Business App quanto
na API ao mesmo tempo. Ao remover o Co-Ex, o número passa a operar
somente via API.
Passo a passo para converter para API Oficial e reconectar o número atual:
1) Faça backup das suas conversas (opcional)
Se quiser preservar o histórico do WhatsApp Business App antes de prosseguir:
No app, acesse Configurações > Conversas > Backup de conversas
Salve no Google Drive ou armazenamento local.
2) Exclua sua conta no WhatsApp Business App
No app, acesse Configurações > Conta > Apagar minha conta
Confirme a exclusão
🚨 Importante: este passo remove a conta do WhatsApp Business App para esse número.
Em geral, isso pode desvincular o número do app, exigir um novo processo de verificação e interromper o recebimento/envio de mensagens pelo aplicativo.
Após a exclusão, o acesso ao histórico no app pode ficar indisponível neste número.
⚠️ Atenção: Evite conflitos.
Depois que o Co-Ex for removido e o número operar somente via API:
Não mantenha o WhatsApp Business App ativo com o mesmo número
Não tente verificar/reativar esse número no app
Se o app continuar instalado e configurado com o mesmo número, podem ocorrer conflitos de sessão/verificação que atrapalham a reconexão pela Clint.
3) Inicie a reconexão pelo painel da Clint
Com o Co-Ex removido, o processo pode ser refeito normalmente:
Acesse Configurações > Canais > WhatsApp API Oficial
Clique em Adicionar número e siga o fluxo de Embedded Signup.
Utilize o mesmo número de telefone.
4) Aguarde a vinculação
Após o Embedded Signup, a Clint realiza automaticamente a vinculação à
linha de crédito.
Comparativo das opções
| Opção 1 | Opção 2 | Opção 3 |
Mantém o número atual | ✅ Sim | ❌ Não | ✅ Sim |
Mantém o WhatsApp Business App | ✅ Sim | ✅ Sim (em outro número) | ❌ Não |
Velocidade | Média | Rápida | Média |
Requer outro portfólio na Meta | ✅ Sim | ❌ Não | ❌ Não |
Ainda com dúvidas?
Se não souber qual opção se aplica melhor ao seu caso, entre em contato com o suporte da Clint.
Nossa equipe irá avaliar a situação e indicar o caminho mais adequado para a sua operação.