Erro 131000 no WhatsApp: Something went wrong — como tratar o erro genérico

O erro 131000 (Something went wrong) é o erro genérico da WhatsApp Cloud API: uma falha interna, geralmente transitória, do lado da Meta — a própria documentação orienta "tente novamente e, se persistir, abra um ticket no Direct Support". O tratamento correto é retry com backoff exponencial (30s → 2min → 10min), checar se há instabilidade em metastatus.com e, nos casos que envolvem WhatsApp Flows, validar a business public key. Se persistir sem outage ativo, abra ticket incluindo o fbtrace_id do erro.

Todo desenvolvedor que opera a Cloud API em volume encontra o 131000 uma hora. Ele é o "erro 500 do WhatsApp": não diz o que houve, e na maioria das vezes não é culpa sua. O que diferencia uma integração amadora de uma profissional é como ela reage a ele.

O que é o erro 131000

A resposta vem com HTTP 500:

{
  "error": {
    "message": "(#131000) Something went wrong",
    "type": "OAuthException",
    "code": 131000,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "Message failed to send due to an unknown error."
    },
    "fbtrace_id": "AbC123..."
  }
}

As causas conhecidas

Falha interna transitória da Meta — de longe a mais comum; resolve sozinha em segundos ou minutos
Outage ou degradação da plataforma — verificável na página oficial de status (metastatus.com)
Problema com a business public key (WhatsApp Flows) — a documentação cita explicitamente falhas ao calcular assinatura ou registrar a chave; ela precisa ser RSA 2048 bits em formato PEM, registrada no phone number ID correto
Token ou configuração do app — relatos de comunidade apontam tokens expirados/sem permissão e apps com configuração corrompida gerando 131000 em vez de erros mais específicos

Como tratar: o playbook

1. Retry com backoff exponencial

O 131000 é, por definição, "tente de novo" — mas nunca em loop imediato:

tentativa 1 → falhou → espera 30s
tentativa 2 → falhou → espera 2min
tentativa 3 → falhou → espera 10min → alerta/fila manual

Adicione jitter (variação aleatória) para não sincronizar rajadas de retry, e limite as tentativas.

2. Cuidado com duplicação

Um 131000 não garante que a mensagem não saiu. Antes de reenviar, confira no webhook se chegou um status para aquele envio — cliente recebendo a mesma cobrança duas vezes é pior que atraso.

3. Elimine as causas do seu lado

Status da plataforma: metastatus.com/whatsapp-business-api — se há outage, aguarde; retry em massa durante instabilidade só amplifica o problema
Token: valide no Access Token Debugger da Meta (expiração e permissões whatsapp_business_messaging e whatsapp_business_management)
Flows: se o erro coincide com fluxos interativos, revalide a public key registrada

4. Quando abrir ticket

Erro persistente por horas, sem outage ativo, com token e configuração validados: abra o Direct Support (business.facebook.com/direct-support) com o fbtrace_id, o payload enviado e os horários. Em casos crônicos, a comunidade relata que recriar o app no painel de desenvolvedores resolveu.

O contexto que muda o diagnóstico

O 131000 sozinho é transitório. Acompanhado, ele conta outra história: junto de falhas 131026 pode indicar problema de entregabilidade; em meio a uma campanha grande, vale conferir se não há 131048 (limite por spam) na mistura. Por isso o monitoramento por código de erro — não só "falhou/não falhou" — é indispensável em produção.

É também um bom argumento para não operar na unha: plataformas que rodam sobre a API oficial em escala já embutem retry, deduplicação e monitoramento de status. A Wizebot trata esse encanamento por você — incluindo uma página própria de status da Meta — para que um soluço da plataforma não vire mensagem perdida nem cliente cobrado duas vezes.

Perguntas frequentes

O erro 131000 é culpa da minha integração?

Na maioria das vezes, não — é falha interna da Meta e transitória. Mas vale eliminar as causas locais: token expirado ou sem permissão, configuração do app e, se você usa WhatsApp Flows, a business public key registrada.

Quantas vezes devo tentar reenviar após um 131000?

Duas ou três tentativas com backoff exponencial (ex.: 30 segundos, 2 minutos, 10 minutos) cobrem os casos transitórios. Persistindo, pare, verifique o metastatus e escale para investigação — loop de retry infinito só gera fila e risco de duplicação.

A mensagem que deu 131000 foi enviada ou não?

Não assuma nada: o erro é "desconhecido" por definição. Confirme pelo webhook de status usando o ID da mensagem antes de reenviar — se nenhum status chegar, trate como não enviada.

O que é o metastatus.com?

A página oficial de status das plataformas da Meta, incluindo a WhatsApp Business API. É a primeira checagem quando o 131000 aparece em volume: se há incidente ativo, o problema é global e a única ação é aguardar a normalização.

O 131000 é inevitável em qualquer operação séria de WhatsApp — o que se controla é o raio do estrago: retry disciplinado, deduplicação e monitoramento. Se preferir que essa engenharia venha pronta, a Wizebot opera a API oficial com essa resiliência embutida, do envio ao relatório de entrega.