Erros do cadastro incorporado
Erros que podem aparecer durante o cadastro incorporado (embedded signup) da Meta — da criação do portfólio e da conta do WhatsApp Business à adição e verificação do número.
Ao conectar um número pela API Oficial, você passa pelo cadastro incorporado (embedded signup) da Meta: uma sequência de telas em que você seleciona ou cria o portfólio empresarial, cria a conta do WhatsApp Business (WABA), adiciona o número e o verifica. Esta página reúne os erros que podem aparecer em cada etapa, com o que significam e como agir.
A maioria destes erros vem de restrições aplicadas diretamente pela Meta, e não da plataforma. Nesses casos, não há como a plataforma remover o bloqueio — as orientações abaixo ajudam a contornar, corrigir os dados ou aguardar a liberação.
As mensagens aparecem no idioma da sua conta Meta (em português, na maioria dos casos). Os textos abaixo estão traduzidos — a redação exata pode variar um pouco.
Erros na criação da conta empresarial (Business Manager)
| Mensagem | O que significa e como resolver |
|---|---|
| A Meta exige a verificação da empresa antes de liberar o acesso à API do WhatsApp. | Conclua a verificação do portfólio no Meta Business Suite → Central de Segurança. |
| Conta empresarial não encontrada. | Confirme se o ID da conta empresarial está correto nas configurações da Meta. |
| Você não tem permissões de administrador. | Entre com uma conta que tenha o cargo de Administrador no portfólio. |
| Esta empresa já está vinculada a outra conta do WhatsApp Business. | Use a conta do WhatsApp Business (WABA) existente ou crie uma nova conta empresarial. |
| Dados da empresa inválidos. | Preencha corretamente todos os campos obrigatórios. |
| A criação da conta empresarial foi bloqueada. | Contate o suporte da Meta ou use uma conta empresarial já existente. |
| Você criou contas empresariais demais. | Use outra conta ou solicite acesso a uma conta existente. |
| Erro ao vincular a conta empresarial ao WhatsApp. | Tente novamente após alguns instantes, confira a conta empresarial ou contate o suporte da Meta. |
| A conta empresarial está em estado restrito. | Revise as políticas da Meta, conclua a verificação e, se necessário, envie um recurso pela Página inicial de suporte. |
| Sua conta do Facebook é muito recente para criar uma conta empresarial. Tente novamente em uma hora. | Use uma conta do Facebook ativa ou aguarde algumas horas — a conta nova pode ser usada normalmente nesse período. |
| Um usuário só pode criar uma conta empresarial por vez. | Use uma conta empresarial já existente para fazer o onboarding. |
| O nome escolhido para sua empresa não é válido. | Use um nome válido, que corresponda ao nome real da empresa. |
| Autenticação em duas etapas não ativada. | Ative a autenticação em duas etapas nas configurações de segurança do Facebook. |
| Tentativas de login ou verificação demais. | Aguarde de 24 a 48 horas e tente novamente em outro dispositivo ou rede. |
| Número banido ou sinalizado. | Solicite uma revisão à Meta ou use um novo número. |
| Reprovação por não conformidade com a política comercial. | Verifique a lista de categorias restritas e envie um recurso se achar que foi um engano. |
Erros na criação da conta do WhatsApp Business (WABA)
| Mensagem | O que significa e como resolver |
|---|---|
| Não foi possível criar a conta do WhatsApp Business. | Confira a verificação da conta empresarial, tente novamente em 15 a 30 minutos e verifique a conformidade com as políticas. |
| É necessário concluir a verificação da conta empresarial. | Conclua a verificação na Central de Segurança antes de tentar de novo. |
| A criação da WABA foi bloqueada. | Verifique restrições na conta empresarial e solicite uma revisão à Meta. |
| Esta empresa já possui uma conta do WhatsApp Business. | Use a WABA existente ou crie uma nova conta empresarial. |
| O usuário não tem permissão para criar a conta do WhatsApp Business. | Entre como Administrador ou solicite acesso de Administrador. |
| A conta do WhatsApp Business está restrita. | Revise as políticas e envie um recurso, ou crie uma WABA em conformidade. |
| Falha na configuração da WABA. | Tente novamente após alguns instantes e verifique se alguma etapa ficou incompleta. |
| Esta conta empresarial não pode criar uma conta do WhatsApp Business. | Contate o suporte da Meta ou use outra conta empresarial já verificada. |
Erros na adição do número
| Mensagem | O que significa e como resolver |
|---|---|
| O número foi bloqueado. | Veja os alertas na Visão geral do WhatsApp Manager e siga as instruções da página de suporte. Se acreditar que foi um erro, contate o suporte. |
| Você já vinculou o número máximo de telefones permitido para esta conta empresarial. | Exclua um número existente para continuar ou solicite números adicionais. |
| O número está vinculado ao WhatsApp pessoal ou a outra conta empresarial. | Desconecte-o da conta atual, aguarde cerca de 3 minutos e digite o número novamente. |
| Este número está registrado em uma conta do WhatsApp existente. | Cancele o registro do número para usá-lo aqui ou registre um novo número. |
| O nome verificado viola as diretrizes do WhatsApp. | Edite o nome conforme as diretrizes de nome de exibição e tente novamente. |
| O formato do número é inválido. | Inclua o código do país e remova espaços e caracteres especiais. |
| Este número não pode ser usado no WhatsApp Business. | Envie um recurso ao suporte do WhatsApp com documentação ou use um novo número. |
| O WhatsApp Business não está disponível no seu país. | Use um número de um país compatível ou uma ferramenta alternativa. |
| Algo deu errado. | Contate o suporte e reinsira o nome do perfil comercial conforme as diretrizes, conferindo os demais dados. |
Erros na verificação do número
| Mensagem | O que significa e como resolver |
|---|---|
| Não foi possível enviar o código de verificação para este número. | Tente a verificação por ligação, use um número de celular e aguarde 15 minutos antes de tentar de novo. |
| O código de verificação expirou. | Solicite um novo código e digite-o em até 3 minutos. |
| A propriedade do número já foi verificada. | Nenhuma ação necessária — este número já foi verificado. |
| Não foi possível verificar o código. | Tente novamente após o período de espera. |
| Seu número não parece ser válido. Confira novamente ou tente após 5 minutos. | Confirme que o número é operacional e verificado por uma operadora. Números de URA (IVR) não são suportados. |
| Houve um erro ao verificar este número. | Tente novamente mais tarde. |
| Você errou o código vezes demais. | Aguarde cerca de 12 horas antes de tentar de novo; depois, retome o fluxo e selecione as contas e números existentes para verificar. |
| Você solicitou o código vezes demais. | Aguarde o tempo indicado e retome o fluxo para solicitar um novo código. |
| Tentativas demais. Tente novamente mais tarde. | Aguarde cerca de 24 horas, tente em outra rede ou contate o suporte do WhatsApp. |
Precisa de ajuda?
Acessar a página de suporte
Onde verificar restrições no portfólio, na conta de anúncios e no WhatsApp.
Solicitar revisão de banimento
O que fazer quando a conta é bloqueada ou banida e como pedir revisão.
Verificar o portfólio empresarial
Conclua a verificação da empresa para liberar limites e criar novas contas.
Códigos de erros da Meta
Erros que aparecem ao enviar mensagens, depois que o número já está conectado.
Códigos de erros da Meta
Referência dos códigos de erro retornados pela API da Meta ao usar o WhatsApp — causas prováveis e como agir em cada caso.
Solicitar revisão de banimento
O que fazer quando a conta de WhatsApp da API Oficial é bloqueada ou banida e como solicitar uma revisão diretamente na Meta.