0x-Mrcoder/forbill-whatsapp-bot

🎉 ForBill WhatsApp VTU Bot - AI-driven instant VTU services for airtime, data, electricity & TV subscriptions in Nigeria # ForBill WhatsApp VTU Bot 🎉 **ForBill** is an AI-driven WhatsApp bot for instant VTU (Virtual Top-Up) services including airtime, data bundles, electricity bills, and TV subscriptions. ## 🚀 Features ### 📱 VTU Services - **Airtime Top-up**: All Nigerian networks (MTN, Airtel, GLO, 9Mobile) - **Data Bundles**: Multiple plans for all networks - **Electricity Bills**: Coming soon - **TV Subscriptions**: Coming soon ### 🤖 WhatsApp Bot Features - **Natural Language Processing**: Rule-based intent recognition - **Multi-step Conversations**: Guided transaction flows - **Wallet System**: User balance management - **Transaction Tracking**: Complete audit trail - **Real-time Notifications**: Success/failure messages ### 🏗️ Technical Stack - **Backend**: Laravel 11.x - **Database**: SQLite (production ready for PostgreSQL/MySQL) - **WhatsApp API**: Meta WhatsApp Cloud API - **Payment Gateway**: Paystack/Flutterwave ready - **VTU Integration**: Multiple provider support ## 📋 Prerequisites - PHP 8.3+ - Composer - Laravel 11.x - WhatsApp Business API access - Meta Developer Account ## 🔧 Installation ### 1. Clone Repository ```bash git clone github.com cd forbill-whatsapp-bot ``` ### 2. Install Dependencies ```bash composer install ``` ### 3. Environment Setup ```bash cp .env.example .env php artisan key:generate ``` ### 4. Configure Environment Variables ```env # WhatsApp Cloud API Configuration WHATSAPP_TOKEN=your_access_token WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id WHATSAPP_WEBHOOK_VERIFY_TOKEN=your_verify_token WHATSAPP_API_VERSION=v22.0 # Payment Gateway (Optional) PAYSTACK_PUBLIC_KEY=pk_test_your_public_key PAYSTACK_SECRET_KEY=sk_test_your_secret_key # VTU Provider (Configure with your provider) VTU_PROVIDER_BASE_URL=api.vtuprovider.com VTU_PROVIDER_API_KEY=your_vtu_api_key VTU_PROVIDER_SECRET_KEY=your_vtu_secret ``` ### 5. Database Setup ```bash p …