Chat.py

"""
WhatsApp Business API - Bulk & Single Message Sender
=====================================================
Requirements:
    pip install requests

Setup:
    1. Go to https://developers.facebook.com/ and create an app
    2. Add WhatsApp product to your app
    3. Get your ACCESS_TOKEN, PHONE_NUMBER_ID from the API setup page
    4. Verify recipient numbers (in sandbox, numbers must be verified)

Usage:
    python whatsapp_sender.py
"""

import requests
import json
import time

# ─────────────────────────────────────────────
#  CONFIGURATION — fill these in before running
# ─────────────────────────────────────────────
ACCESS_TOKEN    = "YOUR_WHATSAPP_ACCESS_TOKEN"   # From Meta Developer Console
PHONE_NUMBER_ID = "YOUR_PHONE_NUMBER_ID"          # From Meta Developer Console
API_VERSION     = "v19.0"

API_URL = f"https://graph.facebook.com/{API_VERSION}/{PHONE_NUMBER_ID}/messages"

HEADERS = {
    "Authorization": f"Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
}

# ─────────────────────────────────────────────
#  CORE FUNCTION — send a single message
# ─────────────────────────────────────────────
def send_message(to: str, message: str) -> dict:
    """
    Send a WhatsApp text message to a single number.

    Args:
        to      : Recipient phone number with country code, e.g. "919876543210"
        message : Text content to send

    Returns:
        dict with 'success' bool and 'response' or 'error'
    """
    payload = {
        "messaging_product": "whatsapp",
        "recipient_type": "individual",
        "to": to,
        "type": "text",
        "text": {
            "preview_url": False,
            "body": message
        }
    }

    try:
        response = requests.post(API_URL, headers=HEADERS, json=payload, timeout=15)
        data = response.json()

        if response.status_code == 200 and "messages" in data:
            print(f"  ✅ Sent to {to} | Message ID: {data['messages'][0]['id']}")
            return {"success": True, "response": data}
        else:
            error_msg = data.get("error", {}).get("message", "Unknown error")
            print(f"  ❌ Failed to send to {to} | Error: {error_msg}")
            return {"success": False, "error": error_msg}

    except requests.exceptions.RequestException as e:
        print(f"  ❌ Network error for {to} | {str(e)}")
        return {"success": False, "error": str(e)}


# ─────────────────────────────────────────────
#  SINGLE MESSAGE SENDER
# ─────────────────────────────────────────────
def send_single(to: str, message: str):
    """Send a message to one recipient."""
    print(f"\n📤 Sending single message to {to}...")
    result = send_message(to, message)
    return result


# ─────────────────────────────────────────────
#  BULK MESSAGE SENDER
# ─────────────────────────────────────────────
def send_bulk(contacts: list, message: str, delay_seconds: float = 1.0):
    """
    Send a message to multiple recipients.

    Args:
        contacts       : List of phone numbers, e.g. ["919876543210", "918765432109"]
        message        : Text content to send
        delay_seconds  : Delay between each message to avoid rate limiting (default 1s)

    Returns:
        Summary dict with success/failure counts
    """
    total   = len(contacts)
    success = 0
    failed  = 0
    errors  = []

    print(f"\n📦 Starting bulk send to {total} contact(s)...\n{'-'*40}")

    for index, number in enumerate(contacts, start=1):
        print(f"[{index}/{total}] Sending to {number}...")
        result = send_message(number, message)

        if result["success"]:
            success += 1
        else:
            failed += 1
            errors.append({"number": number, "error": result.get("error")})

        # Delay between messages to respect API rate limits
        if index < total:
            time.sleep(delay_seconds)

    # Summary
    print(f"\n{'='*40}")
    print(f"📊 Bulk Send Summary")
    print(f"  Total    : {total}")
    print(f"  ✅ Success: {success}")
    print(f"  ❌ Failed : {failed}")
    if errors:
        print(f"\n  Failed Numbers:")
        for e in errors:
            print(f"    - {e['number']}: {e['error']}")
    print(f"{'='*40}\n")

    return {"total": total, "success": success, "failed": failed, "errors": errors}


# ─────────────────────────────────────────────
#  INTERACTIVE CLI
# ─────────────────────────────────────────────
def interactive_mode():
    print("=" * 45)
    print("  WhatsApp Business API - Message Sender")
    print("=" * 45)
    print("  1. Send Single Message")
    print("  2. Send Bulk Messages")
    print("  3. Exit")
    print("-" * 45)

    choice = input("Select an option (1/2/3): ").strip()

    if choice == "1":
        to      = input("Enter recipient phone (with country code, e.g. 919876543210): ").strip()
        message = input("Enter your message: ").strip()
        send_single(to, message)

    elif choice == "2":
        print("\nEnter recipient phone numbers (with country code).")
        print("Type 'done' when finished.\n")
        contacts = []
        while True:
            num = input(f"  Number {len(contacts)+1}: ").strip()
            if num.lower() == "done":
                break
            if num:
                contacts.append(num)

        if not contacts:
            print("⚠️  No contacts entered. Exiting.")
            return

        message = input("\nEnter your message: ").strip()
        delay   = input("Delay between messages in seconds (default 1): ").strip()
        delay   = float(delay) if delay else 1.0

        send_bulk(contacts, message, delay_seconds=delay)

    elif choice == "3":
        print("Goodbye!")

    else:
        print("⚠️  Invalid option. Please run the script again.")


# ─────────────────────────────────────────────
#  EXAMPLE: Programmatic usage
# ─────────────────────────────────────────────
def example_usage():
    """
    Example of how to use the functions directly in code.
    Comment out interactive_mode() below and uncomment this to use.
    """
    # Single message
    send_single(
        to="919876543210",
        message="Hello! This is a single test message from WhatsApp Business API."
    )

    # Bulk messages
    numbers = [
        "919876543210",
        "918765432109",
        "917654321098",
    ]
    send_bulk(
        contacts=numbers,
        message="Hello! This is a bulk message from WhatsApp Business API.",
        delay_seconds=1.5
    )


# ─────────────────────────────────────────────
#  ENTRY POINT
# ─────────────────────────────────────────────
if __name__ == "__main__":
    interactive_mode()

    # To use programmatic mode instead, comment the line above
    # and uncomment the line below:
    # example_usage()