Erros comuns no Embedded Signup da Meta

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.

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. Um erro exibido durante o cadastro pode ter causa na Meta, nas permissões do usuário, no navegador ou na integração HookCloud; a localização visual, sozinha, não confirma a responsabilidade.

A HookCloud presta suporte primário à integração, investiga também seus próprios componentes e encaminha questões não resolvíveis internamente aos canais aplicáveis da Meta, quando cabível. O assinante participa das verificações sob seu controle. Esse encaminhamento não garante deferimento nem prazo de solução externa.

Banimento ou restrição de número, WABA, portfólio empresarial e perfil são situações distintas. Confirme qual ativo foi afetado antes de concluir que toda a conta ou todos os números estão bloqueados. RED é uma classificação de qualidade baixa, não sinônimo de banimento.

Consulte a matriz de responsabilidades e os Termos de Serviço.

Se a janela da Meta concluiu e o erro apareceu depois, consulte Erros e diagnóstico ou Webhook: GET, POST e troca.

O seletor mudou? Consulte a imagem atual de referência e a tabela de opções. “Registrado” na Meta não significa conexão concluída no Flow; “Não qualificado” não confirma banimento.

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, confira se o número está no Business App, mantenha o aplicativo atualizado e o número ativo. Essa é uma verificação geral de compatibilidade; não identifica a causa de um código específico como 4563039.
• 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.

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.

3. O número já está registrado no WhatsApp

A correção depende do resultado desejado:

4. Número associado a outro Business Portfolio

1. Volte à seleção do Business Portfolio e confirme se escolheu a empresa que realmente possui o número.
2. Abra o WhatsApp Manager da empresa atual e identifique a WABA e o Phone Number ID existentes.
3. Se o número precisa mudar de empresa, use o procedimento de liberação, migração ou transferência adequado.
4. Se você não tem acesso à empresa atual, solicite acesso ao administrador responsável ou abra um atendimento com a Meta.

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;
• não use outro número ou portfólio para contornar uma restrição. Qualquer alternativa deve ser elegível e permitida pelas políticas da Meta, após a análise do caso.

6. Número criado manualmente antes do Embedded Signup

Um cadastro anterior pode estar pendente, pertencer a outro fluxo ou já sustentar uma operação válida. A existência desse cadastro, sozinha, não justifica apagá-lo.

1. Confira no WhatsApp Manager a WABA, o Phone Number ID, o provedor e o estado atual.
2. Se a Meta disser que o número já está na lista, volte ao fluxo e selecione o existente quando disponível.
3. Se estiver ativo em outro provedor, revise migração ou reconexão. Se o objetivo for manter o Business App, revise coexistência.
4. Se não aparecer, confira identidade, portfólio e permissões antes de criar qualquer substituto.

A Meta informa que WABAs originalmente criadas pelo developer app não são selecionáveis diretamente no Embedded Signup. Isso não permite concluir que todo número ausente é um número de teste. Fonte: limitações oficiais do Embedded Signup.

7. Número novo ou não qualificado para o fluxo

Se a seleção mostra apenas o rótulo “Não qualificado”, abra o roteiro completo com imagem e verificações. O aviso, sozinho, não comprova falta de atividade.

O texto “Não qualificado” não informa, sozinho, se a causa é região, versão do aplicativo, vínculo empresarial, modalidade ou outra avaliação da Meta. Abra o detalhe do erro e identifique o código antes de agir.

• Para coexistência, confirme que o telefone está no WhatsApp Business e que o aplicativo está atualizado.
• Quando o erro indicar indisponibilidade regional, siga a orientação específica da Meta; atualizar o aplicativo não elimina essa condição.
• Se a Meta pedir mais atividade no Business App, mantenha uso comercial legítimo. Não existe prazo universal garantido de “aquecimento”.
• Para número próprio que exige código, confira titularidade, DDI e recepção de SMS ou ligação. O número virtual fornecido pela Meta tem condições próprias.

Veja os erros oficiais de coexistência e os requisitos de números próprios.

“Não qualificado”: como verificar o motivo

Esse rótulo indica que a Meta não disponibilizou o número para aquela escolha, naquele momento. Ele não revela a causa específica. O nome exibido, o prefixo do telefone e a aparência da tela não bastam para diagnosticar o impedimento.

Use este roteiro: confira a mensagem e os ativos, identifique a situação documentada e, se o telefone começar com +1 555, confirme a modalidade do número.

1. Confira a mensagem, o número e o fluxo

1. Leia os detalhes disponíveis na janela. Se houver explicação, aviso ou código ao tentar selecionar a linha, registre o texto exato e a etapa. Nem toda tela apresenta um código; não atribua um por semelhança com outra imagem.
2. Confira o ativo no WhatsApp Manager. Compare o telefone completo, o Phone Number ID e a WABA — a conta do WhatsApp Business — quando esses IDs estiverem disponíveis. Confirme também o portfólio e a identidade usados no login Meta.
3. Identifique a operação desejada. Manter o WhatsApp Business no celular por coexistência, cadastrar um número na Cloud API e migrar de outro provedor são caminhos diferentes. Verifique o vínculo atual e a conta de destino antes de qualquer mudança.
4. Consulte os avisos da conta. No Business Support Home, selecione a empresa e a conta WhatsApp corretas. Confira também se o perfil possui o acesso necessário no Meta Business Suite.
5. Se a causa continuar ausente, preserve a operação. Envie ao chat privado da HookCloud a etapa, a mensagem, o horário e os IDs disponíveis para análise. O suporte pode orientar a conferência; não pode garantir elegibilidade nem reversão de uma decisão da Meta. Não envie tokens, senhas, PIN ou códigos de verificação.

A seleção de ativos e as etapas podem variar conforme o fluxo e os dados já preenchidos. Fonte: Meta — telas do Embedded Signup.

2. Situações documentadas que devem ser confirmadas

A lista abaixo não identifica a causa de uma conta específica nem indica qual situação é mais frequente. Use-a somente para escolher a verificação que corresponde à mensagem recebida.

• Coexistência e atividade no Business App. Se a Meta apresentar o código 3441045, ela indica necessidade de mais atividade no WhatsApp Business para avaliar a elegibilidade. Mantenha uso comercial legítimo; não existe prazo garantido de “aquecimento” ou quantidade de mensagens que assegure liberação.
• Vínculo com empresa, WABA, parceiro ou outro fluxo. Confira a conta que possui o número e a modalidade atual. Um aviso sobre vínculo anterior ou troca de parceiro exige verificar o caminho de migração ou reconexão e seu impacto.
• Permissões ou restrições da conta. Confirme o acesso da identidade ao portfólio e à WABA. Uma restrição deve ser verificada no aviso da Meta; o rótulo isolado não confirma banimento.
• Aplicativo ou disponibilidade regional. No fluxo de coexistência, confira se o número usa o WhatsApp Business e se o aplicativo está atualizado. Quando a mensagem indicar indisponibilidade regional, atualizar o aplicativo não resolve essa condição.

As situações acima constam na referência oficial de erros da Meta. Consulte a tabela por código somente quando o código estiver realmente disponível.

3. +1 555: comercial, virtual ou de teste?

O prefixo +1 555, sozinho, não comprova que o número seja apenas de teste. A Meta documenta números comerciais 555, oferecidos conforme elegibilidade, com verificação automática, regras de qualidade e cobrança. O nome de exibição precisa ser aprovado antes do envio de mensagens.

Os números comerciais 555 não podem ser migrados para outra WABA nem usados fora da plataforma WhatsApp Business. Se a operação pretendida exige essa migração, essa limitação precisa ser considerada. Ela não permite concluir, apenas pela imagem, que a migração seja a causa do rótulo apresentado. Fonte: Meta — números comerciais 555.

A Meta também fornece um número de teste no início da configuração de desenvolvimento. Confirme no WhatsApp Manager ou em App Dashboard → WhatsApp → API Setup a origem e o tipo do ativo. A existência de um número de teste não torna todo número virtual um teste, e o texto “gratuito” na oferta não garante isenção de cobrança pelas mensagens. A oferta também não comprova, sozinha, que a conexão na HookCloud foi concluída. Fonte: Meta — números comerciais e número de teste.

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.

O significado documentado de 1690114 é atingir o limite de Businesses que a identidade pode criar naquele momento. Não é o limite de números contratado na HookCloud. Não exclua um negócio saudável para contornar a mensagem. Fonte: Meta — limites de criação de negócios.

Se a seleção de empresa não aparecer, siga a conferência de perfil, ativos e permissões.

Número existente ausente ou não selecionável

A ausência na lista, sozinha, não prova vínculo com outra empresa ou parceiro. A seleção e a digitação do telefone são caminhos possíveis; uma tela nova ou uma espera na janela também não comprovam erro da integração.

1. Confirme o perfil usado no login Meta e a empresa que possui o ativo. Acesso ao painel HookCloud não concede automaticamente acesso à WABA de outra empresa.
2. Abra o WhatsApp Manager e confira o telefone e a WABA exatos, inclusive quando há vários números semelhantes.
3. Verifique a modalidade desejada. Número no Business App, número na Cloud API e número em outro provedor não seguem necessariamente as mesmas telas.
4. Se aparecer uma lista elegível, selecione o telefone existente. Se o fluxo de coexistência pedir para informar e confirmar o telefone do aplicativo, siga essa etapa.
5. Para coexistência, confirme que o telefone está ativo no WhatsApp Business e que o aplicativo está atualizado. Isso não substitui a leitura de um erro específico nem garante elegibilidade.
6. Se uma etapa posterior pedir remoção ou desconexão, confira o vínculo mencionado antes de qualquer alteração. Se faltar acesso ao ativo, peça a permissão ao administrador responsável; não crie contas duplicadas nem desconecte uma operação saudável para testar.
7. Se o impedimento continuar após essas conferências, preserve a mensagem completa e o horário para uma análise específica. Na primeira tentativa, antes de concluir a autorização, pode ainda não existir uma conexão no painel HookCloud; isso não nega o erro exibido nem exige um Connection ID inexistente.

Fontes: seleção de ativos e confirmação do Business App.

4563039: aviso de acesso avançado do aplicativo

Quando a tela mostra 4563039 e informa que o aplicativo não tem o acesso avançado do WhatsApp Business necessário ao emparelhamento complementar, o fato confirmado é que a Meta recusou essa tentativa com essa mensagem. Preserve essa evidência. Outros onboardings concluídos não explicam a causa desta tentativa, e a ausência de um registro no painel não invalida o aviso.

É preciso distinguir o aplicativo da integração, o WhatsApp Business no celular e o acesso do perfil aos ativos da empresa. Na conexão oferecida pela HookCloud, você não precisa criar um App Meta próprio nem solicitar acesso avançado para o aplicativo da HookCloud. Essa configuração cabe ao provedor da integração.

Confira o perfil usado no login Meta, seus acessos à empresa e aos ativos e a modalidade pretendida. Manter o Business App atualizado é uma verificação de compatibilidade, não uma explicação comprovada nem uma solução garantida para 4563039. Não apague ou desconecte contas para tentar corrigir esse aviso.

Se essa mensagem persistir, a configuração e as permissões do aplicativo precisam ser conferidas pela equipe responsável pela integração. Envie ao suporte HookCloud somente o que ainda faltar: texto completo ou captura do erro, horário aproximado e etapa em que apareceu. O suporte deverá conferir a tentativa específica antes de atribuir a causa ao assinante, à HookCloud ou à Meta. Não envie tokens, senhas ou códigos de login.

A Meta documenta acesso avançado como requisito das permissões selecionadas na configuração. O código 4563039 não foi localizado na referência pública de erros consultada em 23/09/2026; por isso, esta seção descreve a mensagem observada, sem atribuir a ela uma causa adicional ou solução garantida. Requisitos oficiais da integração.

2494064: número já registrado no WhatsApp

Se a tela mostra 2494064 junto da mensagem de que o número já está registrado em uma conta do WhatsApp, ela informa um registro existente que impede continuar naquele passo. Isso não identifica, por si só, outra empresa, BM ou parceiro e não comprova banimento do telefone.

A referência oficial descreve essa mensagem entre os erros de configuração do telefone e considera registros no WhatsApp Messenger, no WhatsApp Business do celular ou na Business API. O texto foi localizado, mas o código numérico 2494064 não aparece associado a ele no catálogo público consultado em 23/09/2026. Não confunda essa mensagem com os códigos específicos de parceria ou plataforma na tabela de coexistência.

Se você quer manter o WhatsApp Business no celular em coexistência, não exclua a conta para testar. Confira o telefone informado, o perfil Meta e seus acessos, e confirme que a tentativa está seguindo o caminho de conexão do Business App. Uma opção chamada “Insira um novo número de telefone” não prova que o número esteja livre, nem transforma esse registro em migração ou coexistência garantida.

Se você já escolheu coexistência e a etapa seguinte pede desconexão, preserve a conta atual. A equipe responsável pela integração deve conferir o caminho e a elegibilidade dessa tentativa antes de orientar qualquer desligamento. A mensagem, sozinha, não demonstra que exista um parceiro a remover nem autoriza apagar o número ou a WABA. Uma migração exige confirmar o vínculo, o objetivo e o impacto antes de prosseguir.

O aviso de até 3 minutos se refere à atualização da disponibilidade depois de uma desconexão pertinente. Não é uma promessa de que apenas esperar resolva o problema, nem um prazo garantido para concluir a conexão. A espera de 15 minutos citada em outros erros de coexistência pertence a outra mensagem e não deve ser aplicada automaticamente a este caso. Referência oficial de erros da Meta.

A Meta pediu para remover ou desconectar

Leia a mensagem completa e confira qual vínculo ela menciona: empresa, parceiro, plataforma ou conta. “Remover” e “desconectar” não significam sempre a mesma operação. Uma orientação para desligar uma plataforma não é uma ordem para apagar o WhatsApp Business do celular.

Confirme o perfil e os acessos, o telefone correto e o modo de conexão escolhido. Um vínculo com outra empresa ou parceiro é uma hipótese até que a mensagem ou uma verificação autorizada o confirme. A ausência do número na lista não basta para esse diagnóstico.

Se o vínculo e o impacto no atendimento não estiverem claros, preserve a operação atual e peça a conferência antes de seguir. Não exclua o número, a WABA ou a conta do celular para testar. Não há promessa de migração, preservação de histórico ou liberação sem confirmar as condições do caso. Referência oficial de erros da Meta.

Use o código para escolher a próxima verificação

Estes códigos não devem ser deduzidos pelo rótulo “Não qualificado”. Use o código realmente exibido. Fonte: referência oficial de erros do Embedded Signup.

Diagnóstico rápido

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.