Waba-CRM

WABA-CRM — Modern WhatsApp Business API CRM Platform

WABA-CRM Logo

Production-ready, self-hostable CRM for the WhatsApp® Business Cloud API built on Next.js 16 and Supabase.

License: MIT Next.js 16 React 19 Supabase Model Context Protocol GitHub Stars


Overview

WABA-CRM is a full-featured, open-source Customer Relationship Management (CRM) platform engineered specifically for organizations utilizing the official Meta WhatsApp Business Cloud API.

Unlike rigid SaaS alternatives with expensive per-seat pricing models and proprietary lock-in, WABA-CRM gives you complete ownership over your customer data, AI models, conversation histories, and infrastructure.

Designed for high-performance sales, support, and marketing teams, WABA-CRM bridges the gap between customer messaging and sales execution.


✨ Key Features

📥 Multi-Agent Shared Inbox

🔢 Contact Management & Sequential IDs

⚡ Visual Automations & Tag Workflows

📢 Meta-Approved Broadcasts

💼 Kanban Sales Pipeline

🤖 AI Assistant & Knowledge Base (BYOK)

🔌 Model Context Protocol (MCP) Server


🏗️ Architecture & Tech Stack

graph TD
    Client["Next.js 16 Web App (React 19, Tailwind CSS)"]
    MetaAPI["Meta WhatsApp Business Cloud API"]
    Supabase["Supabase (PostgreSQL + RLS + pgvector + Auth)"]
    MCPServer["Model Context Protocol Server"]
    AIProviders["AI Providers (OpenAI / Anthropic)"]

    Client <-->|Server Actions / REST| Supabase
    MetaAPI <-->|Webhooks / Cloud API| Client
    Client <-->|BYOK AI Prompts & RAG| AIProviders
    MCPServer <-->|REST API v1| Client

🚀 Getting Started

Prerequisites

Ensure you have the following installed:

1. Clone the Repository

git clone https://github.com/shahzebiqbalkhan/Waba-CRM.git
cd Waba-CRM

2. Install Dependencies

npm install

3. Configure Environment Variables

Copy the example environment configuration:

cp .env.local.example .env.local

Edit .env.local with your credentials:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-supabase-service-role-key

# Application Settings
NEXT_PUBLIC_APP_URL=http://localhost:3000
ENCRYPTION_SECRET=your-32-byte-hex-secret # Generate with: openssl rand -hex 32

# WhatsApp Webhook Verification
WHATSAPP_WEBHOOK_VERIFY_TOKEN=your-custom-verify-token

4. Database Migrations

Apply the migration scripts to your Supabase project in order:

# Option A: Using the Supabase CLI
supabase db push

# Option B: Run the consolidated SQL file in the Supabase SQL Editor
# File: supabase/combined_migrations.sql

5. Run the Local Development Server

npm run dev

Open http://localhost:3000 in your browser.


🐳 Docker Deployment

A production-ready Dockerfile and docker-compose.yml are included for seamless containerized self-hosting:

# Build and run with Docker Compose
docker compose up -d --build

🔌 Using the MCP Server

Control your CRM directly from AI environments like Claude Desktop or Cursor:

{
  "mcpServers": {
    "waba-crm": {
      "command": "npx",
      "args": ["-y", "waba-crm-mcp"],
      "env": {
        "WACRM_BASE_URL": "https://your-waba-crm-domain.com",
        "WACRM_API_KEY": "wacrm_live_xxxxxxxxxxxxxxxxxxxxxx",
        "WACRM_ENABLE_WRITES": "true"
      }
    }
  }
}

See docs/mcp.md for full tool references and configurations.


🔒 Security & Data Privacy


🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page. Please read our Contributing Guide before submitting pull requests.


📄 License

This project is open-source software licensed under the MIT License.


👤 Author & Maintainer

Shahzeb Iqbal Khan