Whisper API

Seamless WhatsApp Integration

Features

Ping/Pong Health Check

Easily monitor server health and WhatsApp connection.

Status Monitoring

Real-time insights into your WhatsApp connection status.

Multi-Instance Management

Handle multiple WhatsApp instances concurrently.

How It Works

Architecture Overview

Express.js API

RESTful endpoints

Baileys Library

WhatsApp integration

MongoDB

Instance management

Webhooks

Real-time events

Single Instance

Perfect for basic WhatsApp messaging with one account.

  • • Simple QR code authentication
  • • Direct message sending
  • • Lightweight setup

Multi-Instance

Default

Manage multiple WhatsApp accounts simultaneously.

  • • Multiple concurrent sessions
  • • Database-backed management
  • • Advanced webhook support

Hybrid Mode

Combine both single and multi-instance capabilities.

  • • All endpoints available
  • • Maximum flexibility
  • • Development-friendly

Integration Workflow

1
Configure

Set up environment variables and choose operational mode

2
Authenticate

Scan QR code to connect WhatsApp account(s)

3
Integrate

Use RESTful APIs to send messages and manage instances

4
Monitor

Receive real-time webhooks and monitor connection status

Easy Setup

  1. Clone the repository: 
    git clone https://github.com/ibnusyawall/whisper-api.git && cd whisper-api
  2. Install dependencies: 
    npm install
  3. Set up environment variables: 
    cp .env.example .env
  4. Configure your .env file with the required variables.
  5. Set up the database (MongoDB with Prisma): 
    npx prisma generate
npx prisma db push
  6. Start the server: 
    npm run dev # Development
npm start # Production