Visão geral
Ao usar a API Oficial do WhatsApp (com ou sem coexistência), você pode encontrar códigos de erro retornados pela Meta ou exibidos na LíderHub. Esta página reúne os erros com impacto direto no seu uso: o que cada um significa, por que acontece e o que fazer.Erro 131060
Ao usar a API em modo coexistência (número conectado pelo app WhatsApp Business), o código 131060 está ligado a dispositivos companion e à visibilidade de mensagens no lado da API.O erro 131060 só ocorre em conexões via coexistência. Em números
conectados só pela Cloud API (sem app no celular), esse código não aparece.
O que é o erro 131060?
O código 131060 aparece quando um usuário do WhatsApp que tem um dispositivo companion não suportado envia ou recebe uma mensagem do seu número de negócio. Segundo a documentação oficial da Meta, isso pode acontecer quando a mensagem é enviada ou recebida por um dispositivo adicional não compatível e não é repassada para a API. A Meta orienta que você acesse a conversa no app WhatsApp Business — no celular ou no WhatsApp Web — para ver a mensagem.Por que isso acontece?
O erro é comum em setups de coexistência, quando:- O negócio usa ao mesmo tempo o app WhatsApp Business no celular e a Cloud API (na LíderHub).
- Um dispositivo companion do cliente (por exemplo WhatsApp Web ou tablet vinculado) envia ou recebe a mensagem.
- A mensagem não é repassada para a Cloud API por limitações dos dispositivos companion.
Como a LíderHub exibe esse erro
A LíderHub trata o webhook com erro 131060 e mostra um aviso claro. Você vê uma notificação objetiva, por exemplo:Uma mensagem deste contato não pôde ser exibida na LíderHub. Abra o app WhatsApp Business no seu celular para ver essa mensagem.Assim sua equipe sabe que deve conferir o app no celular para ver o conteúdo.
Como resolver
- Conferir o app WhatsApp Business no celular em que o número está vinculado e ver a conversa.
- Responder pelo dispositivo principal (app no celular), se precisar responder ao cliente.
- Seguir o uso normal — depois que a conversa for atualizada pelo dispositivo principal, as próximas mensagens tendem a sincronizar de novo na LíderHub.
Erros de parâmetro
131009 – Parâmetro inválido
Um ou mais parâmetros enviados na requisição têm valor inválido (por exemplo, variável de template em formato incorreto, tipo de mídia errado ou campo obrigatório mal preenchido). O que fazer: Revise o payload enviado à API, validando tipos e formatos de cada campo. Se possível, confira o webhook de erro para identificar exatamente qual parâmetro falhou. Se o envio for por template, acesse Configurações de templates, abra o template e use o botão de revalidar na Meta. Isso pode resolver casos em que a Meta faz recategorização ou ajuste do template sem notificação prévia.Erros de integridade e conta
368 – Bloqueado por violação de políticas
A conta WhatsApp Business foi restringida ou desativada por violação de políticas da plataforma. O que fazer: Consulte a documentação de Policy Enforcement da Meta e siga as orientações para resolver a restrição. Se necessário, entre em contato com o suporte da Meta.130497 – Restrição por país
A conta está impedida de enviar mensagens para usuários em certos países. O que fazer: Verifique a política de mensagens do WhatsApp Business para ver em quais países você pode enviar mensagens na sua categoria de negócio.131021 – Conta restrita por país
A conta comercial está bloqueada para envio em um país específico por restrições regulatórias ou políticas da Meta para aquele território. O que fazer: Verifique as restrições geográficas da conta no Meta Business Manager e, se necessário para sua operação, abra chamado no suporte da Meta.131031 – Conta bloqueada
A conta WhatsApp Business foi bloqueada ou restrita (por exemplo por violação de políticas ou porque os dados da requisição não batem com os da conta, como PIN de verificação em duas etapas incorreto). O que fazer: Consulte Policy Enforcement. Você também pode usar a Health Status API (se tiver acesso técnico) para mais detalhes sobre o bloqueio.Erros de limite e throttling
130429 – Limite de throughput atingido
O limite de mensagens por tempo da API foi atingido. O que fazer: Aguarde um pouco e tente de novo. Reduza a frequência de envio de mensagens para não bater no limite. Consulte a documentação de Throughput da Meta.131048 – Limite por spam
Há restrições de envio neste número porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam. O que fazer: Verifique o status de qualidade da conta no WhatsApp Manager. Veja limites de templates e qualidade de templates.131056 – Limite entre você e o mesmo contato
Foram enviadas muitas mensagens do seu número para o mesmo destinatário em pouco tempo. O que fazer: Reduza o volume para esse contato, aumente o intervalo entre envios e evite sequência de mensagens muito repetitivas. Sempre que possível, alterne com mensagens de utilidade e monitore a qualidade da conta para evitar novos bloqueios temporários.Erros de envio e entrega
131026 – Mensagem não entregue
A mensagem não pôde ser entregue. Possíveis motivos: o número não é WhatsApp, o destinatário não aceitou os Termos de Serviço e Política de Privacidade atuais, ou está usando uma versão antiga do WhatsApp. O que fazer: Por outro canal (fora do WhatsApp), peça ao contato que: confirme se o número está ativo no WhatsApp, valide o número no formato internacional, aceite os termos em Configurações e atualize o app. Se necessário, teste o mesmo template em outro número ativo para diferenciar se a falha está no contato ou no template.130403 – Não foi possível entregar
A mensagem não pôde ser entregue porque o usuário bloqueou o número da empresa no WhatsApp ou porque há restrição de recebimento de marketing para esse contato. O que fazer: Não há ação técnica quando o bloqueio é ativo no usuário. Revise qualidade/frequência das campanhas e remova o contato das listas de envio.131047 – Reengajamento (janela de 24h)
Passaram mais de 24 horas desde a última resposta do destinatário ao seu número. O que fazer: Envie uma mensagem de template aprovada. Fora da janela de 24h, só templates podem ser usados para iniciar conversa.131050 – Usuário parou de receber marketing
O destinatário optou por não receber mais mensagens de marketing do seu negócio no WhatsApp. O que fazer: Não tente reenviar mensagens de marketing para esse usuário — elas não serão entregues. Para ser avisado quando alguém parar ou voltar a receber marketing, use o webhook user_preferences.131049 – Meta não entregou a mensagem
A mensagem não foi entregue para manter o engajamento saudável do ecossistema (limites por usuário). O que fazer: Não retente imediatamente o mesmo template de marketing. Aguarde uma nova janela e, quando fizer sentido, use template de utilidade. Também reduza frequência e volume de campanhas por contato para diminuir novas limitações. Consulte limites por usuário para templates de marketing.Erros de experimento
130472 – Número em experimento da Meta
O número do usuário faz parte de um experimento da Meta que bloqueia temporariamente mensagens de marketing para uma pequena porcentagem de usuários. O que fazer: Não tente reenviar o mesmo template de marketing, pois o retorno tende a ser o mesmo durante o experimento. Para continuar a comunicação, use template de utilidade quando aplicável ou aguarde o usuário iniciar contato.Erros de mídia
131052 – Erro ao baixar mídia
A API não conseguiu fazer o download da mídia pela URL informada (URL inacessível/expirada, arquivo indisponível, formato não suportado ou tamanho acima do limite). O que fazer: Valide o tamanho do arquivo e tente novamente com mídia em formato suportado.131053 – Erro ao enviar mídia
A API falhou ao fazer o upload da mídia (tipo de arquivo não suportado, arquivo corrompido ou tamanho acima do limite). O que fazer: Confirme tipo e formato do arquivo, converta para formatos suportados (JPG/PNG, MP4, PDF) e reenvie, o arquivo não pode ser superior a 10MB.Erros de cobrança e elegibilidade
131042 – Problema de pagamento ou elegibilidade
Há um erro relacionado à forma de pagamento ou à configuração de cobrança da conta. O que fazer: Verifique a configuração de cobrança do WhatsApp Business e confirme método de pagamento ativo, dados corretos e saldo/limite disponível. Se houver falha de débito, tente atualizar o cartão ou adicionar uma nova forma de pagamento no Business Manager.Erros de template
135000 – Falha ao enviar com parâmetros da solicitação
A mensagem falhou por erro desconhecido relacionado aos parâmetros da solicitação, geralmente envolvendo template ou validações da Meta. O que fazer: Sincronize os templates com a Meta, valide nome/idioma/variáveis e, se necessário, duplique o template e envie para nova aprovação antes de testar novamente.132001 – Template não existe ou não aprovado
O template não existe no idioma informado ou ainda não foi aprovado. O que fazer: Confirme que o template está aprovado e que o nome e o idioma (locale) estão corretos. Veja a documentação de templates.132015 – Template pausado
O template está pausado por baixa qualidade e não pode ser usado em mensagens. O que fazer: Edite o template para melhorar o conteúdo e aguarde nova aprovação.132016 – Template desabilitado
O template foi pausado por baixa qualidade muitas vezes e está desabilitado de forma permanente. O que fazer: Crie um novo template com conteúdo diferente.132000 – Número de parâmetros não confere
A quantidade de valores de parâmetros enviados não corresponde à quantidade de variáveis definidas no template. O que fazer: Verifique o template e envie valores para todos os parâmetros exigidos. Veja formatos de parâmetros.Erros gerais e outros
100 – Mensagem não suportada pela requisição
A requisição não pôde ser processada pela Graph API por parâmetro inválido/ausente, recurso inexistente ou falta de permissão. O que fazer: Revise endpoint, parâmetros obrigatórios e permissões do app. Se houver link na mensagem, valide a URL antes do envio.000000 – Erro genérico
Ocorreu uma falha não mapeada nos códigos específicos da API. O que fazer: Se houver dúvida sobre o que aconteceu, entre em contato com o suporte para análise do caso e orientação dos próximos passos.99 – Follows não enviados
Os follows não foram enviados por invalidação do servidor durante o processamento. O que fazer: Reagende os follows que não foram enviados para nova tentativa de disparo.404 – Falha ou instabilidade no servidor
A solicitação não pôde ser concluída por possível falha temporária ou instabilidade momentânea no servidor. O que fazer: Verifique se houve incidente no momento do erro na página de status da LiderHub. Se houver incidente, aguarde a normalização e tente novamente. Se o erro persistir mesmo sem incidente ativo, entre em contato com o suporte.131051 – Mensagem não suportada pela API
O contato enviou um tipo de conteúdo que a API oficial da Meta não suporta exibir ou processar (ex.: alguns formatos específicos de interação ou mídia). O que fazer: Oriente o contato a reenviar em formato suportado (texto, imagem, documento padrão). Essa é uma limitação da API oficial da Meta, não da plataforma.400 – Erro na mensagem
Não foi possível enviar a mensagem por um possível erro no conteúdo enviado (formato inválido ou dados inconsistentes). O que fazer: Revise o conteúdo da mensagem (texto, variáveis, mídia e estrutura), corrija os dados e tente novamente.500 – Instabilidade na instância
Não foi possível processar a solicitação devido a uma instabilidade na sua instância. O que fazer: Verifique a conexão da instância, tente reconectá-la e repita o envio. Se o problema persistir, entre em contato com o suporte.131000 – Algo deu errado
A mensagem falhou por um erro desconhecido. O que fazer: Tente novamente, verifique possíveis instabilidades na página de status e teste outro envio. Se persistir, abra um ticket no Suporte Direto da Meta.131016 – Serviço indisponível
O serviço está temporariamente indisponível. O que fazer: Consulte a página de status do WhatsApp Business Platform e tente de novo depois.131045 – Certificado incorreto
A mensagem falhou por erro de registro do número de telefone. O que fazer: Registre o número antes de tentar de novo.133010 – Número não registrado
O número não está registrado na WhatsApp Business Platform. O que fazer: Registre o número e tente novamente.131037 – Nome de exibição pendente
O número usado para envio não tem nome de exibição aprovado. O que fazer: Altere e obtenha aprovação do nome de exibição do número.Documentação oficial Meta
Para a lista completa de códigos e detalhes técnicos, consulte a documentação oficial:Deixe uma sugestão
Feedback de Melhorias sobre Erros do WhatsApp
Feedback de Melhorias sobre Erros do WhatsApp
Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.