Gowa-UI

Modern, open-source WhatsApp Business Platform. Single binary app.

Features

• Multi-tenant Architecture Support multiple organizations with isolated data and configurations.

• Granular Roles & Permissions Customizable roles with fine-grained permissions. Create custom roles, assign specific permissions per resource (users, contacts, templates, etc.), and control access at the action level (read, create, update, delete). Super admins can manage multiple organizations.

• WhatsApp Business API Integration Connect via the WhatsApp Business API for messaging.

• Real-time Chat Live messaging with WebSocket support for instant communication.

• Template Management Create and manage message templates approved by Meta.

• Bulk Campaigns Send campaigns to multiple contacts with retry support for failed messages.

• Campaign Send Pacing Per-account messages/minute budget enforced before every campaign send, protecting numbers from WhatsApp ban waves that target bursting accounts.

• Business Hours & Auto-Reply Each account can define its working window (with overnight spans and open days); inbound messages arriving while closed get your away message once per contact — no reply loops, groups excluded.

• Device Health Alerts When a connected number logs out or reconnects, the platform writes an audit entry, pushes a live in-app alert, and can notify an admin Telegram chat — no more silently-dead numbers.

• WhatsApp Account Management Connect and manage multiple WhatsApp accounts via GOWA (WhatsApp Web protocol) with user-specific visibility controls and granular device management.

• Canned Responses Pre-defined quick replies with slash commands (/shortcut) and dynamic placeholders.

• Analytics Dashboard Track messages, engagement, and campaign performance.

• WhatsApp Status (Story) Post text, image, and video WhatsApp Status updates from any connected account directly in the chat sidebar.

View more screenshots

Installation

Docker

The latest image is available on Docker Hub at compnew2006/gowa-ui:latest

# Download compose file, sample config, and env file
curl -LO https://raw.githubusercontent.com/compnew2006/gowa-ui/main/docker/docker-compose.yml
curl -LO https://raw.githubusercontent.com/compnew2006/gowa-ui/main/config.example.toml
curl -L https://raw.githubusercontent.com/compnew2006/gowa-ui/main/docker/.env.example -o .env

# Copy and edit config
cp config.example.toml config.toml
# Edit .env to set PostgreSQL credentials and timezone

# Run services
docker compose up -d

Go to http://localhost:8080 and login with admin@admin.com / admin

---

Binary

Download the latest release and extract the binary.

# Copy and edit config
cp config.example.toml config.toml

# Run with migrations
./gowa-ui server -migrate

Go to http://localhost:8080 and login with admin@admin.com / admin

---

Build from Source

git clone https://github.com/compnew2006/gowa-ui.git
cd gowa-ui

# Production build (single binary with embedded frontend)
make build-prod
./gowa-ui server -migrate

See configuration docs for detailed setup options.

CLI Usage

./gowa-ui server              # API + 1 worker (default)
./gowa-ui server -workers=0   # API only
./gowa-ui worker -workers=4   # Workers only (for scaling)
./gowa-ui version             # Show version

Developers

The backend is written in Go (Fastglue) and the frontend is Vue.js 3 with shadcn-vue.

• If you are interested in contributing, please read CONTRIBUTING.md first.

# Development setup
make run-migrate    # Backend (port 8080)
cd frontend && npm run dev   # Frontend (port 3000)

License

See LICENSE for details.