Nesta página você encontra:

• Erro ao ler QR Code no WhatsApp Business

• Número não é elegível por pouco tempo de uso

• Funcionalidade indisponível em determinados países

• Erro por integração anterior com WhatsApp Business API

• WhatsApp no Windows não exibe mensagens

• Meu nome de exibição foi rejeitado, porque motivo e o que fazer?

• Erro: "You've reached the maximum number of ad account allowed for your business"

• Outros erros comuns da Meta e soluções

Erro ao ler QR Code no WhatsApp Business

Durante a etapa de leitura do QR Code no processo de conexão com o WhatsApp Business API, podem ocorrer dois erros principais:

• Exibição da mensagem “QR Code inválido”.

• O sistema retorna automaticamente para a etapa anterior (geralmente a do PIN) sem explicação.

Esses problemas podem acontecer por diferentes fatores:

• Verificação em duas etapas: caso esteja habilitada, o sistema exigirá o PIN de seis dígitos. Se o PIN não for informado corretamente ou expirar, o processo será interrompido.

• Problemas de rede ou conexão: internet instável no celular principal ou no dispositivo que executa o Embedded Signup pode gerar falhas de sincronização.

• Sincronização do aplicativo: se o app WhatsApp Business estiver desatualizado, corrompido ou com processos em segundo plano ativos, o vínculo pode falhar. A Meta recomenda manter o app aberto durante o processo.

• Permissões ou conta: erros menos comuns relacionados ao Meta Business Manager ou à Página do Facebook associada podem afetar a conexão.

• Timeouts ou erros do sistema: chamadas de API podem falhar ou sofrer atrasos temporários nos servidores da Meta.

Como resolver

Número não é elegível por pouco tempo de uso

A Meta pode bloquear a coexistência de número no app e na API quando identifica pouco histórico de uso. Já houve casos com números ativos há apenas um mês.

Observação: a Meta não divulga critérios mínimos de elegibilidade.

Como resolver

Funcionalidade indisponível em determinados países

Em alguns países a integração com o WhatsApp Business API ainda não é permitida. Ao tentar usar um número de país inelegível, será exibida mensagem de indisponibilidade.

Utilize um número de país elegível

Erro por integração anterior com WhatsApp Business API

Se o número já foi integrado ao WhatsApp Business API em outro provedor, a Meta não permite nova conexão sem antes remover o vínculo anterior.

Como resolver

WhatsApp no Windows não exibe mensagens

Em alguns casos, conversas antigas deixam de aparecer no aplicativo para Windows, já que a Meta não oferece suporte de coexistência nessa versão.

Como resolver

Meu nome de exibição foi rejeitado, porque motivo e o que fazer?

Existem regras para nomes de exibição que são aceitos pela Meta, você pode verificar os motivos de rejeição neste link: Diretrizes para nomes de exibição na Plataforma do WhatsApp Business

Como resolver

Erro: "You've reached the maximum number of ad account allowed for your business"

Durante o processo de conexão de um número de telefone à API do WhatsApp Business, pode aparecer a seguinte mensagem:

You’ve reached the maximum number of ad account allowed for your business. In order to increase your ad account limit, make a payment, verify your business, continue using our platform in good standing, or delete an existing ad account.

Essa mensagem indica que o Business Manager (conta comercial Meta) atingiu o limite máximo de contas de anúncios (ad accounts) permitido.
Mesmo que o erro pareça relacionado a anúncios, ele bloqueia a criação automática dos ativos necessários para ativar o WhatsApp Business API.

Como verificar o limite atual e o status da empresa

Como resolver

Após resolver

Outros erros comuns da Meta e soluções

A seguir, listamos os principais códigos de erro retornados pelo WhatsApp Business API, com explicações e como resolver:

Código – MensagemDetalhamentoO que fazer#200 – You do not have the necessary permissionsO app não tem permissão para enviar em nome do WABA.Refaça o Embedded Signup garantindo acesso total no BM → WhatsApp Accounts.#10 – Application does not have permission for this actionO app não possui o escopo necessário.Reconecte o app ao WABA com permissões adequadas.#33 – The requested phone number has been deletedO número foi removido do WABA ou o phone_number_id está inválido.Verifique no WhatsApp Manager se o número está ativo.131010 – Phone number not registeredNúmero não registrado na plataforma.Cadastre o número no WABA correto.133015 – Please wait before registeringRemoção ainda em andamento.Aguarde alguns minutos/horas antes de tentar novamente.133000 – Incomplete deregistrationDesregistração pendente.Finalize a remoção antes de registrar novamente.131047 – Re-engagement requiredEnvio após 24h sem interação, permitido apenas via template.Reabra a conversa com template aprovado.131052 – Media download errorFalha ao baixar a mídia (link inválido/expirado).Verifique a disponibilidade do arquivo.131053 – Media upload errorErro ao enviar mídia.Valide formato e tamanho antes de reenviar.131051 – Unsupported message typeTipo de mensagem não suportado.Use tipos válidos (texto, imagem, template).131048 – Spam / rate-limitRestrição por baixa qualidade ou denúncias.Melhore opt-in e reduza disparos.130497 – Business restricted by countryRestrição de país.Use número elegível em país suportado.#368 – Temporarily blockedNúmero bloqueado por violação de política.Revise práticas e aguarde liberação.131031 – Account lockedConta bloqueada.Corrija pendências no BM.131057 – Account in maintenance modeConta em manutenção.Aguarde término ou acione suporte.#2 / 503 / 131016 – Service unavailableAPI temporariamente indisponível.Tente novamente mais tarde.131021 – Recipient cannot be senderTentativa de envio para o próprio número.Teste com outro destinatário.

Dúvidas?

Se ainda tiver qualquer dúvida, solicite um atendimento e nosso time de suporte retorna em algumas horas.