Glossário · Erros da Meta

Erro 131026 no WhatsApp Business API

Mensagem não entregue

Mensagem da Meta: Message undeliverable
Resposta HTTP: 400
Família: Entrega da mensagem

O erro 131026 (message undeliverable) é devolvido quando a Meta aceita a chamada, mas não consegue entregar a mensagem ao número de destino. As causas mais comuns são número sem WhatsApp, número digitado errado e conta que nunca aceitou os termos de uso. Não é bloqueio nem falha da plataforma de atendimento.

Por que este erro acontece

O número não tem conta no WhatsApp, ou a conta foi desativada.
O número está digitado errado: um dígito a mais ou a menos. No Brasil isso costuma ser o nono dígito do celular, que existe em alguns cadastros antigos e falta em outros.
O código do país está ausente ou trocado. A API exige o número completo em formato internacional, sem o zero da operadora e sem sinais.
O aparelho do destinatário está com uma versão do WhatsApp antiga demais para receber aquele tipo de mensagem.
A pessoa nunca aceitou os termos de uso do WhatsApp naquele aparelho.

Como resolver

Confira o número em formato internacional completo: 55 + DDD + número, apenas dígitos.
Teste o mesmo número em outro canal (ligação, SMS, e-mail) e peça a confirmação do WhatsApp ativo.
Se o número veio de formulário ou planilha, revise a origem: erro de digitação em lista importada gera o 131026 em lote, sempre nos mesmos registros.
Marque o contato como inválido para que ele saia das próximas campanhas em vez de consumir tentativa toda vez.

O que não adianta tentar

Reenviar. O 131026 é uma resposta sobre o destinatário, não sobre a sua conta: enquanto o número for o mesmo, a resposta será a mesma. Trocar o template, esperar ou reduzir a cadência também não muda nada.

O que a Skynet.Talk mostra na tela

A Meta devolve o código cru em inglês. A plataforma traduz para uma frase que diz a causa e a ação: "O número não tem WhatsApp ativo ou não pode receber mensagens. Confirme o número com o cliente." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.

Erros relacionados

Erro 131047 — Janela de 24 horas fechada

Passaram mais de 24 horas desde a última mensagem do cliente: só um template aprovado reabre a conversa.

Erro 131009 — Valor de parâmetro inválido

Um dos valores enviados não é aceito pelo campo correspondente.

Erro 131021 — Remetente igual ao destinatário

A mensagem foi endereçada ao próprio número que envia. A API não permite a empresa mandar mensagem para si mesma.

Perguntas frequentes

O 131026 significa que a pessoa me bloqueou?

Não. Bloqueio do usuário não devolve este código: a mensagem sai como enviada e simplesmente não é entregue. O 131026 é a Meta dizendo que aquele número não recebe mensagens, normalmente por não ter WhatsApp ativo ou por estar digitado errado.

Por que ele aparece tanto em campanha?

Porque campanha usa lista, e lista tem número errado. É de longe o erro mais comum de quem dispara em volume, e a causa quase sempre é qualidade de cadastro, não configuração: número sem WhatsApp, digitado errado ou fora do formato internacional.

Dá para validar o número antes de gastar o envio?

Antes de enviar, o que dá para conferir é o formato: código do país, DDD e quantidade de dígitos. A existência da conta no WhatsApp só é confirmada pela própria tentativa de envio — não existe consulta oficial de "este número tem WhatsApp".

O erro conta como mensagem cobrada?

Não. A Meta cobra por conversa iniciada e entregue. Mensagem recusada com 131026 não abre conversa e não entra na fatura.

Este erro aparece no meio de um atendimento e some no log de quem integra direto com a Meta. Na Skynet.Talk ele vira uma frase em português na tela de quem atende. Veja o catálogo completo dos códigos ou entenda como a Meta cobra por mensagem.

Publicado por Skynet.Talk · catálogo revisado em 18 de agosto de 2026 · código conferido na documentação oficial da Meta.