MansourDch/multi-channel-darija-sales-bot

A flexible multi-channel sales bot for WhatsApp, Facebook Messenger, and Instagram. Responds in Moroccan Darija, answers customer questions, shows product catalog with photos, and collects order confirmations. Payment handled via cash-on-delivery. AI-powered with human escalation for complex inquiries. # multi-channel-darija-sales-bot A flexible, AI-powered multi-channel sales bot that responds in **Moroccan Darija**. Designed to handle customer inquiries, show product catalogs, collect orders, and manage order confirmations across **WhatsApp**, **Facebook Messenger**, and **Instagram**. ## 🎯 Features ✅ **Multi-Channel Support** - WhatsApp Business API - Facebook Messenger - Instagram Direct Messages ✅ **Moroccan Darija Support** - Responds natively in Darija (Moroccan Arabic) - Supports Darija-French-English code-switching - Easily customizable response scripts ✅ **Sales Automation** - Product catalog display with images - Quantity selection and order confirmation - Collect delivery address and phone number - Cash-on-delivery order management - Cart management system ✅ **Smart Conversation Flow** - Intent detection (price inquiry, product selection, order) - State-machine based conversation management - Natural language understanding in Darija - Fallback and escalation to human support ✅ **Flexible & Extensible** - JSON-based product catalog - Easy-to-customize Darija scripts - Modular architecture - Simple integration with databases - OpenAI API ready for advanced NLP ## 📋 Prerequisites - **Node.js** v14 or higher - **npm** or **yarn** - API credentials for: - WhatsApp Business API - Facebook App (Messenger + Instagram) - OpenAI (optional, for advanced features) ## 🚀 Quick Start ### 1. Clone the Repository ```bash git clone github.com cd multi-channel-darija-sales-bot ``` ### 2. Install Dependencies ```bash npm install ``` ### 3. Configure Environment Variables Copy `.env.example` to `.env` and fill in your API credentials: ```bash cp .env.example .env ``` Edit `.env` with: ```env # WhatsApp WHATSAPP_API_TOKEN=your_token WHATSAPP_PHONE_NUMBER_ID=your_phone_id # Facebook Messenger & Instagram FACEBOOK_PAGE_ACCESS_TOKEN=your_token FACEBOOK_APP_SECRET=your_secret FACEBOOK_VERIFY_TOKEN=your_ver …