AutomationSTATUS: Open Source 1 0

WhatsApp Automation Hub

NLP-powered customer interaction orchestrator

A robust Python backend designed to process concurrent WhatsApp Webhooks at scale. By leveraging NLP classification and Redis state management, it automates routine support queries and appointment scheduling while providing clear fallback mechanisms for human agents.

Inspect GitHub Source Code

01 // THE BUSINESS PROBLEM & SITUATION

Operational Context

Service businesses relying on WhatsApp faced severe response bottlenecks during peak business hours due to repetitive manual queries.

CLIENT / ENVIRONMENT: Created for service businesses (clinics, consultancies) using WhatsApp as their primary client communication channel.

02 // SYSTEM ARCHITECTURE & SOLUTION

What Was Built

Built a scalable webhook orchestrator using Python and FastAPI. The system classifies incoming intent and dispatches pre-defined logical flows, escalating complex cases to human staff.

whatsapp-orchestrator-ai.sysAutomation

VERIFIED ARCHITECTUREWhatsApp Automation Hub

SYSTEMS_ARCHITECTURE_EXPLODER // LAYERED_STACKFULL-STACK SYSTEM DECOUPLING

Frontend Layer

Next.js 16 App Router, React 19, Tailwind CSS, TypeScript

API & Middleware

FastAPI, Pydantic Schema Validation, Rate Limiters

Orchestration

LangGraph Multi-Agent Supervisor & State Machines

Model Providers

OpenAI GPT-4o, Anthropic Claude 3.5, Vision AI

Data Stores

PostgreSQL (Prisma), Qdrant Vector Store, Redis Caching

Observability

LangSmith traces, Pydantic audit logs, Error retries

03 // ENGINEERING CONTRIBUTION & FEATURES

Exact Contribution

Developed the high-throughput FastAPI webhook receiver
Implemented the NLP intent classification module
Built a Redis-based session state store
Designed the human-agent escalation protocol

Key Capabilities Built

✓ Instant Intent Classification

✓ Redis Session State Management

✓ Human-Agent Handoff Protocol

✓ Automated Appointment Flow

DATA_PROVENANCE_TIMELINE // AUDIT_TRACETRACE_ID: #TR-992041

14:22:01.002Source Ingestion

Received webhook from lead submission formOK

14:22:01.045Schema Sanitization

Pydantic validated 12 extracted fieldsOK

14:22:01.210LangGraph Reasoning

Score intent = 0.94 (Tier A Lead)OK

14:22:01.350Human Audit Check

Confidence threshold passed (>0.85)PASSED

14:22:01.480CRM Commit

Created contact ID #884920 in PostgreSQLCOMMITTED

04 // EXECUTION PIPELINE

Step-by-Step Workflow

STEP 01Client sends a WhatsApp message.

STEP 02Webhook payload is parsed and validated.

STEP 03Intent classifier categorizes the message goal.

STEP 04Redis state machine maintains conversational context.

STEP 05Automated response or human escalation is dispatched.

05 // ENGINEERING LESSONS & OUTCOMES

Technical Challenges Overcome

• Maintaining conversational memory across asynchronous webhook callbacks.
• Gracefully handling low-confidence classifier predictions.

Measurable Outcomes

→ Automated tier-1 FAQ responses with sub-second response times.

→ Standardized Redis state persistence across distributed worker instances.

Lessons & Engineering Rules

"Stateless webhook handlers require explicit caching layers for conversational continuity."
"Fallback paths must be triggered instantly when intent confidence drops below threshold."

NEXT RELATED CASE STUDY

Competitor Tracking Engine

View Study

PROJECT METADATA

ARSLAN'S ROLEBackend Automation Engineer

YEAR & STATUS2025 // Open Source

CATEGORYAutomation

TECHNOLOGY STACK

PythonWhatsApp Business APIFastAPIRedisNLP

GITHUB METRICS

Stars: 1

Forks: 0

Verified GitHub Update: 7/17/2026

Need a similar solution?

If your business faces similar data, automation, or software bottlenecks, let's discuss your requirements.

Start a Conversation