██╗░░░██╗██████╗░███╗░░░███╗░█████╗░██████╗░███████╗
██║░░░██║██╔══██╗████╗░████║██╔══██╗██╔══██╗╚════██║
██║░░░██║██║░░██║██╔████╔██║██║░░██║██║░░██║░░███╔═╝
██║░░░██║██║░░██║██║╚██╔╝██║██║░░██║██║░░██║██╔══╝░░
╚██████╔╝██████╔╝██║░╚═╝░██║╚█████╔╝██████╔╝███████╗
░╚═════╝░╚═════╝░╚═╝░░░░░╚═╝░╚════╝░╚═════╝░╚══════╝

---

 About

WhatsApp OTP API is a high-performance, serverless-ready authentication system that delivers OTP codes directly through WhatsApp messages. Built with a custom Baileys fork (noname089), sessions are securely stored on GitHub — making it cloud-native and infinitely scalable.

🧩 Feature	📝 Description
🔐 Pairing API	Link WhatsApp accounts via pairing code
📨 OTP Delivery	Send OTP with one-tap copy button
💬 Custom Messages	Send any formatted text message
🤖 Bot Management	Delete or check status of linked bots
☁️ GitHub Sessions	Persistent sessions stored on GitHub
🌐 Multi-Platform	Deploy on Vercel, VPS, or locally
🔒 HTTPS Ready	Auto-generated self-signed certs for local dev
🧠 Smart Reconnect	Auto-reconnects saved bots on startup

 Architecture

graph LR
    A["🌐 Client"] -->|"HTTP Request"| B["⚡ Express Server"]
    B -->|"/pair"| C["📲 Pairing Engine"]
    B -->|"/send"| D["💬 Message Relay"]
    B -->|"/manage"| E["🔧 Bot Manager"]
    B -->|"/health"| F["💚 Health Check"]
    C --> G["🔑 Baileys (noname089)"]
    D --> G
    G -->|"Session Sync"| H["🐙 GitHub Storage"]
    
    style A fill:#4000ff,color:#fff,stroke:#7c3aed
    style B fill:#7c3aed,color:#fff,stroke:#4000ff
    style G fill:#25D366,color:#fff,stroke:#128C7E
    style H fill:#333,color:#fff,stroke:#666

Loading

 API Endpoints

📲 1. Request Pairing Code

GET /pair?number={phone_number}

Parameter	Type	Description
number	string	Required. Phone number (digits only)

✅ Success Response:

{
  "status": "success",
  "code": "WORK-CODE"
}

⚠️ Already Paired:

{
  "status": "already_authenticated",
  "message": "This bot is already paired to api."
}

💬 2. Send Message / OTP

GET /send?text={message}&botNumber={from}&receiver={to}

Parameter	Type	Description
text or msg	string	Required. Message content
botNumber	string	Required. Sender bot number
receiver	string	Required. Destination number
otp	string	Optional. OTP code — adds a 📋 Copy OTP button

✅ Success Response:

{
  "status": "success",
  "message": "Message sent"
}

💡 Pro Tip: When otp is provided, the message is sent as an interactive view-once message with a native copy-code button!

🔧 3. Manage Bot

GET /manage?number={phone_number}&action=delete

Parameter	Type	Description
number	string	Required. Bot phone number
action	string	Required. Action to perform (delete)

✅ Success Response:

{
  "status": "success",
  "message": "Bot {number} deleted."
}

💚 4. Health Check

GET /health

✅ Response:

{
  "status": "ok",
  "bots": [
    {
      "number": "94710000000",
      "status": "open",
      "lastUpdate": "2026-03-24T14:00:00.000Z"
    }
  ]
}

⚙️ Tech Stack

Node.js ≥ 22

Express v4.18

Octokit Session Store

Vercel Serverless

🚀 Deployment

🖥️ Local Development

# 1. Clone the repository
git clone https://github.com/udmodz0/auth-wa-api.git
cd auth-wa-api

# 2. Install dependencies
npm install

# 3. Configure environment
#    Create config.env or .env with:
#    GITHUB_REPO_URL=https://github.com/your-user/your-repo
#    GITHUB_SECRET_KEY=ghp_your_personal_access_token

# 4. Start the server
npm start

🔒 HTTPS Note: Local development uses a self-signed certificate. Click Advanced → Proceed to localhost in your browser to bypass the warning.

🟣 Deploy to Vercel (Serverless)

1. Connect your repository to Vercel
2. Vercel auto-detects vercel.json & api/index.js
3. Set Environment Variables in the Vercel dashboard:

Variable	Value
GITHUB_REPO_URL	https://github.com/user/repo
GITHUB_SECRET_KEY	ghp_your_token
NODE_ENV	production

4. Deploy! 🚀

⚡ Note: Vercel is serverless — bots connect on-demand when an API call is made.

☁️ Deploy to VPS / Node.js Host

1. Ensure Node.js 22+ is installed
2. Clone the repository
3. Set environment variables:

export GITHUB_REPO_URL="https://github.com/user/repo"
export GITHUB_SECRET_KEY="ghp_your_token"
export NODE_ENV="production"
export PORT=8080

4. Install & start:

npm install
npm start

5. The server auto-connects all saved bots from GitHub on startup ✅

📁 Project Structure

auth-wa-api/
├── 📄 api/
│   └── index.js          # 🧠 Core server — all routes & bot logic
├── 📄 vercel.json         # ⚡ Vercel serverless config
├── 📄 package.json        # 📦 Dependencies & scripts
├── 📄 .gitignore          # 🚫 Ignores sessions, env files, node_modules
└── 📄 README.md           # 📖 You are here!

📦 Dependencies

Package	Purpose
noname089	🔌 Custom Baileys fork for WhatsApp Web API
express	⚡ Fast HTTP server framework
@octokit/rest	🐙 GitHub API client for session storage
cors	🌐 Cross-origin request handling
dotenv	🔧 Environment variable management
pino	📊 Ultra-fast JSON logger
selfsigned	🔒 Self-signed SSL certificate generation
gradient-string	🎨 Beautiful console gradients
chalk	🖌️ Terminal string styling
axios	🌐 HTTP client
adm-zip	🗜️ ZIP file handling
cheerio	🔍 HTML parser
jimp	🖼️ Image processing
megajs	☁️ Mega cloud storage
mongodb	🍃 MongoDB driver
moment-timezone	🕐 Timezone-aware dates

⚠️ Environment Variables

Variable	Required	Description
GITHUB_REPO_URL	✅	Full URL to your GitHub session storage repo
GITHUB_SECRET_KEY	✅	GitHub Personal Access Token (PAT) with repo access
NODE_ENV	❌	Set to production for HTTP mode (default: HTTPS with self-signed cert)
PORT	❌	Server port (default: 8080)

🔐 How It Works

sequenceDiagram
    participant C as 🌐 Client
    participant S as ⚡ Server
    participant W as 📱 WhatsApp
    participant G as 🐙 GitHub

    Note over C,G: 🔗 Pairing Flow
    C->>S: GET /pair?number=94710000000
    S->>W: Request Pairing Code
    W-->>S: Pairing Code
    S->>G: Save Session
    S-->>C: { code: "ABCD-EFGH" }

    Note over C,G: 📨 Send OTP Flow
    C->>S: GET /send?text=Your OTP: 1234&botNumber=...&receiver=...&otp=1234
    S->>G: Load Session (if offline)
    S->>W: Send Interactive Message with Copy Button
    W-->>S: Delivery ACK
    S-->>C: { status: "success" }

Loading

👨‍💻 Creator

⭐ Star this repo if you found it useful!

🚫 This is a FREE API — Do NOT sell it.

Made with 💜 by UDMODZ