Symptom / Need

Receive real-time notifications about errors when sending WhatsApp messages.

Contexto / Escenarios

This feature allows customers to handle errors using events sent directly to their webhooks. Common scenarios include:

• Proactive monitoring to identify problems.
• Error logging and traceability for analysis and resolution.

Answer (Solution / Recommendation)

Error codes delivered by Meta and their description:

131026 The message cannot be delivered

• Common reasons:
  • The number does not belong to WhatsApp.
  • Authentication templates not available for users in India.
  • The recipient has not accepted the new terms of service.
  • The recipient is using an older version of WhatsApp.
• Recommended actions:
  • Verify that the recipient can receive messages.
  • Make sure the Terms of Service and app version are up to date.

131042 Payment issue related to company suitability

• Common reasons:
  • The payment account is not linked or active.
  • The credit limit has been exceeded.
  • Incomplete configuration (time zone, currency).
• Recommended actions:
  • Check the billing settings in your WhatsApp Business account.

130472 The user's number is part of an experiment

• Common reasons:
  • The message was not sent due to an experiment.
• Recommended actions:
  • See the documentation on marketing message experiments.

131049 Meta has decided not to deliver it

• Common reasons:
  • Limits applied to protect the ecosystem.
• Recommended actions:
  • Please wait before forwarding the message.
  • See message limits for more information.

131048 Spam frequency limit has been reached

• Common reasons:
  • Restrictions on the number of messages sent due to blocking or marking as spam.
• Recommended actions:
  • Check the quality status in WhatsApp Manager.
  • Review quality-based frequency limits.

131031 The account has been blocked

• Common reasons:
  • Non-compliance with policies or errors in data verification.
• Recommended actions:
  • Review policy compliance and use the Status API for more details.

132000 Template parameter count mismatch

• Common reasons:
  • Discrepancies between defined and sent parameters.
• Recommended actions:
  • Make sure to include all required parameters.

100 Invalid parameter

• Common reasons:
  • Misspelled or unsupported parameters.
• Recommended actions:
  • Verify that the parameters are valid and meet specifications.

131053 Media upload error

• Common reasons:
  • Content type not supported.
• Recommended actions:
  • Confirm that the media content complies with the supported formats.