ITithub.directory
Directory
OpenWA

OpenWA

FeaturedVerifiedOpen SourceAPI

Free, open-source self-hosted WhatsApp API gateway

github.com/rmyndharis/OpenWA

Last updated: June 2026

OpenWA is a free, open-source, self-hosted WhatsApp API gateway for developers. It exposes a REST API and a React dashboard to send and receive messages, manage groups and media, handle webhooks and run multiple WhatsApp sessions, with no vendor lock-in or paywalls.

4views

About

OpenWA is a free, open-source, self-hosted WhatsApp API gateway built for developers who want full control over their messaging infrastructure, without vendor lock-in or hidden paywalls. It turns WhatsApp into a programmable REST API that you run on your own servers.

Under the hood it is a TypeScript application built on NestJS and Node.js 22, using whatsapp-web.js by default or Baileys as the WhatsApp engine. It runs multiple WhatsApp sessions at once, so a single deployment can drive several accounts, and it ships a modern React dashboard for managing sessions, webhooks and API keys. A Swagger interface documents every endpoint.

OpenWA is built to be deployed and operated seriously. It supports SQLite or PostgreSQL, optional Redis caching and S3 or MinIO storage, and runs through Docker and Docker Compose on multi-arch Linux, with Kubernetes-ready health checks. Security and operations features include API-key access control, HMAC-signed webhooks, rate limiting, CIDR whitelisting, proxy support and audit logging. It is released under the MIT license.

Positioning

OpenWA positions itself as the self-hosted, no-lock-in alternative to commercial WhatsApp API providers and the official Cloud API, for developers who would rather own the gateway than rent it.

  • Self-hosted: run it on your own infrastructure, your data stays with you.
  • No paywalls: MIT-licensed and free for personal and commercial use.
  • Multi-session: drive several WhatsApp accounts from one deployment.
  • Pluggable: swap the database, cache and storage, and choose the WhatsApp engine.
  • Production-minded: webhooks, rate limiting, audit logging and Docker or Kubernetes deployment.

What You Get

  • A REST API to send and receive text, images, video, audio and documents
  • Reactions, bulk sending and delivery status tracking
  • Group and channel management, labels and contact management
  • Multi-session support for running multiple WhatsApp accounts at once
  • A React dashboard for sessions, webhooks and API keys, plus Swagger docs
  • Webhooks with HMAC signatures, rate limiting, CIDR whitelisting and proxy support
  • API-key authentication and audit logging
  • SQLite or PostgreSQL, optional Redis caching and S3 or MinIO storage
  • Docker and Docker Compose deployment, multi-arch Linux and Kubernetes health checks

Core Areas

WhatsApp API gateway

a self-hosted REST interface to WhatsApp messaging

Automation and integration

chatbots, CRM and custom messaging workflows via webhooks

Multi-session management

many accounts handled from one instance through a dashboard

Operations and security

API keys, HMAC webhooks, rate limiting, whitelisting and audit logs

Self-hosting

Docker, Postgres or SQLite, Redis and S3 or MinIO, Kubernetes-ready

Why It Matters

Adding WhatsApp to an application usually means paying a third-party provider that sits between you and your own messages, with per-message fees, rate caps and a hard dependency you cannot inspect. For many teams that is both a cost problem and a data-control problem.

OpenWA removes the middleman. By self-hosting the gateway, developers keep their messaging data on their own infrastructure, avoid per-message pricing, and can audit and extend the code because it is MIT-licensed. With multi-session support, a clean REST API, webhooks and Docker deployment, it gives small teams the same WhatsApp automation capabilities that normally require a paid platform, while leaving them in full control. That is why a self-hosted, open-source gateway is worth running.

Reviews

No reviews yet.

Log in to write a review