Erro 131026 no WhatsApp: mensagem não entregue

O 131026 é a Meta dizendo que não conseguiu entregar a mensagem àquele número. A requisição estava certa e a conta está funcionando; o problema está do lado do destinatário. São três causas possíveis, e a Meta não diz qual delas aconteceu — por isso o diagnóstico passa por falar com o contato por outro canal.

O que a Meta diz

A tabela de códigos da Meta já lista as causas. Na tradução oficial: “não foi possível entregar a mensagem”, porque o número não está registrado no WhatsApp, o destinatário não aceitou os novos termos de serviço e política de privacidade, ou usa uma versão antiga do aplicativo.

Descrição na tabela de códigos da MetaUnable to deliver message. Reasons can include: the recipient phone number is not a WhatsApp phone number; recipient has not accepted the new Terms of Service and Privacy Policy; recipient using an old WhatsApp version

As três causas

• O número não tem WhatsApp. É a mais comum em lista importada: telefone fixo, número digitado errado, número antigo que a pessoa não usa mais, ou código de país e DDD faltando. A API do CRPRO Hub aceita no campo to só dígitos, de 8 a 15, com código do país — sem +, espaço ou parênteses.
• O contato não aceitou os termos novos. Quando o WhatsApp atualiza os termos de serviço e a política de privacidade, quem ainda não aceitou deixa de receber mensagens de empresas pela plataforma.
• O aplicativo está desatualizado. A Meta publica a versão mínima de cada aplicativo, na tabela abaixo.

Como resolver

A orientação da Meta é usar outro meio de comunicação — telefone, e-mail, SMS — e pedir ao contato que:

• confirme que consegue mandar mensagem para o seu número comercial no WhatsApp. Se ele mandar, você ganha de quebra a janela de atendimento aberta;
• aceite os termos mais recentes, em Configurações > Ajuda ou Configurações > Informações do aplicativo;
• atualize o WhatsApp para a versão mais recente.

Se o contato não responder por nenhum canal, trate o número como inválido e tire-o das próximas campanhas.

Como evitar

• Guarde o número que o WhatsApp devolve. Quando o contato escreve para você, o campo data.from do evento message.received traz o identificador que o WhatsApp usa para ele. Responder para esse valor evita erro de digitação e de formato. Veja receber mensagens.
• Valide na captura. Formulário que exige código de país e DDD, e só aceita números com o tamanho certo, corta boa parte dos 131026 antes da primeira campanha.
• Limpe a lista. Número que deu 131026 várias vezes seguidas raramente volta a funcionar sozinho.

Como o 131026 aparece no CRPRO Hub

A Meta não informa se este código vem na resposta da chamada ou depois, por webhook — e ela recomenda tratar as duas vias. No CRPRO Hub, se a recusa vier na chamada, o envio responde 502 com o código em details.meta_code:

{
  "error": {
    "code": "META_SEND_FAILED",
    "message": "A Meta recusou o envio da mensagem.",
    "details": {
      "meta_code": 131026
    }
  }
}

Se vier depois do 202, chega no evento message.status com status: "failed". O objeto de erro também traz title e message, cujo texto a Meta não publica para este código — por isso ficam de fora do exemplo:

{
  "id": "7a2c9e10-4b3d-4f5e-8a6b-1c2d3e4f5a6b",
  "event": "message.status",
  "channel_id": "9f6a9c1e-2f3d-4a5b-8c7d-1e2f3a4b5c6d",
  "occurred_at": "2026-10-03T12:00:00.000Z",
  "data": {
    "message_id": "wamid.EXEMPLO456",
    "status": "failed",
    "recipient_id": "5521999999999",
    "conversation": null,
    "pricing": null,
    "errors": [
      {
        "code": 131026,
        "error_data": {
          "details": "Unable to deliver message. Reasons can include: the recipient phone number is not a WhatsApp phone number; recipient has not accepted the new Terms of Service and Privacy Policy; recipient using an old WhatsApp version"
        },
        "href": "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes/"
      }
    ]
  }
}

Perguntas frequentes

Erros parecidos

• 131047 — A janela de atendimento de 24 horas está fechada.
• 131049 — O WhatsApp segurou um template de marketing pelo limite por contato.
• 131050 — O contato parou de receber marketing da sua empresa.
• 131051 — O tipo de mensagem não é suportado.

A lista completa, com o que fazer em cada caso, está em códigos de erro da Meta. Os erros do próprio CRPRO Hub, como META_SEND_FAILED, estão em erros da API.

Fontes

Fonte: códigos de erro da Cloud API, documentação da Meta conferida em 3 de outubro de 2026.