Skip to content

WhatsApp Web API v1.0.0

Choose a tag to compare

@rizrmd rizrmd released this 25 Oct 09:22
· 17 commits to main since this release

πŸš€ WhatsApp Web API v1.0.0

A production-ready REST API for WhatsApp Web integration that enables programmatic sending of messages, QR code pairing, and webhook-based message reception.

✨ Features

  • πŸ“± QR Code Pairing: Generate QR codes to pair WhatsApp accounts
  • πŸ’¬ Message Sending: Send text messages to any WhatsApp number via REST API
  • πŸͺ Webhook Support: Receive incoming messages via HTTP webhooks
  • πŸ—„οΈ PostgreSQL Storage: Secure WhatsApp session persistence in PostgreSQL
  • πŸ”’ Auto SSL Handling: Automatically configures PostgreSQL SSL mode
  • πŸ“š Complete Documentation: Full OpenAPI 3.0 / Swagger specification
  • πŸ”„ Session Management: Automatic reconnection and session handling
  • ⚑ High Performance: Concurrent message handling and graceful shutdown

🐧 Supported Platforms

  • Linux (AMD64, ARM64, 386)
  • macOS (Intel, Apple Silicon)
  • Windows (64-bit, 32-bit)

πŸ“¦ Installation

Linux Deployment (Recommended)

Quick Start

  1. Set environment variables in file
  2. Run the binary for your platform
  3. Visit http://localhost:8080/health to verify
  4. Use http://localhost:8080/pair to pair with WhatsApp

For detailed installation and usage instructions, see the README.

πŸ”§ Configuration

  • : PostgreSQL connection string (required)
  • : Server port (default: 8080)
  • : Webhook endpoint for incoming messages (optional)

πŸ“š Documentation

⚠️ Requirements

  • Go 1.24+ (for building from source)
  • PostgreSQL 12+
  • WhatsApp account with multi-device enabled

πŸ”’ Secure by default - All credentials stored securely in PostgreSQL
πŸ“ˆ Production ready - Includes systemd service setup and monitoring