Troubleshooting & FAQs - ZeroRTO Documentation

ZeroRTO Self-Healing Diagnostics

Automatic Logging, Cryptographic Guardrails & Asynchronous Fallbacks

Zero Lockouts Self-Healing Engine

1. Diagnostic Playbook (Root Cause & Solutions)

Most issues can be solved immediately by checking these 4 areas:

WhatsApp Alert Not Reaching Customer

Meta Graph API

Root Cause: Either your Meta Permanent Access Token was generated with missing permissions (requires whatsapp_business_messaging), the customer's phone number is missing country code, or you tried sending plain text outside the 24-hour customer session window.

Solution: Ensure your phone numbers include the country code (e.g. +91 for India or +880 for Bangladesh). Use the Live WhatsApp Simulator under the WhatsApp Cloud API tab to test delivery on your personal mobile.

Meta Says "The URL couldn't be validated"

Firewall / WAF Block

Root Cause: Cloudflare Bot Fight Mode, Wordfence Firewall, or an aggressive web hosting security rule is intercepting Meta's verification GET query before it reaches WordPress.

Solution: Whitelist the URL path /wp-json/rescuedrop/v1/* in your Cloudflare WAF Rules or WordPress firewall plugin to allow incoming courier and Meta POST/GET events.

Shiprocket / Courier Action Failed (401 Unauthorized)

Courier Auth

Root Cause: Your logistics API session was terminated remotely due to a password change or security policy refresh on the courier portal.

Solution: ZeroRTO automatically catches 401 statuses, purges the invalid transient token, and re-authenticates. You can also re-enter your API email and password in ZeroRTO > Courier Networks and click Save to force an immediate refresh.

Customer Paid Online, But Order Remains COD

Payment Webhooks

Root Cause: Missing Webhook Signing Secret (e.g. Razorpay secret or Stripe whsec_...), causing cryptographic signature validation to fail safely.

Solution: Verify that the secret key configured in your payment gateway dashboard matches the signing secret entered in ZeroRTO > COD to Prepaid tab.

2. Frequently Asked Questions (FAQs)

Answers to the most common questions from eCommerce store owners:

Does ZeroRTO charge per WhatsApp message?

No! ZeroRTO uses a pure "Bring Your Own Key" (BYOK) architecture. You connect your official Meta Cloud API directly. Meta provides 1,000 free service conversations every month, and beyond that, Meta bills you at their standard wholesale rate with zero markup from ZeroRTO.

What happens after the 90-Day VIP Pass ends?

Zero risk! If you choose not to upgrade to an extended enterprise plan, your store smoothly rolls over to the Basic Community Edition automatically. Your store is never locked out, and no hidden credit card charges occur.

Can I switch couriers on the Basic Plan?

On the Basic Community plan, you are entitled to 1 permanently locked courier. If you need multi-carrier failover routing (e.g. running Shiprocket and Delhivery simultaneously), Connected Pro is required.

Will ZeroRTO slow down my WooCommerce admin?

Never. ZeroRTO was architected specifically for speed: database queries use lightweight index lookups, license checks run asynchronously in background cron tasks, and full compatibility with WooCommerce HPOS custom order tables is declared natively.

Troubleshooting & FAQs Instant Fixes