MAHMOUD ABDELNABY
Automation · PROJECT BLUEPRINT · 3

WhatsApp Lead Routing & Sales SLA Response Monitor

Distribute inbound WhatsApp leads fairly across your sales team and monitor response time SLAs with an open webhook routing architecture.

Problem it addresses

Build an open-source WhatsApp lead routing and SLA monitoring toolkit: 1) System architecture blueprint for automated round-robin lead assignment with working hours and capacity rules, 2) Python webhook simulation engine (lead_router.py) tracking message timestamps and flagging SLA breaches (>15 min), 3) Slack/Telegram notification templates for abandoned leads.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • architecture/lead-routing-blueprint.md
  • ARCHITECTURE.md
  • DATA_MODEL.md
  • examples/simulated_lead_event_stream.json
  • LICENSE
  • MONETIZATION.md
  • PRD.md
  • PROBLEM.md
  • README.md
  • ROADMAP.md
  • src/lead_router.py
  • src/sla_calculator.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/lead_router.py --help

Scope and limitations

  • Business Hours SLA Windows: Calculates response time latencies exclusively during active working hours, excluding overnight delays from agent performance metrics.
  • Round-Robin & Skill Routing: Distributes inbound chats across sales agents based on territory (KSA vs UAE vs Egypt) and product knowledge.
  • Webhook Queue Ingestion: Processes incoming Meta WhatsApp message status webhooks with deduplication to ensure accurate first-response timestamps.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories