Como identificar onde está o problema
Use esta página quando a conexão parar dentro da janela da Meta, antes de o número aparecer como conexão no painel. As imagens ajudam a comparar a sua tela com os cenários mais comuns.
Não repita o onboarding sem corrigir a causa
Permissões, bloqueios de segurança, portfólio empresarial, estado do número e limites de código são controlados pela Meta. Repetir o mesmo fluxo pode consumir novas tentativas sem resolver o problema.
A interface e as mensagens da Meta podem mudar com o tempo. Use o texto do erro e o estágio do processo como referência principal.
Se a janela da Meta concluiu e o erro apareceu depois, consulte Erros e diagnóstico ou Webhook: GET, POST e troca.
1. A janela não avança ou apresenta erro genérico
O que verificar
- Status da Meta: confirme se Embedded Signup, Cloud API, coexistência ou gerenciamento de WABA estão com incidente.
- Perfil correto: entre com o usuário que possui acesso administrativo ou controle total sobre o Business Portfolio, a WABA e os ativos usados.
- Navegador: permita pop-ups e cookies necessários para os domínios da Meta e desative temporariamente extensões que bloqueiam a janela.
- WhatsApp Business: em coexistência, mantenha o aplicativo atualizado no celular e o número ativo.
- Verificação em duas etapas: não desative por padrão. Ela é relevante principalmente em alguns processos de migração, transferência ou registro que solicitam o PIN. Ajuste somente quando a própria etapa ou o suporte indicar essa necessidade.
Teste limpo
Feche a janela da Meta, saia de contas Facebook que não serão usadas e repita em uma janela anônima ou em um perfil limpo do navegador, com pop-ups permitidos.
2. Código de verificação solicitado muitas vezes
Pare de clicar em reenviar. Códigos repetidos podem prolongar o bloqueio. Aguarde o período indicado pela Meta e use apenas o código mais recente quando a opção voltar a ficar disponível.
- confirme se o número e o DDI foram digitados corretamente;
- verifique se a linha recebe SMS ou chamada de voz;
- não alterne repetidamente entre SMS e ligação;
- não abra várias sessões de Embedded Signup ao mesmo tempo.
Prazo variável
Na prática, o desbloqueio pode levar algumas horas e, em certos casos, 24 ou 48 horas. Esse prazo é controlado pela Meta e não pode ser liberado pela HookCloud.
3. O número já está registrado no WhatsApp
A correção depende do resultado desejado:
| Objetivo | Caminho correto |
|---|---|
| Continuar usando o WhatsApp Business no celular | Escolha o fluxo de coexistência / conectar o app WhatsApp Business existente, quando o número estiver elegível. |
| Usar somente a Cloud API | Siga a opção de migração ou desconexão indicada pela Meta e confirme o impacto sobre o app atual antes de continuar. |
| Número já ligado a outro provedor de API | Faça a migração ou liberação pelo provedor/Business Portfolio atual; não tente cadastrá-lo como número novo. |
Não exclua a conta às cegas
Excluir o WhatsApp ou remover o número sem entender o fluxo pode afetar histórico, disponibilidade e elegibilidade. Primeiro identifique se o caso é coexistência, migração ou troca de provedor.
4. Número associado a outro Business Portfolio
- Volte à seleção do Business Portfolio e confirme se escolheu a empresa que realmente possui o número.
- Abra o WhatsApp Manager da empresa atual e identifique a WABA e o Phone Number ID existentes.
- Se o número precisa mudar de empresa, use o procedimento de liberação, migração ou transferência adequado.
- Se você não tem acesso à empresa atual, solicite acesso ao administrador responsável ou abra um atendimento com a Meta.
Evite criar outra BM para “testar”
Criar vários portfólios e tentar o mesmo número em todos eles não remove o vínculo anterior e pode tornar o diagnóstico mais confuso.
5. Conta ou número restrito
Esse bloqueio normalmente precisa ser resolvido no ambiente da Meta. Repetir a conexão pela HookCloud não remove uma restrição existente.
- consulte Qualidade da conta / Business Support Home e o WhatsApp Manager;
- verifique pendências de política, verificação, pagamento, segurança ou revisão;
- envie recurso quando a Meta disponibilizar essa opção;
- se a restrição for definitiva, use outro número e outro ativo elegível.
Números virtuais não são automaticamente proibidos
A elegibilidade depende de controle do número, capacidade de receber o código e avaliação da Meta. Porém, linhas recicladas, sem controle real ou com histórico problemático podem apresentar mais restrições.
6. Número criado manualmente antes do Embedded Signup
Confirme no WhatsApp Manager se existe um registro incompleto, pendente ou antigo para o mesmo número.
- Se for um cadastro vazio e sem operação ativa, remova-o e aguarde alguns minutos antes de reiniciar o Embedded Signup.
- Se o número já estiver ativo em uma WABA ou provedor, não o remova como se fosse um cadastro vazio: use migração, transferência ou reconexão.
- Depois da correção, volte ao HookCloud Flow e faça uma nova conexão pela janela oficial.
Proteja a operação atual
Antes de remover qualquer registro, anote a WABA ID, o Phone Number ID, o Business ID e o provedor atual. Isso facilita a recuperação caso o número já esteja em produção.
7. Número novo ou não elegível para o fluxo escolhido
Não existe um prazo universal garantido de “aquecimento”. Um número novo pode funcionar quando está sob seu controle, recebe SMS ou ligação e é aceito pela Meta. Em coexistência, porém, o histórico legítimo no WhatsApp Business e a elegibilidade do aplicativo podem influenciar a opção exibida.
- mantenha o WhatsApp Business atualizado e use o número de forma comercial legítima;
- confirme que o número recebe o código de verificação;
- aguarde e tente novamente se a Meta informar indisponibilidade temporária;
- use outro número elegível quando o bloqueio persistir.
Não “aqueça” com spam
Não faça disparos artificiais nem crie atividade sem consentimento para tentar alterar a elegibilidade. Isso pode piorar a reputação e gerar restrições.
8. Código 1690114: limite de criação de negócios
Quando a própria janela da Meta exibe o código 1690114 acompanhado de mensagem sobre limite de criação de negócios, a etapa foi bloqueada por um limite temporário ou de elegibilidade na infraestrutura da Meta. Isso não indica, por si só, falha no painel do HookCloud.
- interrompa novas tentativas em sequência; repetir o fluxo não remove o limite;
- não crie portfólios, WABAs ou contas duplicadas para contornar a mensagem;
- se a janela permitir, selecione um Business Portfolio existente, correto e já autorizado;
- confira no Gerenciador de Negócios a verificação da empresa, a Qualidade da Conta, as permissões administrativas e eventuais avisos;
- se a mensagem indicar limite temporário, aguarde o período informado pela Meta antes de tentar novamente;
- guarde o print completo, o horário em Brasília, o Business ID selecionado e o código exibido.
Não existe prazo universal garantido
O cooldown e a elegibilidade são definidos pela Meta. A HookCloud não consegue aumentar o limite nem remover a restrição. Se não houver prazo na tela e o erro persistir, use o canal de suporte da Meta associado ao Business Portfolio e envie também o diagnóstico sanitizado ao suporte HookCloud.
Diagnóstico rápido
| O que aparece | Causa mais provável | Próxima ação segura |
|---|---|---|
| Janela não abre ou não avança | Status da Meta, pop-up, cookies, extensão, perfil administrador | Corrigir o ambiente e reabrir uma única vez |
| Código bloqueado | Quantidade de solicitações e canal SMS/voz | Parar as tentativas e aguardar o cooldown |
| Número ativo no aplicativo | Modo escolhido: coexistência ou Cloud API exclusiva | Selecionar o fluxo compatível |
| Número em outro portfólio | Business Portfolio, WABA e owner atuais | Selecionar ou transferir o ativo com autorização |
| Número restrito | Qualidade da Conta, política, verificação e cobrança | Resolver a pendência diretamente na Meta |
| Número não qualificado | Histórico legítimo de uso e elegibilidade | Aguardar e tentar depois ou usar outro número |
| Código 1690114 | Limite de criação de negócios/portfólios informado pela Meta | Parar as tentativas, usar ativo existente quando permitido e aguardar/orientar recurso na Meta |
O que enviar ao suporte
- print completo da etapa e da mensagem da Meta;
- e-mail do owner da conta HookCloud;
- nome e Business ID do portfólio selecionado;
- WABA ID ou Phone Number ID, quando já existirem;
- horário aproximado da tentativa;
- informação sobre o modo desejado: coexistência, Cloud API ou migração.
Não envie código recebido por SMS/ligação, PIN, senha, token ou App Secret.
A conexão ainda não avançou?
Corrija primeiro a causa mostrada nesta página. Depois, faça apenas uma nova tentativa. Se persistir, envie os dados de diagnóstico para suporte@hookcloud.app.