📦 Release v1.0.0 – Lead-to-WhatsApp Automation
✨ Overview
This is the first stable release of Lead-to-WhatsApp Automation, a zero-maintenance Cloudflare Worker designed to instantly capture Facebook/Instagram Lead Ads and initiate a human-like WhatsApp conversation flow — including optional email onboarding, delayed message sending, and intelligent follow-ups.
✅ Key Features
-
Webhook handshake for Meta (Facebook/Instagram) Lead Ads
-
Lead parsing and phone normalization from Graph API
-
Welcome email dispatch via Resend
-
Delayed WhatsApp greeting using template lead_benvenuto (30–90min after form submission)
-
24h & 15d follow-up logic if no user response
-
Automatic clean-up of expired leads from KV store
-
Bidirectional message relay with contextual awareness
-
24h window compliance for WhatsApp Cloud API
-
Failure notification to admin if WhatsApp delivery fails
-
Fully configurable via Wrangler secrets
🧪 How to Test
-
Use the Meta Lead Ads Testing Tool
-
Confirm welcome email is received (if email field exists)
-
Expect WhatsApp template message within ~30–90 min
-
Respond via WhatsApp and observe admin notification
-
Do not respond and validate follow-ups at:
-
+24h (default: 19:00 UTC+3)
-
+15 days
⚙️ Deployment Notes
-
Requires Cloudflare account with Workers enabled
-
Meta developer app with correct permissions and tokens
-
WhatsApp templates approved and configured
-
wrangler.toml + secrets ready
See README for full setup instructions.
📌 Known Limitations
-
Only works with WhatsApp-enabled phone numbers
-
Timezone-sensitive follow-up scheduling (adjust FOLLOWUP_HOUR as needed)
-
Does not currently support dynamic form mapping — field names must match (full_name, email, phone_number)
🧭 What's Next
-
🔄 Auto-refresh Meta Page token (optional cron job)
-
📊 Dashboard for lead status & response analytics
-
📬 Multiple message branches based on user tags or lead source
-
🔗 CRM/webhook integrations
© 2025 GM Vassago – Developed by Cristiano Mazzella
Licensed under MIT.