WhatsWay

Complete WhatsApp Business Platform

Powerful WhatsApp Business platform for efficient communication management

📱 Campaign Management 🤖 Automation Builder 📊 Team Inbox 📈 Analytics

📋 What is WhatsWay?

WhatsWay is a powerful WhatsApp Business platform that helps businesses manage WhatsApp communications efficiently. Send campaigns, manage inbox, create automations, and track performance - all in one place.

🎯 Perfect For

• Small to large businesses using WhatsApp for customer communication
• Marketing teams running WhatsApp campaigns
• Customer support teams managing inquiries
• Sales teams nurturing leads through WhatsApp

✨ Core Features

📊

Dashboard

Real-time statistics, campaign performance, system health monitoring, and comprehensive analytics.

👥

Contact Management

Import CSV files, add contacts manually, organize into groups, advanced filtering and segmentation.

🚀

Campaign Types

Contact campaigns, CSV campaigns, API campaigns, scheduled delivery, and marketing campaigns.

📝

Message Templates

Create WhatsApp templates with text, images, buttons, interactive elements, and multi-language support.

💬

Team Inbox

Real-time message management, conversation assignment, 24-hour response window, team collaboration.

🤖

Automation Builder

Visual drag-and-drop interface, trigger-based workflows, conditional logic, time delays.

👨‍💼

Team Management

Admin, Manager, and Agent roles with different access levels, permissions, and activity tracking.

📱

Multi-Channel Support

Manage multiple WhatsApp numbers, channel-specific data separation, unified dashboard.

📈

Advanced Analytics

Comprehensive reporting, delivery rates, engagement metrics, ROI tracking, performance insights.

📊 Main Dashboard

Real-time statistics showing campaign performance, message delivery rates, contact growth, team activity, and system health monitoring at a glance.

🚀 Campaign Management

Create and manage multiple campaign types: Contact-based campaigns, CSV upload campaigns, API integration campaigns, and scheduled campaigns with delivery time configuration.

💬 Team Inbox

Real-time message management with 24-hour response window. Assign conversations to team members, use quick replies, and manage customer communications efficiently .

🤖 Automation Builder

Visual drag-and-drop interface for creating trigger-based workflows with conditional logic, time delays, and keyword-based automated responses .

📋 Contact Management

Import contacts via CSV upload, add individual contacts manually, organize into groups, and use advanced filtering and segmentation options .

📝 Message Templates

Create WhatsApp message templates with text, images, buttons, and interactive elements. Submit templates for WhatsApp approval and track their status .

📈 Analytics Dashboard

Comprehensive analytics with message delivery rates, campaign performance metrics, user engagement tracking, and detailed reporting features .

🚀 Step by Step Setup Guide

📋 Step 1: System Requirements

💻 Server Requirements

• OS: Ubuntu 20.04+ / Windows Server 2019+ / macOS 10.15+
• Node.js: Version 18 or higher
• PostgreSQL: Version 14 or higher
• RAM: 2GB minimum (4GB recommended)
• Storage: 10GB minimum available space
• CPU: 2 cores minimum
• SSL Certificate: Required for webhooks

📱 Required Accounts

• WhatsApp Business Account
• Meta Business Account
• Facebook Developer Account
• Domain name with SSL certificate
• Email account for notifications

⚡ Step 2: Install Dependencies

For Ubuntu/Debian:

# Update system packages
sudo apt update && sudo apt upgrade -y

# Install Node.js 18
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

# Verify Node.js installation
node --version
npm --version

# Install PostgreSQL
sudo apt install -y postgresql postgresql-contrib

# Install PM2 (Process Manager)
sudo npm install -g pm2

# Install Nginx (for reverse proxy)
sudo apt install -y nginx

# Install certbot for SSL
sudo apt install -y certbot python3-certbot-nginx

🗃️ Step 3: Database Setup

# Switch to postgres user
sudo -u postgres psql

# Create database and user
CREATE DATABASE whatsway;
CREATE USER whatsway_user WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE whatsway TO whatsway_user;

# Exit PostgreSQL
\q

# Test database connection
psql -h localhost -U whatsway_user -d whatsway

⚠️ Important: Replace 'your_secure_password' with a strong password and save it safely !

📦 Step 4: Application Installation

# Navigate to your web directory
cd /var/www/

# Extract WhatsWay package (replace with your actual package)
sudo unzip whatsway.zip
sudo mv whatsway-main whatsway
sudo chown -R $USER:$USER whatsway
cd whatsway

# Install dependencies
npm install

# Set proper permissions
sudo chown -R $USER:$USER node_modules
chmod -R 755 .

⚙️ Step 5: Environment Configuration

# Copy environment template
cp .env.example .env

# Edit environment file
nano .env

Configure .env file:

# Database Configuration
DATABASE_URL=postgresql://whatsway_user:your_secure_password@localhost:5432/whatsway

# Session Configuration (Generate a random 32 character key)
SESSION_SECRET=your_32_character_secret_key_here

# WhatsApp Configuration (Get these from Facebook Developer Console)
WHATSAPP_API_VERSION=v23.0
WHATSAPP_ACCESS_TOKEN=your_whatsapp_permanent_token
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_account_id
WHATSAPP_WEBHOOK_VERIFY_TOKEN=your_custom_webhook_verify_token

# Application Configuration
APP_URL=https://your-domain.com
PORT=5000

# Debug Configuration (optional)
DEBUG=false
LOG_LEVEL=info

🔒 Step 6: SSL Certificate Setup

# Generate SSL certificate using Certbot
sudo certbot --nginx -d your-domain.com

# Configure Nginx for WhatsWay
sudo nano /etc/nginx/sites-available/whatsway

Nginx Configuration:

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name your-domain.com;
    
    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
    
    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

# Enable site and restart Nginx
sudo ln -s /etc/nginx/sites-available/whatsway /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

🔄 Step 7: Database Migration

# Navigate to WhatsWay directory
cd /var/www/whatsway

# Run database migrations
npm run db:push

# Verify database tables created
psql -h localhost -U whatsway_user -d whatsway -c "\dt"

✅ Success: You should see all WhatsWay tables created successfully !

🚀 Step 8: Build and Start Application

# Build the application
npm run build

# Start with PM2 (Production)
pm2 start ecosystem.config.js

# Or start directly (Development)
npm run dev

# Check PM2 status
pm2 status
pm2 logs whatsway

# Setup PM2 to start on boot
pm2 startup
pm2 save

📱 Step 9: WhatsApp Business Setup

6.1 Create Facebook Developer App

Go to developers.facebook.com
Create a new app → Business
Add WhatsApp product
Get your App ID and App Secret
Generate permanent access token

6.2 Configure Webhook

Go to WhatsApp → Configuration
Set webhook URL: https://your-domain.com/webhook
Set verify token (same as in .env)
Subscribe to message events
Add phone number and verify

📝 Note: Detailed WhatsApp Business API setup guide is available in the Meta Developer documentation.

🎉 Step 10: First Login & Testing

🔐 Default Login Credentials

• URL: https://your-domain.com

• Username: whatsway

• Password: Admin@123

⚠️ Important: Change password immediately after first login!

✅ Quick Test Checklist

• Successfully logged into admin panel
• Dashboard loads without errors
• Added WhatsApp channel successfully
• Webhook receiving test messages
• Can send test message

🛠️ Common Issues & Solutions

❌ Application won't start

• Check if PostgreSQL is running: sudo systemctl status postgresql
• Verify database connection in .env file
• Check if port 5000 is available: lsof -i :5000
• View application logs: pm2 logs whatsway

⚠️ Webhook not receiving messages

• Verify SSL certificate is valid
• Check webhook URL in Meta Developer Console
• Ensure webhook verify token matches .env
• Test webhook: curl -X GET "https://your-domain.com/webhook?hub.verify_token=your_token&hub.challenge=test"

ℹ️ Messages not sending

• Verify WhatsApp access token is valid
• Check if phone number is verified in Meta Business
• Ensure message template is approved
• Check rate limits and API quotas

📞 Support & Contact

📧 Getting Help

Ticket Support

Raise a ticket

When Reporting Issues Include:

• Detailed error messages
• Steps to reproduce the issue
• Environment details (OS, Node.js version)
• Log files (remove sensitive information)
• Screenshots if applicable