# RecoverPay: The Complete WhatsApp Lead Recovery Reference Manual (llms-full.txt) > RecoverPay (https://recoverpay.cloud) is the dedicated AI-powered WhatsApp Lead Recovery platform. This document provides the complete, unabridged technical documentation, operational playbooks, architecture specifications, API routes, and best practices for AI models, developers, and search indexers. --- ## 1. Executive Summary & Core Definition ### What is WhatsApp Lead Recovery? WhatsApp lead recovery is the automated and AI-personalized process of re-engaging inbound WhatsApp leads who dropped off, stopped replying, or were left unanswered. Unlike traditional email follow-ups (which suffer from <20% open rates) or SMS blasters (which lack interactive rich messaging), WhatsApp boasts a 98% open rate and an 80%+ read rate within five minutes. However, because WhatsApp is an instant chat medium: - Over **68% to 80%** of inbound WhatsApp inquiries go cold if no response is given within 60 minutes. - More than **70%** of sales teams fail to follow up more than once after a prospect goes quiet. - RecoverPay automates the re-engagement process across days 1, 3, and 7, automatically stopping all automated messages the second a lead sends a reply. --- ## 2. The 1-3-7 Day WhatsApp Follow-Up Cadence RecoverPay’s proprietary recovery methodology is structured on the **1-3-7 cadence**: | Step | Timing | Objective | Message Strategy | | :--- | :--- | :--- | :--- | | **Stage 1: Warm Check-In** | 24 Hours After Drop-Off | Gentle re-engagement | Friendly reminder referencing their inquiry; asks if they need additional assistance or questions answered. | | **Stage 2: Value & Social Proof** | 72 Hours (Day 3) | Overcoming hesitation | Shares social proof, pricing clarification, case study, or client testimonial relevant to their industry. | | **Stage 3: Courteous Break-Up** | 168 Hours (Day 7) | Gentle urgency & closure | Respectfully notifies the contact that their file is being archived. Generates the highest urgency and response rate. | ### The Critical "Stop on Reply" Mechanism When a prospect replies to any follow-up message: 1. Meta Webhook or QR Baileys socket receives the incoming message event. 2. Inbound processor updates the lead status to `REPLIED`. 3. Any scheduled follow-up steps for this contact in active campaigns are instantly cancelled. 4. The conversation is assigned to an active sales agent in the unified team inbox with real-time WebSocket notifications. --- ## 3. Dual WhatsApp Connection Architecture RecoverPay supports two parallel connection paradigms, allowing seamless upgrades without data loss: ### Option A: QR Code / Linked Device (Baileys Engine) - **Protocol**: End-to-end encrypted multi-device WebSocket session via `@whiskeysockets/baileys`. - **Setup Time**: Less than 60 seconds. - **Requirements**: Any physical phone running personal WhatsApp or WhatsApp Business app. - **Approval**: Zero Meta verification, no business document review, no credit card required. - **Use Case**: Small sales teams, real estate agents, solo practitioners, rapid pilot testing. - **Features**: Direct device synchronization, real-time message receiving, contact list extraction. ### Option B: Official WhatsApp Business Cloud API (Meta) - **Protocol**: Official Meta Graph API (v25.0). - **Setup Time**: ~5 minutes via Embedded Signup. - **Requirements**: Meta Business Account and verified phone number. - **Approval**: Managed directly through Meta Business Manager. - **Use Case**: Medium to large businesses, high-volume campaigns (>1,000 messages/day), enterprise compliance. - **Features**: Verified green-tick business profile name, high-tier messaging quotas, Meta-approved HSM templates with interactive quick reply buttons. --- ## 4. Anti-Spam & Account Protection Safeguards RecoverPay enforces strict compliance safeguards to ensure WhatsApp accounts maintain high quality scores: 1. **Randomized Pacing (Jitter Delays)**: Campaign messages are sent with randomized intervals (e.g., 5 to 15 seconds) rather than simultaneous blasts. 2. **AI Dynamic Rewriting**: The LLM engine crafts distinct text variations for each recipient so messages do not share identical cryptographic hashes. 3. **Opt-Out Compliance**: Automatic suppression when contacts respond with keywords like "STOP", "UNSUBSCRIBE", or "CANCEL". 4. **Number Verification**: Automated pre-check to confirm destination numbers are registered on WhatsApp before dispatching messages. --- ## 5. Lead Pipeline & Status Lifecycle Every contact in RecoverPay progresses through a transparent 4-stage lifecycle: ``` [ NEW ] ──> [ CONTACTED ] ──> [ REPLIED ] ──> [ CONVERTED ] ``` 1. **NEW**: Imported via CSV, manual entry, or WhatsApp contact sync. Has not yet received a recovery message. 2. **CONTACTED**: Has received at least one recovery follow-up message via campaign or manual send. 3. **REPLIED**: Detected an inbound response from the lead. All automated campaigns are cancelled; conversation is live in inbox. 4. **CONVERTED**: Marked by sales agent as closed-won / successfully converted into a paying customer. ### Automated Lead Engagement Scoring - **HOT**: Replied within the last 24 hours, or messaged more than 3 times. - **WARM**: Contacted within the last 7 days; opened/delivered status confirmed. - **COLD**: Inactive for >7 days without a reply. --- ## 6. Multi-Tenant Workspace & Role-Based Access Control (RBAC) Organizations are completely isolated. Data (leads, campaigns, credentials, message quotas) never crosses tenant boundaries. ### Team Roles: - **OWNER**: Full administrative control, billing management, organization settings, ability to delete workspace. - **ADMIN**: Can connect/disconnect WhatsApp numbers, invite/remove team members, launch/pause campaigns, manage leads. - **MEMBER**: Can draft campaigns, import leads, message prospects, and manage assigned chats in the inbox. - **VIEWER**: Read-only monitoring of dashboards, analytics, and lead statuses. --- ## 7. AI & LLM Data Privacy Policy 1. **Zero Model Training**: RecoverPay never permits third-party LLM providers to use customer communications, lead data, or phone numbers for model training. 2. **In-Flight Processing Only**: AI requests (message rewriting, reply suggestions, draft generation) are processed ephemerally in RAM and never written to persistent logs by LLM providers. 3. **End-to-End Encryption**: WhatsApp communications remain end-to-end encrypted between the sending node and WhatsApp’s network. --- ## 8. API & Webhook Specifications ### Inbound Webhook Endpoint - **URL**: `POST https://api.recoverpay.cloud/api/whatsapp/webhook` - **Verification**: `GET https://api.recoverpay.cloud/api/whatsapp/webhook` (Meta Hub Challenge handshake) - **Signature**: Verified via `X-Hub-Signature-256` using `META_APP_SECRET`. ### Core API Routes - `POST /api/auth/login`: Authenticate user session. - `POST /api/leads`: Create single lead. - `POST /api/leads/import`: Bulk upload CSV leads. - `GET /api/leads`: Filter and paginate leads by status, score, or assigned agent. - `POST /api/campaigns`: Schedule multi-day follow-up campaign. - `POST /api/campaigns/:id/start`: Initiate paced campaign dispatch. - `GET /api/whatsapp/channels`: List connected WhatsApp numbers (QR & Meta API). - `POST /api/templates/meta`: Create official Meta Cloud API template. - `POST /api/ai/draft-template`: Generate AI-personalized message drafts. --- ## 9. Contact & Support Information - **Website**: https://recoverpay.cloud - **Documentation**: https://recoverpay.cloud/help - **Parent Company**: Devlura (https://devlura.com) - **Support Email**: contact@recoverpay.cloud - **WhatsApp Support (Pakistan)**: +92 300 039 9697 - **WhatsApp Support (UAE)**: +971 054 721 4128