Manage coupon campaigns and customer chats with WhatsApp and PostgreSQL

Description

Coupon Bot Dashboard & WhatsApp Management System A complete bilingual admin dashboard and WhatsApp bot solution for managing discount coupons, partner companies, and customer conversations through an intuitive web interface and automated chatbot. What does this workflow do? This workflow provides a comprehensive coupon management system with dual interfaces: a modern Vue.js admin dashboard for managers and an interactive WhatsApp bot for customers. It handles everything from company onboarding and coupon issuance to real-time customer support and conversation tracking. Key features: 🎛️ Admin Dashboard - Full-featured Vue.js 3 interface with Tailwind CSS for managing companies, coupons, and viewing analytics 🤖 WhatsApp Bot - Automated customer service bot with session-based state management 🏢 Company Management - CRUD operations for partner companies and their coupon catalogs 🎫 Advanced Coupon System - Support for percentage/fixed discounts, expiry dates, minimum purchase requirements, and maximum discount caps 💬 Real-time Inbox - Live chat interface for viewing customer conversation history 🌐 Bilingual Support - Full Arabic (RTL) and English interface support 📊 Analytics Dashboard - Track customers, messages, coupons issued, and partner companies 🔧 Database Tools - Built-in schema initialization and migration capabilities 👤 Role-Based Access - Separate admin and customer flows with phone number authentication Setup Requirements Integrations Needed: PostgreSQL - Primary database for all system data WhatsApp Business API - For customer bot interactions via Facebook Graph API n8n - Workflow automation platform (self-hosted or cloud) Credentials Required: PostgreSQL database credentials (host, port, database, user, password) WhatsApp Business API Bearer Token (Facebook Graph API v22.0) Phone Number ID from WhatsApp Business account How to Use Initial Setup: Import the workflow into your n8n instance Configure PostgreSQL credentials - Connect to your database (named "discounts DB" in the workflow) Configure WhatsApp credentials - Add your Facebook Graph API Bearer Token Initialize the database - Send POST request to /webhook/coupon-bot/execute-init to create all tables Set admin phone - Access dashboard at /webhook/coupon-bot/dashboard, go to Settings, and set your admin phone number Configure WhatsApp webhook - Point your WhatsApp Business webhook to /webhook/whatsapp Dashboard Access: URL**: /webhook/coupon-bot/dashboard Features**: Statistics, Company Management, Coupon Management, Inbox, System Settings Admin WhatsApp Commands: Once your phone is set as admin, send any message to the bot to access: Add/Edit/Delete Companies Add/Edit/Delete Coupons Edit Welcome/End Messages Browse as regular customer Workflow Structure 1. Dashboard Webhook (/coupon-bot/dashboard) Serves the complete Vue.js 3 admin interface with: Responsive RTL layout for Arabic Mobile-optimized sidebar navigation Real-time statistics cards Company and coupon management forms Interactive inbox with chat history System settings and database maintenance tools 2. API Endpoints (/coupon-bot/api/*) RESTful API routes for dashboard operations: POST /stats - System analytics (customers, messages, records, companies) POST /companies - CRUD operations for partner companies POST /coupons - CRUD operations with advanced fields (percentage, expiry, limits) POST /inbox - Retrieve unique customer conversations POST /history - Fetch complete chat history for a customer POST /settings - Manage admin phone and message templates POST /customers - Customer records retrieval POST /records - Coupon redemption tracking 3. Database Management (/coupon-bot/execute-init, /coupon-bot/migrate) Full Initialization** - Creates all tables: customers, companies, coupons, records, messages, settings, sessions Schema Migration** - Non-destructive updates to add missing columns and constraints Repair Tools** - Fixes corrupted data and ensures schema consistency 4. WhatsApp Bot Handler (/webhook/whatsapp) Processes incoming WhatsApp messages with: Authentication** - Detects admin vs. regular customers by phone number Session Management** - PostgreSQL-based state machine for multi-step conversations Interactive Messages** - List menus for company/coupon selection Message Logging** - All incoming/outgoing messages stored for inbox feature 5. Customer Flow (Regular Users) Receive welcome message from settings Browse list of partner companies Select company to view available coupons Choose coupon to receive details Get end message with coupon code and terms 6. Admin Flow (Authenticated Users) Access main management menu Manage companies (add, edit, delete) Manage coupons (add with advanced options, edit, delete) Customize welcome and end messages Test customer experience Database Schema customers customer_id (SERIAL PRIMARY KEY) name (VARCHAR 255) phone (VARCHAR 50, UNIQUE) selected_sites (TEXT) created_at (TIMESTAMP) updated_at (TIMESTAMP) companies company_id (SERIAL PRIMARY KEY) name (VARCHAR 255, NOT NULL) info (TEXT) coupons coupon_id (SERIAL PRIMARY KEY) company_id (INT, FOREIGN KEY) coupon_text (TEXT, NOT NULL) -- The actual coupon code coupon_value (NUMERIC 10,2) is_percentage (BOOLEAN DEFAULT FALSE) has_max (BOOLEAN DEFAULT FALSE) max_value (NUMERIC 10,2) is_max_percentage (BOOLEAN DEFAULT FALSE) has_min_purchase (BOOLEAN DEFAULT FALSE) min_purchase_value (NUMERIC 10,2) is_on_items_quantity (BOOLEAN DEFAULT FALSE) registration_date (TIMESTAMP) has_expiry (BOOLEAN DEFAULT FALSE) expiry_date (TIMESTAMP) other_info (TEXT) records record_id (SERIAL PRIMARY KEY) customer_id (INT, FOREIGN KEY) company_id (INT, FOREIGN KEY) coupon_id (INT, FOREIGN KEY) created_at (TIMESTAMP) messages message_id (SERIAL PRIMARY KEY) customer_id (INT, FOREIGN KEY, nullable) sender_phone (VARCHAR 50) sender_name (VARCHAR 255) external_message_id (VARCHAR 255) message_text (TEXT, NOT NULL) message_type (VARCHAR 50 DEFAULT 'text') direction (VARCHAR 20 DEFAULT 'INCOMING') is_from_customer (BOOLEAN DEFAULT TRUE) created_at (TIMESTAMP) settings key (VARCHAR 50 PRIMARY KEY) value (TEXT) -- Keys: admin_phone, welcome_message, end_message sessions phone (VARCHAR 50 PRIMARY KEY) state (VARCHAR 50, NOT NULL) data (JSONB DEFAULT '{}') last_updated (TIMESTAMP) Session States (State Machine) The bot uses PostgreSQL sessions for conversation persistence: IDLE - Default state, waiting for input WAITING_COMPANY_NAME - Admin adding new company WAITING_EDIT_COMPANY_SELECT - Admin selecting company to edit WAITING_EDIT_COMPANY_NAME - Admin entering new company name WAITING_DELETE_COMPANY_SELECT - Admin selecting company to delete WAITING_ADD_COUPON_COMPANY - Admin selecting company for new coupon WAITING_ADD_COUPON_TEXT - Admin entering coupon code WAITING_ADD_COUPON_VALUE - Admin entering discount value WAITING_EDIT_COUPON_SELECT - Admin selecting coupon to edit WAITING_EDIT_COUPON_TEXT - Admin entering new coupon code WAITING_DELETE_COUPON_SELECT - Admin selecting coupon to delete EDIT_WELCOME - Admin updating welcome message EDIT_END - Admin updating end message Message Templates Default Welcome Message (Customizable): Default End Message (Customizable): Customization Tips Add more languages**: Extend the dashboard and bot to support additional languages beyond Arabic/English Coupon restrictions**: Use the advanced coupon fields to set minimum purchase amounts, maximum discount caps, and expiry dates Analytics enhancement**: Add more statistics nodes to track coupon usage by company or time period Telegram integration**: Duplicate the WhatsApp webhook nodes and modify for Telegram Bot API Email notifications**: Add SMTP nodes to send coupon details via email Multi-admin support**: Modify the settings schema to support multiple admin phone numbers Coupon categories**: Add a categories table and filter coupons by category in the bot Use Cases Marketing agencies managing discount campaigns for multiple clients E-commerce platforms offering partner store coupons Loyalty programs with tiered discount systems Event-based promotional campaigns with expiry dates Multi-vendor marketplaces with individual seller coupons Customer retention programs with personalized offers Technical Notes Frontend**: Vue.js 3 (Composition API) + Tailwind CSS + Font Awesome icons Backend**: n8n workflow automation with PostgreSQL WhatsApp API**: Facebook Graph API v22.0 with interactive list messages Security**: Phone number-based admin authentication, SQL injection protection via parameterized queries Performance**: Database indexing on phone numbers and foreign keys, session cleanup recommended Mobile**: Fully responsive dashboard with mobile-optimized WhatsApp interactions Tags: #n8n #whatsapp #coupons #dashboard #vuejs #postgresql #automation #customer-service #bilingual. An n8n automation workflow template by Mira Melhem.

Categories

Tags

Capabilities

• 2 nodes
• 1 views