WILDCAT - WhatsApp REST API

🚀 Quick Start

┌─────────────────────────────────────────────────────────────┐ │ WILDCAT Setup Flow │ └─────────────────────────────────────────────────────────────┘ 1. INSTALL 2. CONFIGURE 3. CONNECT ═══════════ ════════════ ══════════ 📦 npm ci ───────► 📝 .env setup ───────► 📱 Scan QR ↓ ↓ ↓ Dependencies MongoDB URL Authenticated installed configured & Ready! 4. SEND MESSAGE 5. WEBHOOK 6. AUTOMATE ═══════════════ ══════════ ═══════════ 🚀 REST API ───────► 🔔 Events ───────► 🤖 Integrate POST /message Real-time n8n, Zapier Send instantly delivery & more!

# Install WILDCAT
git clone https://github.com/NotoriousArnav/wildcat.git
cd wildcat && npm ci

# Configure
cp .env.example .env
nano .env  # Set MONGO_URL and DB_NAME

# Start server
npm start

# Send your first message
curl -X POST http://localhost:3000/accounts/mybot/message/send \
  -H 'Content-Type: application/json' \
  -d '{"to": "1234567890@s.whatsapp.net", "message": "Hello! 🐱"}'

🏗️ Architecture

┌───────────────────────────────────────────────────────────────────┐ │ WILDCAT Architecture │ └───────────────────────────────────────────────────────────────────┘ External Services WILDCAT API WhatsApp ═════════════════ ═══════════ ════════ ┌─────────────┐ ┌──────────┐ ┌────────┐ │ n8n/ │ REST API │ Express │ Baileys │WhatsApp│ │ Zapier │◄─────────────►│ Server │◄───────────►│ Web │ │ Custom │ Webhooks │ │ Protocol │ │ └─────────────┘ └──────────┘ └────────┘ ▲ ▼ │ │ ┌───┴──┴───┐ │ MongoDB │ │ GridFS │ │ Sessions │ └──────────┘ Features: • Multi-Account Management • Media Storage (GridFS) • WebSocket QR Auth • Structured Logging • Real-time Webhooks • Audio Conversion (ffmpeg) • REST Endpoints (20+) • Session Persistence

✨ Key Features

🚀

Multi-Account Support

Manage unlimited WhatsApp numbers simultaneously with individual session management and authentication.

📱

Full WhatsApp Features

Messages, media (images/video/audio/docs), reactions, replies, editing, deletion, statuses, and more.

🔗

Webhook Integration

Real-time message delivery to external services. Perfect for automation platforms like n8n and Zapier.

🧾

Media Storage

Automatic GridFS storage with direct-access endpoints. Upload and retrieve media files effortlessly.

🤖

Bot-Ready

Perfect foundation for chatbots, automation, CRM integrations, and business workflows.

⚡

REST API

Clean HTTP interface with JSON responses. Easy integration with any programming language.

🐳

Docker Support

Production-ready containerization with ffmpeg pre-installed. Deploy anywhere instantly.

📊

Structured Logging

JSON-based logging with separate streams for HTTP, Baileys, and application logs.

🔄 Message Flow

┌────────────────────────────────────────────────────────────────┐ │ Inbound Message Flow │ └────────────────────────────────────────────────────────────────┘ WhatsApp User WILDCAT Server Your Application ───────────── ────────────── ───────────────── 📱 🖥️ 🔧 │ │ │ │ 1. Send Message │ │ │─────────────────────► │ │ │ │ │ │ │ 2. Process & Store │ │ │────────┐ │ │ │◄───────┘ │ │ │ │ │ │ 3. Trigger Webhook │ │ │────────────────────────►│ │ │ │ │ │ 4. Your Logic Runs │ │ │ │─┐ │ │ │◄┘ │ │ │ │ │ ◄─────5. Send Reply─────│ │ │ │ │ ◄─────6. Deliver──────│ │ │ │ │ ┌────────────────────────────────────────────────────────────────┐ │ Outbound Message Flow │ └────────────────────────────────────────────────────────────────┘ Your Application WILDCAT Server WhatsApp User ───────────────── ────────────── ───────────── 🔧 🖥️ 📱 │ │ │ │ 1. POST /message │ │ │──────────────────────►│ │ │ │ │ │ │ 2. Validate & Queue │ │ │────────┐ │ │ │◄───────┘ │ │ │ │ │ │ 3. Send via Baileys │ │ │────────────────────────►│ │ │ │ │ 4. Return messageId │ │ │◄──────────────────────│ │ │ │ │

📊 By The Numbers

20+

REST Endpoints

∞

Accounts Supported

100%

Open Source

5min

Setup Time

⚠️ Important Notice

🔒 Security & Compliance

WILDCAT is an unofficial WhatsApp integration using reverse-engineered protocols. Please consider:

⚠️ Unofficial: Not endorsed by WhatsApp/Meta. Use at your own risk.
🚫 Rate Limits: Subject to WhatsApp's sending limits (~60 msg/min).
📵 Ban Risk: Heavy automated usage may trigger account restrictions.
🔐 v2 Security: No built-in authentication. DO NOT expose to public internet.

Recommended for: Development, testing, personal automation, small business bots.

Not recommended for: Spam, marketing at scale, production without security controls.

📖 Read Deployment Guide

🔌 Integration Examples

┌────────────────────────────────────────────────────────────────┐ │ n8n Workflow Example │ └────────────────────────────────────────────────────────────────┘ Webhook Trigger Transform Data Send via WILDCAT ═══════════════ ══════════════ ════════════════ ┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │ Incoming │ │ Process │ │ HTTP POST │ │ Webhook │─────►│ Logic │───►│ WILDCAT │ │ (n8n node) │ │ (JS/Python) │ │ Endpoint │ └─────────────┘ └──────────────┘ └──────────────┘ │ ▼ ┌──────────────┐ │ WhatsApp │ │ Delivered │ └──────────────┘ Supported Platforms: • n8n (Visual Workflows) • Custom Node.js/Python Apps • Zapier (Automation) • IFTTT (Triggers) • Make.com (Integromat) • Any HTTP Client

📖 View Integration Examples

Ready to Get Started?

Set up WILDCAT in 5 minutes and start sending WhatsApp messages via REST API

🚀 5-Minute Quickstart 📋 Full Installation Guide 📚 API Reference

WhatsApp Integration Layer for Data Connectivity And Transfer