Erros da API do WhatsApp Business: o que cada código significa

Quando um envio falha, a Meta devolve um código. Esta página reúne os que aparecem com mais frequência para lojas de e-commerce, com a descrição oficial resumida e o caminho para resolver.

Erros de conta e pagamento

  • 131042Erro relacionado à forma de pagamento. Todos os envios por modelo falham até acertar a cobrança. Guia completo
  • 131031Conta restrita ou desativada por política, ou dado que a Meta não conseguiu verificar. Guia completo
  • 130497Conta restrita de enviar mensagens para usuários de certos países. Guia completo

Erros de modelo

  • 132001O modelo não existe no idioma pedido ou não foi aprovado. Guia completo

Erros de entrega para o cliente

  • 131026Não foi possível entregar. O destinatário pode não usar o WhatsApp, não ter aceitado os termos ou estar com uma versão desatualizada do app.
  • 131047Passaram mais de 24 horas desde a última resposta do cliente. Fora dessa janela, só é possível enviar por modelo aprovado.
  • 131049A Meta não entregou a mensagem para manter a saúde do ecossistema. Espere pelo menos 24 horas antes de reenviar e reveja os limites de mensagens de marketing por usuário.
  • 131056Mensagens demais do mesmo número para o mesmo destinatário em pouco tempo. Espere antes de tentar de novo com aquele cliente.

Descrições resumidas da documentação oficial da Meta, conferidas em 29/09/2026. A Meta atualiza essa lista de tempos em tempos.

Como o Notil lida com isso

O painel do Notil mostra o erro com orientação específica para cada caso (pagamento, conta bloqueada, país) e limpa o alerta sozinho quando as mensagens voltam a ser entregues. Cada envio fica visível na aba de mensagens, com o status de entrega.

Quanto a sua loja deixou em aberto no último mês?

Instale o Notil e veja o número da sua loja, calculado com os pedidos e carrinhos dela. Grátis, antes de qualquer cartão.

Ver o diagnóstico grátis Para lojas Nuvemshop e Shopify