Meta & Webhook Error Codes Reference

ZeroRTO Order Notes Telemetry

All Meta and courier error payloads are logged directly inside WooCommerce order notes

Real-time Catch Safe Fallback Active

1. Meta WhatsApp Cloud API Error Codes

Returned by Meta Graph API during automated template dispatch:

Invalid OAuth Access Token

Error 190

Meaning: Your Meta Access Token has expired, been revoked, or the app secret was regenerated. This happens when using the 24-hour temporary token instead of a System User permanent token.

Fix: Generate a lifetime Permanent Access Token via Meta Business Settings > System Users with whatsapp_business_messaging permissions. Paste it in ZeroRTO > WhatsApp Cloud API tab.

Re-engagement Message Required (24-Hour Policy)

Error 131047

Meaning: More than 24 hours have passed since the customer last messaged your business. Meta strictly forbids sending freeform plain text messages outside this window.

Fix: Outbound merchant alerts must use Meta-approved Utility Templates. Only send plain text after the customer initiates or replies on WhatsApp.

Template Does Not Exist

Error 132000

Meaning: Meta cannot locate a template matching the requested name or language code in your specific WhatsApp Business Account (WABA).

Fix: Ensure the template name in ZeroRTO > WhatsApp Cloud API (default: rescuedrop_ndr_alert) and language (e.g. en_US) exactly matches the approved template in your Meta Manager.

Template Parameter Count Mismatch

Error 132001

Meaning: The number of variable parameters passed by ZeroRTO (4 variables: Name, Order, Courier, AWB) does not match the placeholders in your template.

Fix: Edit your Meta template body to include exactly 4 sequential placeholders: 1, 2, 3, and 4.

Message Undeliverable / Invalid Recipient

Error 131026

Meaning: The customer's billing phone number is not registered on WhatsApp or the country code formatting was rejected by Meta.

Fix: Ensure customers provide a valid WhatsApp number at checkout. ZeroRTO automatically normalizes Indian (+91) and Bangladeshi (+880) prefixes.

2. Webhook Ingestion HTTP Status Codes

Codes returned by ZeroRTO endpoints when couriers or Meta transmit events:

Verification Token Mismatch

HTTP 403 Forbidden

Meaning: Meta's webhook handshake GET request sent a hub_verify_token that does not match the token in your ZeroRTO settings.

Fix: Ensure the verify token in Meta Developer Configuration matches the wa_verify_token (default: rescuedrop_secret_ndr_token) in ZeroRTO settings.

No Matching WooCommerce Order Found

HTTP 404 Not Found

Meaning: The incoming webhook from Shiprocket or Delhivery contains an Order ID or AWB that does not exist in your store database.

Fix: Verify that your shipments in Shiprocket or Delhivery were booked with the real WooCommerce Order ID in the Channel Order ID / ReferenceNo field.

ZeroRTO License Revoked or Engine Disabled

HTTP 403 License Unauthorized

Meaning: The master toggle in ZeroRTO settings is disabled, or the license key assigned to your store domain has been suspended or expired.

Fix: Navigate to ZeroRTO > General Setup and verify that the Autonomous Interceptor toggle is set to Live and your license status is Active.

3. Cryptographic Signature Validation Failures

Payment Signature Mismatch / Verification Failed

HMAC Validation Rejected

Meaning: Razorpay, Cashfree, or Stripe sent a webhook notification, but the cryptographic HMAC signature calculated using your stored secret did not match the header signature.

Fix: Re-copy the Webhook Secret from your payment dashboard (e.g. Stripe whsec_... or Razorpay Webhook Secret) and paste it into ZeroRTO > COD to Prepaid tab.

4. 30-Second Store Health Audit

If you suspect any delivery failure alerts are not firing, check this 3-point checklist:

Health Bar Dots: In ZeroRTO > General Setup, verify that Courier Engine, WhatsApp Cloud API, and Prepaid Gateway all show green pulsing dots.
Cloudflare / Firewall: Ensure your server WAF does not block POST requests to https://yourstore.com/wp-json/rescuedrop/v1/*.
WooCommerce Order Notes: Open any order in WooCommerce admin. ZeroRTO writes all outgoing WhatsApp Message IDs and Meta error responses into private order notes for transparent tracking!

Meta & Webhook Error Codes Complete Triage