Código de erro

Causa (Descrição)

Possível solução

0

Não foi possível autenticar o usuário

Verifique se seu token de acesso é válido e não expirou.

1

API desconhecida.

Verifique a URL e o endpoint ao qual a solicitação está sendo feita.

2

Serviço temporariamente indisponível

Problema nos servidores da Meta. Aguarde alguns minutos e tente novamente.

3

O app não possui permissões suficientes

Acesse Meta for Developers e certifique-se de conceder as permissões necessárias ao seu token/app.

4

Muitas solicitações

Você atingiu o limite de requisições da API. Reduza a velocidade de envio.

10

Permissões insuficientes para acessar o recurso

Valide que seu usuário ou token tenha as funções administrativas apropriadas.

33

O número de telefone da empresa foi eliminado.

Você terá de registrar um novo número ou apelar a eliminação no seu Gerenciador do WhatsApp.

100

A solicitação contém parâmetros inválidos

Verifique a estrutura dos dados que você está enviando (faltam dados ou o formato está incorreto).

190

O token de acesso expirou

Gere um novo token de acesso permanente ou renove o temporário na Meta.

368

A conta comercial foi desabilitada por violar as políticas do WhatsApp

Acesse a seção "Qualidade da conta" no seu Meta Business Suite para ver os detalhes e apelar a decisão.

400

Não foi possível baixar o conteúdo multimídia enviado pelo remetente

Peça ao usuário que envie o arquivo novamente ou verifique se o formato é suportado.

401

Chave de API inválida.

Verifique se a chave de API configurada na sua conexão está correta.

402

Erro relacionado ao método de pagamento

Acesse o Business Manager e atualize ou adicione um cartão de crédito válido.

403

O endpoint está bloqueado.

Contate nosso Suporte Técnico para revisar a conexão do seu canal.

404

Contato não existe

Verifique se o número de telefone do cliente está correto e se tem o WhatsApp instalado.

408

Mensagem pendente por muito tempo

Erro de latência. Tente novamente enviar a mensagem.

410

Não foi possível enviar a mensagem durante seu tempo de vida

O sistema não conseguiu entregar a mensagem a tempo. Tente enviar novamente.

429

Limite de frequência atingido

Você está enviando mensagens muito rápido. Aguarde um momento e reduza a velocidade de envio.

430

Ocorreu um erro relacionado ao seu certificado

Verifique a configuração dos seus webhooks e certificados de segurança.

432 / 433

Ocorreu um erro relacionado à assinatura do seu certificado

Valide a assinatura do certificado de segurança na configuração técnica.

470

Passaram mais de 24 horas. Use um modelo

A janela de atendimento fechou. Use um Modelo do WhatsApp (HSM) para retomar o contato.

471

Restrições de quantidade de mensagens

Você atingiu o limite de envios diários (Tier). Verifique seu nível de mensagens no Gerenciador do WhatsApp.

472

O número de telefone do usuário faz parte de um experimento

Restrição interna temporária da Meta. Não requer ação de sua parte.

480

O usuário deste número possivelmente mudou.

Revalide o contato; é possível que a linha tenha mudado de proprietário.

500

Erro ao enviar mensagem

Erro interno e temporário. Tente novamente mais tarde.

1000

Formato não suportado ou excede o tamanho máximo permitido

Comprima seu arquivo (PDF, vídeo ou imagem) ou envie em um formato aceito.

1001

O comprimento da mensagem excede 4.096 caracteres

Encurte seu texto antes de enviá-lo (WhatsApp não suporta mensagens tão longas).

1002

Tipo de destinatário inválido

Certifique-se de estar enviando a mensagem para um número de telefone válido.

1004

Conflito com a criação de arquivo

Houve um erro ao tentar enviar ou processar seu arquivo multimídia. Tente novamente.

1005

Acesso negado

Verifique as permissões de acesso da sua integração técnica.

1006

Arquivo ou recurso não encontrado

O arquivo multimídia expirou ou o ID fornecido está incorreto. Envie-o novamente.

1007

O destinatário não consta na lista de autorizados

Se seu app está em modo de desenvolvimento, você precisa adicionar este número à sua lista de teste na Meta.

1008

Um parâmetro necessário não foi encontrado

Complete todos os campos obrigatórios na mensagem ou modelo que você está enviando.

1009

Valor de parâmetro inválido

O tipo de dado que você está enviando não está correto (por exemplo, você enviou texto em vez de um número).

1010

A mensagem contém um parâmetro não necessário

Você está enviando mais informações do que o modelo ou API solicitou.

1011

O serviço não está pronto

O sistema está sendo inicializado. Aguarde alguns segundos e tente novamente.

1013

O número não possui uma conta de WhatsApp válida

Peça ao seu cliente para confirmar se o número dele tem o aplicativo do WhatsApp ativo.

1014

Protocolo na URL desconhecido

Certifique-se de usar http:// ou https:// nos seus links.

1015

O limite de frequência do cliente foi atingido

Você deve pausar os envios temporariamente porque ultrapassou o limite permitido por segundo.

1016

Sistema sobrecarregado

Os servidores da Meta estão saturados. Tente novamente mais tarde.

1021

Não é possível enviar mensagens para si mesmo

Tente enviar a mensagem para um número de cliente, não para o seu próprio número de empresa.

1022

URL de webhooks não configurada

Configure a URL de resposta no seu painel do Meta for Developers.

1023

Erro no banco de dados

Erro temporário na Meta. Tente enviar novamente mais tarde.

1024

Você deve alterar a senha

Por motivos de segurança, você deve atualizar as credenciais da sua conta da Meta.

1025

A solicitação não é válida

Verifique se o código ou a estrutura que você está enviando não possui erros de sintaxe.

1026

Versão do WhatsApp do cliente não suporta esta mensagem

O cliente usa uma versão muito antiga do WhatsApp. Sugira que ele atualize o aplicativo.

1028

Você enviou uma mensagem a um usuário do WhatsApp que possivelmente mudou

Peça a confirmação de identidade ao usuário atual dessa linha.

2000

O número de parâmetros fornecidos não corresponde ao previsto

Revise o seu modelo: se ele tiver 3 variáveis {{1}}, {{2}}, {{3}}, você deve enviar exatamente 3 valores.

2001 / 2003

O modelo não existe para um idioma ou região específica

Verifique se o modelo está aprovado no idioma em que você está tentando enviar.

2002

O receptor não conseguiu baixar o modelo

Problema temporário de conectividade no telefone do cliente.

2004

O parâmetro é muito longo

O texto que você inseriu em uma das variáveis do seu modelo excede o limite de caracteres.

2005

O texto traduzido é muito longo

Simplifique e encurte o texto do seu modelo nesse idioma específico.

2006

A política de espaços em branco do modelo foi violada

Remova os espaços duplos ou quebras de linha desnecessárias no seu modelo.

2007

A política de caracteres de formatação foi descumprida

Verifique se não há caracteres proibidos ou símbolos estranhos na sua mensagem.

2008

O formato do arquivo de mídia não é compatível

Certifique-se de enviar imagens/documentos nos formatos padrão aprovados pelo WhatsApp.

2009

Falta um componente obrigatório do modelo

Você esqueceu de adicionar informações no cabeçalho, corpo ou botões do modelo.

2010

A URL do componente do botão não é válida

Verifique se o link da web colocado no seu botão funciona corretamente.

2011

O número de telefone do componente do botão não é válido

Verifique o código do país e o formato do número configurado no botão de chamada.

2012

O formato do parâmetro não corresponde ao formato do modelo criado

Certifique-se de não estar enviando texto onde o modelo espera receber uma imagem, ou vice-versa.

2013

O receptor não suporta estes botões

O cliente usa uma versão desatualizada do WhatsApp ou um dispositivo incompatível.

2014

Namespace previsto vazio

Verifique se o "Namespace" (espaço de nomes do modelo) está configurado corretamente.

2015

A solicitação de mensagem contém um número de seções menor ou maior que o permitido

Ajuste as opções do seu menu interativo ou lista dinâmica (o máximo permitido são 10 opções).

2016

O número de linhas não é válido

Verifique a estrutura das linhas enviadas na sua mensagem de lista interativa.

2017

A política de caracteres de formatação foi descumprida

Remova caracteres de formatação proibidos na plataforma.

2023

O total de produtos excedeu o número máximo permitido

Adicione produtos ao seu catálogo ou reduza a quantidade que você tenta mostrar de uma só vez.

2024

O identificador de catálogo não existe ou não pertence à sua conta WABA

Verifique o ID do catálogo no seu Gerenciador de Negócios e certifique-se de ter acesso.

2025

O catálogo não está conectado ao número de telefone

Entre no Gerenciador do WhatsApp e vincule corretamente o catálogo ao número de telefone.

2026

Alguns produtos na sua solicitação não foram encontrados no catálogo

Verifique se os IDs dos itens (SKUs) correspondem exatamente aos do seu inventário na Meta.

2027

Nenhum produto foi encontrado no catálogo

O catálogo selecionado está vazio. Faça o upload do seu inventário primeiro.

2028 / 2029 / 2030

Lista de produtos com informações omitidas ou incompletas

Verifique se os seus produtos têm preço, imagem, nome e descrição aprovados.

2036

Estrutura do cabeçalho inválida

Verifique se o seu modelo espera um cabeçalho do tipo TEXTO ou IMAGEM e certifique-se de enviar o correto.

2050

Ausência de informações sobre o cumprimento dos requisitos

Verifique as políticas comerciais e requisitos de e-commerce na sua conta da Meta.

2061

O modelo está pausado

Seu modelo foi denunciado por clientes e pausado pela Meta. Melhore a qualidade ou aguarde a reativação.

2062

O modelo encontra-se desativado

O WhatsApp bloqueou permanentemente este modelo. Você precisará criar um novo.

80007

A conta comercial atingiu sua taxa limite de envio de mensagens

Você excedeu seu limite de envios diários. Você deve esperar 24 horas para que o limite seja reiniciado.

130429

O desempenho de mensagens da Cloud API foi atingido

Você está enviando mensagens demais em um mesmo segundo. Regule a velocidade (throttling).

130497

A conta da empresa não pode enviar mensagens aos usuários deste país

Existem bloqueios regionais, embargos ou restrições da Meta para enviar mensagens a esse país.

2388019

O limite de modelos para esta WABA foi excedido

Você criou modelos demais. Exclua os antigos ou os que você não usa mais.

131000

Algo deu errado. Entre em contato com o Suporte Técnico

Erro não documentado pela Meta. Abra um chamado para a nossa equipe técnica da Atom.

131005

O aplicativo não tem as permissões suficientes ou foi excluído

Verifique o status da conexão do seu App na Meta ou renove seu token de sistema.

131008

A solicitação não contém parâmetros que são obrigatórios

Faltam campos obrigatórios no envio da sua mensagem.

131009

Um ou mais parâmetros são inválidos

Valide os tipos de dados que você está enviando (ex: texto onde deveria ir um link).

131031

A conta comercial foi desativada por violar as políticas do WhatsApp

A conta está suspensa. Você deve ir à seção "Qualidade da conta" na Meta para resolver isso.

131016

Serviço temporariamente indisponível

Falha na nuvem da Meta. Tente novamente em alguns minutos.

131021

O número de telefone do remetente e do destinatário é o mesmo

Para fazer testes, utilize um número pessoal, não envie mensagens para si mesmo.

131026

Número inválido ou termos não aceitos

O cliente deve atualizar o aplicativo dele e aceitar os termos de uso, ou o número está incorreto.

131037

O número precisa de aprovação de nome para exibição

O "Display Name" da sua empresa ainda não foi aprovado. Acesse o Gerenciador do WhatsApp.

134100

Apenas mensagens de Marketing são suportadas pelo MMLite

Edite o seu modelo e certifique-se de que a categoria dele esteja classificada como "Marketing".

134101

O seu modelo ainda está sincronizando com o MM Lite

Processo interno de sincronização na Meta. Aguarde entre 5 e 15 minutos.

134102

Verifique o status do onboarding e entre em contato com o Suporte Técnico

Houve um problema no registro do canal. Entre em contato com o Suporte para verificar a conexão.

131042

Erro relacionado ao método de pagamento

Acesse o seu painel da Meta e verifique se o cartão de crédito registrado não foi recusado.

131045

Erro no registro do seu número de telefone

O número ficou preso no processo de registro. Verifique o status da linha na Meta.

131047

Já se passaram mais de 24 horas desde a última resposta

A conversa expirou. Obrigatoriamente você deve usar um Modelo aprovado (HSM) para voltar a escrever.

131049

A Meta decidiu não entregar esta mensagem para prevenir spam

A Meta bloqueou temporariamente os envios para este usuário por considerá-lo spam. Aguarde um dia inteiro.

131050

O usuário interrompeu o recebimento de mensagens de marketing

O cliente selecionou a opção "Parar de receber mensagens". Respeite a decisão e pare as campanhas para essa linha.

131048

Restrições na quantidade de mensagens

Sua conta tem restrições ativas por limite de qualidade ou limite diário de mensagens.

131051

Tipo de mensagem não suportado

Tente enviar o conteúdo em um formato padrão (texto, imagem, vídeo curto).

131052

Não é possível baixar o arquivo enviado pelo usuário

Diga ao cliente que houve uma falha de conexão e peça para ele enviar o arquivo novamente.

131053

O arquivo é muito grande ou está corrompido

Compacte o arquivo e certifique-se de não ultrapassar o peso máximo permitido (geralmente 16MB).

131056

Muitas mensagens foram enviadas para este número em um curto período

Reduza a quantidade de notificações para este usuário específico; o sistema o pausou por precaução.

132000

O número de parâmetros fornecidos não corresponde ao previsto

Você está deixando campos de modelo (como {{1}}) em branco, ou está enviando a mais.

132001

O modelo não existe

Certifique-se de ter digitado o nome do modelo de forma idêntica a como foi aprovado.

132005

O modelo excede o tamanho permitido

O conteúdo é muito longo, ajuste o design a partir do seu Gerenciador de Modelos.

132012

Os parâmetros não coincidem com o formato do modelo

Verifique se as variáveis coincidem exatamente com o que a mensagem espera.

132015

O modelo está pausado devido à baixa qualidade

O modelo foi pausado temporariamente por receber denúncias de clientes ou bloqueios.

132016

O modelo foi desativado pelo WhatsApp

O modelo foi retirado definitivamente por violar as políticas comerciais. Você precisará criar outro.

133000

A tentativa de cancelamento de registro falhou

Entre em contato com a área de suporte técnico para verificar por que o número não pode ser cancelado.

133004

O servidor do WhatsApp está temporariamente indisponível

Falha geral da Meta. Resta apenas esperar que eles restabeleçam o serviço.

133005

A verificação em duas etapas falhou devido ao PIN incorreto

Insira o PIN correto de 6 dígitos que você configurou no seu painel de segurança.

133006

É necessário verificar novamente o número de telefone

Solicite um novo código de registro por SMS ou chamada e insira-o no portal.

133008

Muitas solicitações falhadas de verificação em duas etapas

Aguarde o tempo de penalidade indicado pela plataforma após repetidos erros do PIN.

133009

Muitas solicitações de verificação em duas etapas

Você ultrapassou o limite de tentativas. Tente novamente mais tarde ou amanhã.

133010

O número não está registrado na Whatsapp Business Platform

Conclua o processo de ativação e registro da linha no Meta Business Suite.

133015

Número excluído recentemente, processo ainda não concluído

Você deve esperar até que o banco de dados da Meta termine de limpar a exclusão antes de registrá-lo.

135000

Erro desconhecido com os parâmetros da mensagem

Revise detalhadamente a estrutura da mensagem ou contate o Suporte para validá-la.

130472

O número de telefone faz parte de um experimento

Situação técnica e temporária da Meta. Você não pode fazer nada do seu lado, apenas esperar.

2388269

O tipo de categoria no modelo não é suportado

Atribua uma categoria oficial permitida ao seu modelo (MARKETING, UTILIDADE ou AUTENTICAÇÃO).

138000

Calling não habilitado

Verifique se a funcionalidade de chamadas está ativada para o seu número do WhatsApp.

138001

Receptor não pode receber chamadas

O cliente tem uma versão muito antiga ou desativou o recebimento de chamadas.

138002

Limite de chamadas simultâneas atingido

Sua linha já está gerenciando o número máximo de chamadas simultâneas permitidas.

138003

Chamada duplicada

O sistema tentou iniciar a mesma chamada duas vezes.

138004

Erro de conexão

Falha na rede ao tentar conectar a chamada.

138005

Limite de chamadas excedido

Você atingiu o limite de minutos ou chamadas da sua conta comercial.

138006

Sem permissão de chamada aprovada

Você deve solicitar previamente a permissão de chamada e aguardar que o usuário a aceite.

138007

Erro de timeout de conexão

A chamada expirou ou não pôde estabelecer comunicação antes do tempo limite.

138009

Limite de solicitações de permissão de chamada atingido

Você enviou a solicitação de permissão a este usuário vezes demais sem resposta.

138010

Limite de chamadas por permissão atingido

Esgotou-se o número de chamadas que você poderia fazer sob a permissão aceita pelo usuário.

138011

Não foi possível enviar a solicitação de permissão de chamada

Houve um erro de envio. Tente enviar o botão de solicitação mais tarde.

138012

Limite de chamadas iniciadas pelo negócio atingido

Você ultrapassou sua cota de chamadas saintes como empresa.

131062

Os destinatários com BSUID não são compatíveis

O usuário oculta seu número (BSUID). Tente enviar um formato de mensagem mais simples.