# OpenWA: The Friendly WhatsApp Gateway Blueprint

> An open-source, zero lock-in API gateway that translates standard web requests into WhatsApp conversations, featuring a modular architecture and web dashboard.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22)
- [GitHub repository](https://github.com/rmyndharis/OpenWA)

## Repository

- Repository: rmyndharis/OpenWA

- Generated: 2026-05-22T06:02:40.708Z
- Updated: 2026-05-22T06:02:50.468Z
- Runtime: Antigravity CLI
- Format: Explain Like I'm 5
- Pages: 6

## Pages

- [Explain It Simply](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/01-explain-it-simply.md): What OpenWA does in plain language: a post office analogy for WhatsApp automation, the core benefits of zero vendor lock-in, and the golden rules of the architecture.
- [The Session Conductor (Connecting to WhatsApp)](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/02-the-session-conductor-connecting-to-whatsapp.md): How OpenWA handles the magic of logging in: launching the Chromium browser behind the scenes, showing a QR code to scan, and keeping the connection alive like a persistent web socket.
- [The Messaging Post Office (Sending & Receiving)](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/03-the-messaging-post-office-sending-receiving.md): How texts and media travel between your app and WhatsApp: sorting messages in the queue to avoid speed tickets, and ringing webhooks to deliver incoming messages instantly.
- [The Plugs & Sockets (Database, Cache & Files)](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/04-the-plugs-sockets-database-cache-files.md): Why OpenWA is like a modular power strip: how it lets you plug in SQLite or PostgreSQL for data, local disks or S3 for files, and RAM or Redis for caching without rewiring the code.
- [The Control Center (Dashboard & SDKs)](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/05-the-control-center-dashboard-sdks.md): The dashboard and SDK helpers that let you manage your WhatsApp army: scanning QR codes, monitoring system health, and sending API commands from your Python or JavaScript code.
- [Plain English Recap & Next Steps](https://grok-wiki.com/public/wiki/rmyndharis-openwa-2c9996a09a22/pages/06-plain-english-recap-next-steps.md): The ultimate one-minute summary of the OpenWA architecture: the postal worker analogy to keep, the golden lessons of rate limits, and the best blueprints to read next.

## Source Files

- `dashboard/src/App.tsx`
- `dashboard/src/pages/Infrastructure.tsx`
- `dashboard/src/pages/Sessions.tsx`
- `docs/03-system-architecture.md`
- `docs/15-project-roadmap.md`
- `docs/21-glossary.md`
- `package.json`
- `README.md`
- `sdk/README.md`
- `src/app.module.ts`
- `src/common/cache/cache.service.ts`
- `src/common/storage/storage.service.ts`
- `src/config/configuration.ts`
- `src/engine/adapters/whatsapp-web-js.adapter.ts`
- `src/engine/engine.factory.ts`
- `src/main.ts`
- `src/modules/infra/infra.controller.ts`
- `src/modules/message/message.controller.ts`
- `src/modules/message/message.service.ts`
- `src/modules/queue/processors/webhook.processor.ts`
- `src/modules/queue/queue.module.ts`
- `src/modules/session/session.controller.ts`
- `src/modules/session/session.service.ts`
- `src/modules/webhook/webhook.service.ts`