Parent sends message → Webhook receives it → Bot processes intent
    ├── FAQ question → Instant answer from knowledge base
    ├── Demo class request → Show available slots → Book → Confirm
    ├── Fee enquiry → Share fee structure → Offer brochure
    ├── Complex question → Hand off to human counsellor
    └── Lead qualification → Score → Route to counsellor dashboard

{
  "fees": {
    "question": "What are the fees?",
    "answer": "Our JEE 2-year program is ₹85,000 (or ₹7,500/month for 12 months). NEET is ₹80,000. We offer a 10% early-bird discount if you enrol before March 31.",
    "follow_up": "Would you like to see the detailed fee structure?"
  },
  "demo_class": {
    "question": "Is there a demo class?",
    "answer": "Yes! We run demo classes every Saturday and Sunday at 10 AM and 4 PM. Would you like me to book a slot for you?",
    "follow_up": "Which day works better for you?"
  },
  "faculty": {
    "question": "Who are the faculty?",
    "answer": "Our core team includes IIT Delhi and AIIMS graduates with 8+ years of teaching experience. You can view full profiles on our website or I can share a PDF."
  }
}

from flask import Flask, request, jsonify
import requests
import json

app = Flask(__name__)

# Your WhatsApp Business API credentials
PHONE_NUMBER_ID = "your_phone_number_id"
ACCESS_TOKEN = "your_access_token"
API_URL = f"https://graph.facebook.com/v18.0/{PHONE_NUMBER_ID}/messages"

# Knowledge base (load from JSON file in production)
KNOWLEDGE_BASE = {
    "fees": "Our JEE 2-year program is ₹85,000 (₹7,500/month for 12 months). NEET is ₹80,000. 10% early-bird discount before March 31.",
    "demo": "Demo classes run every Saturday and Sunday at 10 AM and 4 PM. Shall I book a slot?",
    "timings": "Morning batch: 7-9 AM. Evening batch: 5-7 PM. Weekend batch: 10 AM-1 PM.",
    "faculty": "Our core team includes IIT Delhi and AIIMS graduates with 8+ years of experience.",
    "results": "Last year: 47 selections in IIT-JEE, 23 in NEET. 92% of our students scored above 90 percentile.",
    "online": "Yes, we offer live online batches with the same faculty. Recordings available 24/7.",
    "emi": "Yes, we offer 0% EMI for 6, 9, and 12 months through our payment partners."
}

# Lead scoring state (use Redis/DB in production)
lead_scores = {}

@app.route("/webhook", methods=["POST"])
def webhook():
    data = request.json

    # Extract message details
    try:
        entry = data["entry"][0]["changes"][0]["value"]
        messages = entry["messages"][0]
        sender = messages["from"]
        message_body = messages["body"]["text"].lower()
    except (KeyError, IndexError):
        return jsonify({"status": "ok"}), 200

    # Score the lead
    score = score_lead(sender, message_body)

    # Determine response
    response = generate_response(message_body, score)

    # Send reply
    send_whatsapp_message(sender, response)

    # If hot lead, notify counsellor
    if score >= 7:
        notify_counsellor(sender, score, message_body)

    return jsonify({"status": "ok"}), 200


def score_lead(sender, message):
    """Score lead based on intent signals."""
    if sender not in lead_scores:
        lead_scores[sender] = {"score": 0, "interactions": 0}

    lead_scores[sender]["interactions"] += 1

    # High-intent keywords
    hot_signals = ["demo", "enroll", "admission", "fees", "book", "join", "batch"]
    warm_signals = ["timing", "faculty", "result", "online", "emi", "location"]

    for keyword in hot_signals:
        if keyword in message:
            lead_scores[sender]["score"] += 3

    for keyword in warm_signals:
        if keyword in message:
            lead_scores[sender]["score"] += 1

    return lead_scores[sender]["score"]


def generate_response(message, score):
    """Generate contextual response based on message content."""

    # Check for FAQ matches
    for key, answer in KNOWLEDGE_BASE.items():
        if key in message:
            return answer

    # Demo class booking flow
    if "demo" in message or "book" in message:
        return (
            "Great! Here are available demo class slots:\n\n"
            "📅 Saturday, 10 AM — Physics (Mechanics)\n"
            "📅 Saturday, 4 PM — Chemistry (Organic)\n"
            "📅 Sunday, 10 AM — Mathematics (Calculus)\n"
            "📅 Sunday, 4 PM — Biology (Genetics)\n\n"
            "Reply with your preferred slot and I'll confirm your booking."
        )

    # Greeting
    if any(word in message for word in ["hi", "hello", "hey", "namaste"]):
        return (
            "Hello! 👋 Welcome to [Your Institute Name]. I'm here to help with:\n\n"
            "1️⃣ Course details & fees\n"
            "2️⃣ Batch timings\n"
            "3️⃣ Demo class booking\n"
            "4️⃣ Faculty information\n"
            "5️⃣ Results & success stories\n\n"
            "What would you like to know?"
        )

    # Default: hand off to human
    return (
        "Thanks for your message! Let me connect you with a counsellor "
        "who can help you better. They'll be with you shortly. 🙏"
    )


def send_whatsapp_message(to, text):
    """Send message via WhatsApp Business API."""
    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "text",
        "text": {"body": text}
    }
    requests.post(API_URL, headers=headers, json=payload)


def notify_counsellor(sender, score, message):
    """Notify counsellor about hot lead via internal system."""
    # In production: send to Slack, email, or CRM
    print(f"🔥 HOT LEAD: {sender} | Score: {score} | Message: {message}")


@app.route("/webhook", methods=["GET"])
def verify_webhook():
    """Verify webhook during Meta app setup."""
    verify_token = "your_verify_token"
    mode = request.args.get("hub.mode")
    token = request.args.get("hub.verify_token")
    challenge = request.args.get("hub.challenge")

    if mode == "subscribe" and token == verify_token:
        return challenge, 200
    return "Forbidden", 403


if __name__ == "__main__":
    app.run(port=5000, debug=True)

def send_demo_booking_options(to):
    """Send interactive demo class booking buttons."""
    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "interactive",
        "interactive": {
            "type": "button",
            "header": {
                "type": "text",
                "text": "Demo Class Booking"
            },
            "body": {
                "text": "Choose your preferred demo class slot:"
            },
            "action": {
                "buttons": [
                    {
                        "type": "reply",
                        "reply": {"id": "sat_10am", "title": "Sat 10 AM"}
                    },
                    {
                        "type": "reply",
                        "reply": {"id": "sat_4pm", "title": "Sat 4 PM"}
                    },
                    {
                        "type": "reply",
                        "reply": {"id": "sun_10am", "title": "Sun 10 AM"}
                    },
                    {
                        "type": "reply",
                        "reply": {"id": "sun_4pm", "title": "Sun 4 PM"}
                    }
                ]
            }
        }
    }
    requests.post(API_URL, headers=headers, json=payload)

def send_demo_confirmation(to, slot, student_name):
    """Send demo class confirmation with details."""
    message = (
        f"✅ Demo Class Booked!\n\n"
        f"📅 Slot: {slot}\n"
        f"👤 Student: {student_name}\n"
        f"📍 Venue: [Your Institute Address]\n"
        f"🔗 Google Maps: [map_link]\n\n"
        f"You'll receive a reminder 24 hours before the demo. "
        f"See you there! 🎯"
    )
    send_whatsapp_message(to, message)

import schedule
import time
from datetime import datetime, timedelta

def send_reminders():
    """Send reminders to all demo bookings."""
    # In production: query your database for upcoming demos
    upcoming_demos = get_todays_demos()  # Your DB query

    for demo in upcoming_demos:
        hours_until = (demo["datetime"] - datetime.now()).total_seconds() / 3600

        if 23 <= hours_until <= 25:
            # 24-hour reminder
            send_whatsapp_message(
                demo["phone"],
                f"⏰ Reminder: Your demo class is tomorrow at {demo['time']}.\n\n"
                f"📍 Venue: {demo['venue']}\n"
                f"👨‍🏫 Faculty: {demo['faculty']}\n\n"
                f"Please arrive 15 minutes early. See you there!"
            )

        elif 1 <= hours_until <= 3:
            # 2-hour reminder
            send_whatsapp_message(
                demo["phone"],
                f"🚀 Your demo class starts in 2 hours!\n\n"
                f"📍 {demo['venue']}\n"
                f"🗺️ Maps: {demo['maps_link']}\n\n"
                f"Pro tip: Bring your last exam paper for a free analysis."
            )

NURTURE_SEQUENCE = [
    {
        "day": 1,
        "delay_hours": 2,
        "message": (
            "Hi {parent_name}! 👋\n\n"
            "We loved having {student_name} at today's demo class. "
            "{faculty_name} specifically mentioned how attentively "
            "{student_name} followed the {topic} session.\n\n"
            "Any questions about the course structure or fees? "
            "I'm right here. 😊"
        )
    },
    {
        "day": 3,
        "delay_hours": 72,
        "message": (
            "Hi {parent_name}! Quick update — our last batch had "
            "47 IIT-JEE selections and 23 NEET selections. 🎯\n\n"
            "Here's what one of our students said about their journey:\n"
            "\"The structured approach and daily practice problems "
            "made all the difference.\" — Rahul, IIT Delhi CSE\n\n"
            "Would you like to see the detailed results?"
        )
    },
    {
        "day": 7,
        "delay_hours": 168,
        "message": (
            "Hi {parent_name}! 📢\n\n"
            "Batch {batch_name} is filling up — only {seats_left} "
            "seats remaining. If you're still deciding, this might help:\n\n"
            "✅ 10% early-bird discount (valid until {deadline})\n"
            "✅ 0% EMI available\n"
            "✅ First week money-back guarantee\n\n"
            "Want me to hold a seat for {student_name}?"
        )
    },
    {
        "day": 14,
        "delay_hours": 336,
        "message": (
            "Hi {parent_name} 🙏\n\n"
            "This is probably my last follow-up — I don't want to "
            "pester you! But I genuinely believe [Institute Name] "
            "would be the right fit for {student_name}.\n\n"
            "If you have any last questions, I'm here. And if the "
            "timing isn't right, no worries at all — we'll be here "
            "when you're ready. 😊"
        )
    }
]

QUALIFICATION_QUESTIONS = [
    {
        "question": "Which class is your child currently in?",
        "options": ["Class 9", "Class 10", "Class 11", "Class 12", "Dropper"]
    },
    {
        "question": "Which exam are you preparing for?",
        "options": ["JEE Main", "JEE Advanced", "NEET", "CUET", "Board Exams"]
    },
    {
        "question": "What's your preferred mode?",
        "options": ["Offline", "Online", "Hybrid"]
    },
    {
        "question": "When are you planning to start?",
        "options": ["This month", "Next month", "Just exploring"]
    }
]