Início › API oficial do WhatsApp › Códigos de erro

Códigos de erro da API oficial do WhatsApp

O que cada erro da WhatsApp Cloud API significa e como resolver, em português. Digite o código para encontrar rápido.

Autorização e permissões

0

AuthExceptionA Meta não conseguiu autenticar o usuário do aplicativo. Normalmente o token de acesso expirou ou houve mudança nas permissões.

API MethodO app não tem permissão para esse método da API ou a chamada está configurada de forma errada.

Permission DeniedFalta permissão para a ação, a permissão foi removida ou o número de telefone não está aprovado na conta.

Access token has expiredO token de acesso venceu, então as chamadas à API são recusadas.

API PermissionUma permissão específica está faltando ou foi revogada.

Limites de envio

4

API Too Many CallsO app ultrapassou o limite de chamadas à API.

Rate limit issuesA conta do WhatsApp Business atingiu o limite de chamadas.

Rate limit hitO número ultrapassou o limite de vazão (mensagens por segundo).

Spam rate limit hitO envio foi limitado porque muitas mensagens anteriores foram bloqueadas ou denunciadas como spam.

Pair rate limit hitMuitas mensagens foram enviadas do mesmo número para o mesmo destinatário em pouco tempo.

Account register/deregister rate limit exceededHouve mais de 10 tentativas de registrar ou desregistrar o número em 72 horas.

Integridade e bloqueios

Temporarily blocked for policies violationsA conta foi restringida ou bloqueada temporariamente por violar alguma política da plataforma.

Business account is restricted from messaging users in this countryA empresa não pode enviar mensagens para usuários de determinado país, por categoria do negócio ou regra local.

Account has been lockedA conta foi bloqueada ou desativada por violação de política (por exemplo, falha na verificação ou spam).

Modelos de mensagem (templates)

Number of parameters does not match the expected number of paramsA quantidade de variáveis enviadas é diferente da quantidade definida no modelo aprovado.

Template name does not exist in the translationO template não existe, não está aprovado ou não existe no idioma informado.

Translated text too longDepois de preencher as variáveis, o texto ou os botões passaram do limite de caracteres.

Template format character policy violatedO conteúdo enviado tem caracteres ou formatação que violam as regras do template.

Template parameter format mismatchO tipo de parâmetro não corresponde ao aprovado (por exemplo, imagem onde se espera vídeo).

Template is pausedO template foi pausado por baixa qualidade (muitos bloqueios ou denúncias).

Template is disabledO template foi pausado várias vezes e acabou desativado de vez.

Entrega de mensagens

Message undeliverableNão foi possível entregar: número inválido, sem WhatsApp, app desatualizado ou destinatário que não aceitou os termos atuais.

Re-engagement messagePassaram mais de 24 horas desde a última mensagem do cliente, então mensagens livres não podem ser enviadas.

Meta chose not to deliverA Meta não entregou a mensagem para preservar a experiência do usuário, geralmente por limite de mensagens de marketing por pessoa.

User stopped marketing messagesO destinatário optou por não receber mensagens de marketing da sua empresa.

Unsupported message typeO tipo de mensagem enviado não é suportado.

Media download errorNão foi possível baixar a mídia enviada pelo usuário.

Media upload errorFalha no envio da mídia, geralmente por formato ou tamanho não suportado.

User's number is part of an experimentO número do destinatário faz parte de um experimento da Meta sobre mensagens de marketing e a mensagem não foi entregue.

Recipient phone number not in allowed listCom número de teste, só é possível enviar para os destinatários cadastrados na lista permitida.

Recipient cannot be senderO número de origem e o de destino são o mesmo.

Conta, número e cobrança

WhatsApp provided number needs display name approvalO número ainda não tem nome de exibição aprovado.

Business eligibility payment issueHá um problema de pagamento: sem forma de pagamento, limite de crédito estourado ou conta de cobrança inválida.

Incorrect certificateErro no certificado de registro do número.

Account in maintenance modeA conta está em modo de manutenção (por exemplo, durante migração ou upgrade de vazão).

Two step verification PIN mismatchO PIN de verificação em duas etapas informado está errado.

Phone number not registeredO número não está registrado na plataforma.

WhatsApp Flows

Flow is blockedO Flow foi bloqueado por violação de política ou muitas denúncias.

Flow is throttledO Flow foi limitado temporariamente por problemas de saúde do endpoint ou excesso de denúncias.

Blocked by integrityProblemas de integridade da conta impedem criar ou publicar Flows.

Flow cannot be updatedFlows publicados não podem ser editados.

Erros gerais

Something went wrongFalha desconhecida no envio.

Access deniedA permissão necessária não foi concedida ou foi revogada.

Required parameter is missingFalta um parâmetro obrigatório na requisição.

Parameter value is not validUm parâmetro tem valor ou tipo inválido.

Service unavailableUm serviço do WhatsApp está temporariamente fora do ar.

Invalid parameterParâmetro inválido, inexistente ou com erro de digitação (também aparece em erros de Flows, como nome duplicado).

Explicações da ALS baseadas na documentação oficial da Meta. Os códigos e mensagens podem mudar; em caso de dúvida, consulte a documentação da Cloud API ou o seu provedor.