anilmathewm/wcloud-whatsapp-api repository overview

⁠🚀 WhatsApp Business API - No Code Self-Hosted Solution | WCloud Docker

🎯 License Type	💰 Cost	⏱️ Duration	📧 Request
🧪 Developer	FREE	90 days
⚡ Testing	FREE	90 days
🎓 Educational	FREE	90 days
💼 Commercial	$3/month	Unlimited

⁠Dashboard

⁠Nocode Botflow builder

Transform your business communication with the most powerful, easy-to-use WhatsApp Business API platform. Deploy in minutes, not months. Start FREE forever with 1,000 messages/day.

⁠🏆 Complete Feature Set | 100+ Features Out-of-the-Box

⁠📱 WhatsApp Messaging (Official API)

• ✅ Text Messages - Send/receive with formatting, emojis, links
• ✅ Rich Media - Images, documents, videos, PDFs, Excel files
• ✅ Voice Messages - Audio recording and playback
• ✅ Interactive Elements - Buttons, lists, quick replies, carousels
• ✅ Message Templates - Pre-approved business templates
• ✅ Group Messaging - Broadcast to multiple groups
• ✅ Contact Management - Import, export, organize contacts
• ✅ Message Status - Delivered, read, failed tracking
• ✅ Message Reactions - Like, love, laugh emoji reactions
• ✅ Reply to Messages - Threaded conversations
• ✅ Forward Messages - Share across conversations
• ✅ Location Sharing - Send/receive GPS coordinates

⁠🤖 Advanced Automation & AI

• ✅ Smart Auto-Replies - Keyword-based responses
• ✅ Business Hours - Automatic away messages
• ✅ Welcome Sequences - New contact onboarding
• ✅ Conversation Flows - Multi-step bot workflows
• ✅ AI Chatbot - Natural language processing
• ✅ Intent Recognition - Understand customer queries
• ✅ Sentiment Analysis - Monitor customer satisfaction
• ✅ Auto-Escalation - Bot to human handoff
• ✅ Smart Routing - Route to appropriate agents
• ✅ Multi-Language - 25+ language support
• ✅ Translation API - Auto-translate messages
• ✅ Custom Variables - Personalized messaging

⁠📊 Professional Campaign Management

• ✅ Bulk Broadcasting - Send to thousands instantly
• ✅ Contact Segmentation - Target specific groups
• ✅ Message Scheduling - Plan campaigns in advance
• ✅ Drip Campaigns - Automated sequences
• ✅ A/B Testing - Optimize message performance
• ✅ Delivery Analytics - Real-time reporting
• ✅ Click Tracking - Monitor link engagement
• ✅ Conversion Tracking - Measure ROI
• ✅ CSV Import/Export - Bulk contact management
• ✅ Dynamic Content - Personalized messages
• ✅ Opt-out Management - Unsubscribe handling
• ✅ Campaign Templates - Reusable campaigns

⁠🎛️ Enterprise Dashboard & Management

• ✅ Web Interface - No app required, works in browser
• ✅ Real-time Monitoring - Live message dashboard
• ✅ Conversation History - Complete chat archives
• ✅ Multi-User Access - Team collaboration
• ✅ Role-Based Permissions - Admin, agent, viewer roles
• ✅ Advanced Analytics - Performance insights
• ✅ Custom Reports - Generate business reports
• ✅ API Documentation - Interactive docs
• ✅ Mobile Responsive - Works on all devices
• ✅ Dark/Light Theme - Customizable interface
• ✅ Notification Center - System alerts
• ✅ Activity Logs - User action tracking

⁠🔗 Extensive Integrations & APIs

• ✅ REST API - Complete programmatic access
• ✅ Webhook Support - Real-time event notifications
• ✅ Zapier Integration - Connect to 3,000+ apps
• ✅ WordPress Plugin - Direct CMS integration
• ✅ Shopify App - E-commerce automation
• ✅ WooCommerce - Order notifications
• ✅ CRM Connectors - Salesforce, HubSpot, Pipedrive
• ✅ Payment Gateways - Stripe, PayPal webhooks
• ✅ Calendar Integration - Google Calendar, Outlook
• ✅ Email Marketing - Mailchimp, SendGrid sync
• ✅ Social Media - Facebook, Instagram crosspost
• ✅ Custom Webhooks - Build your own integrations

⁠🛡️ Enterprise Security & Compliance

• ✅ End-to-End Encryption - Military-grade security
• ✅ GDPR Compliance - European data protection
• ✅ SOC 2 Type II - Enterprise security standards
• ✅ HIPAA Compatible - Healthcare data protection
• ✅ Role-Based Access - Granular permissions
• ✅ Audit Logs - Complete activity tracking
• ✅ Data Backup - Automated daily backups
• ✅ Rate Limiting - API abuse prevention
• ✅ IP Whitelisting - Network access control
• ✅ 2FA Authentication - Two-factor security
• ✅ Session Management - Secure login handling
• ✅ Data Retention - Configurable policies

⁠🚀 Performance & Scaling

• ✅ High Performance - Handle 1M+ messages/hour
• ✅ Auto-Scaling - Dynamic resource allocation
• ✅ Load Balancing - Distribute traffic efficiently
• ✅ Caching System - Lightning-fast responses
• ✅ Database Optimization - MongoDB performance tuning
• ✅ CDN Support - Global content delivery
• ✅ Message Queuing - Reliable delivery system
• ✅ Health Monitoring - System status tracking
• ✅ Error Handling - Graceful failure recovery
• ✅ Backup Systems - Redundant infrastructure

⁠📈 Business Intelligence & Analytics

• ✅ Real-time Dashboards - Live business metrics
• ✅ Message Analytics - Delivery, read rates
• ✅ Customer Insights - Behavior analysis
• ✅ Conversion Tracking - Sales attribution
• ✅ Performance Reports - Detailed analytics
• ✅ Custom Metrics - Define your own KPIs
• ✅ Data Export - CSV, Excel, PDF reports
• ✅ API Analytics - Usage statistics
• ✅ Team Performance - Agent productivity
• ✅ ROI Calculation - Investment tracking

⁠🎨 Customization & Branding

• ✅ White-Label - Your brand, your domain
• ✅ Custom Themes - Brand colors and logos
• ✅ Custom Domains - your-company.com
• ✅ Email Templates - Branded notifications
• ✅ Custom Fields - Additional contact data
• ✅ Workflow Builder - Visual automation designer
• ✅ Plugin System - Extend functionality
• ✅ Custom Scripts - JavaScript customization

⁠💎 Pricing | Start Free, Scale When You Grow

⁠🔥 Why Choose WCloud vs. Leading WhatsApp API Providers?

⁠✅ vs. Twilio WhatsApp Business API

⁠✅ vs. Leading WhatsApp Providers (Interakt, WATI, 360Dialog, MessageBird)

• 🔓 No vendor lock-in - Own your infrastructure vs. cloud dependency
• 💰 90% cost reduction - No per-message fees vs. $0.005-$0.10 per message
• 🚀 5-minute setup - One Docker command vs. weeks of onboarding
• 🛡️ Enterprise security - Your data stays private vs. third-party data handling
• 📈 Unlimited scaling - Handle millions of messages vs. plan limitations
• 🎯 No monthly limits - Send unlimited vs. tier-based pricing

⁠🎯 Perfect For (No Programming Knowledge Required!)

⁠🏢 Small Businesses

• Customer support automation
• Order notifications & updates
• Marketing campaigns & promotions
• Appointment reminders

⁠🏪 E-commerce Stores

• Order confirmations & tracking
• Abandoned cart recovery
• Product updates & offers
• Customer feedback collection

⁠🏥 Service Providers

• Appointment scheduling
• Service reminders
• Payment notifications
• Client communication

⁠🏫 Educational Institutions

• Student notifications
• Parent communication
• Event announcements
• Fee reminders

⁠💼 Agencies & Developers

• White-label WhatsApp solutions
• Client communication tools
• Multi-tenant platforms
• Custom integrations

⁠🚀 Deploy in 60 Seconds | Zero Programming Required

⁠⚡ One-Click Deploy (Easiest)

⁠ Railway Free tier available

⁠ Render $7/month

⁠ Heroku $7/month

⁠ Google Cloud Pay per use

⁠🐳 Docker Deploy (1 Command)

# 🔥 Copy & paste this command - works instantly!
docker run -d \
  --name whatsapp-api \
  -p 3000:3000 \
  -e MONGODB_URI=mongodb://your-mongo-host:27017/wcloud \
  -e WHATSAPP_ACCESS_TOKEN=your_whatsapp_token \
  -e WHATSAPP_PHONE_NUMBER_ID=your_phone_id \
  -e JWT_SECRET=your-secret-key \
  anilmathewm/wcloud-whatsapp-api:latest

⁠Environment Variables Configuration

⁠Complete Environment Variables Reference

⁠Configuration Categories

⁠🔐 Authentication & Security

Required variables for secure operation:

• HMAC_SECRET, JWT_SECRET
• WHATSAPP_VERIFY_TOKEN

⁠📱 WhatsApp API Configuration

Essential WhatsApp Business API settings:

• WHATSAPP_ACCESS_TOKEN
• WHATSAPP_BUSINESS_ACCOUNT_ID
• WHATSAPP_PHONE_NUMBER_ID
• META_APP_ID

⁠🗄️ Database & Storage

Database connection settings:

• MONGODB_URI

⁠🚀 Server Configuration

Application server settings:

• PORT, NODE_ENV, LOG_LEVEL
• API_URL, SOCKET_URL

⁠📊 Campaign Management

Bulk messaging and campaign settings:

• CAMPAIGN_BATCH_SIZE
• CAMPAIGN_DELAY_BETWEEN_BATCHES
• CAMPAIGN_DELAY_BETWEEN_MESSAGES
• CAMPAIGN_MAX_RETRIES

⁠🤖 Chatbot Integration

Chatbot functionality configuration:

• WATSAPP_CHAT_BOT_ID
• WATSAPP_CHAT_BOT_TYPE
• WATSAPP_CHAT_BOT_URL
• WATSAPP_ENABLE_CHAT_BOT

⁠📄 License Management

License and quota enforcement:

• WCLOUD_LICENSE_KEY
• LICENSE_SERVER_URL
• ENABLE_LICENSE_VALIDATION
• ENABLE_QUOTA_ENFORCEMENT

⁠🔧 Feature Toggles

Enable/disable specific features:

• ENABLE_FEATURE_GATES
• ENABLE_USAGE_TRACKING
• ENABLE_LICENSE_REPORTING
• MOBILE_PUSH_ENABLED

⁠Quick Setup Examples

⁠Minimal Configuration (Free Tier)

ADMIN_USERNAME=admin
ADMIN_PASSWORD=your_password
MONGODB_URI=mongodb://localhost:27017/wcloud
WHATSAPP_ACCESS_TOKEN=your_token
WHATSAPP_PHONE_NUMBER_ID=your_phone_id
WHATSAPP_BUSINESS_ACCOUNT_ID=your_business_id
META_APP_ID=your_app_id
JWT_SECRET=your_jwt_secret
HMAC_SECRET=your_hmac_secret
WHATSAPP_VERIFY_TOKEN=your_verify_token

⁠Production Configuration (Pro Tier)

# All minimal config variables plus:
WCLOUD_LICENSE_KEY=WCLOUD-XXXX-XXXX-XXXX-XXXX
NODE_ENV=production
LOG_LEVEL=error

⁠Development Configuration

# All minimal config variables plus:
NODE_ENV=development
LOG_LEVEL=debug
ENABLE_FEATURE_GATES=false
ENABLE_LICENSE_VALIDATION=false
PORT=3000

✅ That's it! Open http://localhost:3000⁠ and start sending WhatsApp messages.

⁠🛠️ Complete Setup with Database (3 Commands)

# Download configuration
curl -O https://raw.githubusercontent.com/anilmathewm/wcloud/main/docker/docker-compose.yml
curl -O https://raw.githubusercontent.com/anilmathewm/wcloud/main/docker/.env.example

# Configure (edit with your WhatsApp credentials)
cp .env.example .env && nano .env

# Start everything (includes database)
docker-compose up -d