Como resolver o erro 131026 do WhatsApp (mensagem não entregue)
O erro 131026 quer dizer que a Meta aceitou a mensagem mas não conseguiu entregar. Em Conversas, abra a mensagem com erro, envie para o mesmo número um modelo de Utilidade só com texto e, pelo resultado, descubra se o problema é número sem WhatsApp, bloqueio, app desatualizado ou limite de marketing.
Atualizado em
Antes de começar
- O WhatsApp precisa estar conectado em Configurações › WhatsApp.
- Tenha em mãos o número do cliente com o código do país.
- A Meta junta várias causas diferentes nesse código e, por privacidade, não diz qual foi. Por isso a solução é testar por eliminação.
- Não reenvie a mesma mensagem na hora: se a causa for o limite de marketing, vai falhar de novo.
Onde encontrar
Conversas › conversa do cliente › mensagem com erro › descrição do erro
Passo a passo
Descobrir a causa
- Abra Conversas, clique na conversa do cliente e confira se a mensagem que falhou mostra o código 131026.
- Envie para o mesmo número um modelo aprovado da categoria Utilidade só com texto: sem botões, sem imagens, sem links.
- Interprete o resultado:
- Se o modelo simples chegou, o WhatsApp do cliente está desatualizado e não consegue mostrar botões ou arquivos. Peça para ele atualizar.
- Se também falhou, o número não tem WhatsApp, deixou de existir ou o cliente bloqueou o seu número.
- Veja se o erro aparece só nesse contato ou em vários ao mesmo tempo. Só em um: o problema é daquele número. Em várias mensagens de Marketing: o cliente já recebeu mensagens de marketing demais (de várias empresas) e a Meta travou as seguintes.
- Confira o formato do número no contato: código do país, sem espaços nem caracteres a mais.
- Se o número for da Índia (+91), confira se você não enviou um modelo de Autenticação: a Meta não permite esse envio.
- Confira se não há uma pane na Meta em metastatus.com.
Corrigir
- Número sem WhatsApp ou desativado: tire o contato das listas de envio e fale com ele por SMS ou e-mail.
- Cliente que bloqueou você: pare de enviar; novas tentativas não vão chegar.
- Cliente que ainda não aceitou os termos mais recentes do WhatsApp: não há nada a fazer do seu lado; ele precisa abrir o WhatsApp e aceitar.
- App desatualizado: peça para o cliente atualizar o WhatsApp e envie de novo.
- Limite de marketing: espere e tente mais tarde, com intervalos cada vez maiores. Se a mensagem for um aviso de serviço, use um modelo de Utilidade.
- País sancionado ou restrito: tire esses contatos das listas; a Meta não entrega lá.
- O destinatário é outra empresa que usa a API do WhatsApp: a Meta não permite envios entre contas de API. Peça para ela escrever primeiro pelo app normal.
Dicas
- Só envie para quem autorizou receber WhatsApp; isso reduz bloqueios e denúncias.
- Limpe a lista com frequência: quem bloqueou, cancelou ou nunca recebe deve sair dos envios.
- Classifique bem os modelos: um aviso de serviço marcado como Marketing conta no limite de marketing do cliente.
- Acompanhe a qualidade dos seus modelos; qualidade baixa aumenta as falhas de entrega.
Problemas comuns
- Falha só com um contato, os outros recebem → O número não tem WhatsApp, está errado ou o cliente bloqueou você. Confira o número e fale com ele por outro canal.
- Várias mensagens de marketing falhando de uma vez → Limite de frequência de marketing da Meta. Espere, reenvie mais tarde e use Utilidade para avisos de serviço.
- Modelos simples chegam, mas os com botão ou imagem não → O app do cliente está desatualizado. Peça para ele atualizar.
- Modelo de código (Autenticação) nunca chega em um +91 → Restrição fixa da Meta. Envie o código por SMS ou e-mail.
Perguntas frequentes
Dá para saber o motivo exato da falha?
Não. A Meta usa esse código de propósito para várias causas e não revela qual foi. Os passos acima ajudam a reduzir as hipóteses.
Isso foi útil?
Obrigado pela sua opinião.
