WAPI

WhatsApp API gateway dengan web panel dan bot command group dinamis.

Development

bun install
cp .env.example .env
bun run dev

URL:

API          http://localhost:3000
Panel        http://localhost:3000/panel
Bot Command  http://localhost:3000/bot-commands
API Docs     http://localhost:3000/openapi

Production

Build server dan panel:

bun install --production
bun run build:all

Run:

bun run start

Docker

Local build dari source:

cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build

Production pakai image dari GitHub Container Registry:

cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Default image production:

ghcr.io/melvishniz/wapi:latest

Jika ingin pakai tag tertentu:

WAPI_IMAGE=ghcr.io/melvishniz/wapi:1.2.3 docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Data runtime disimpan di folder lokal:

credentials/
db/
logs/

Environment

ACCESS_TOKEN=change-me
BASIC_AUTH_USER=admin
BASIC_AUTH_PASS=change-me
VITE_API_URL=http://localhost:3000
PANEL_API_URL=http://localhost:3000 # opsional untuk Docker image production

Panel dilindungi BASIC_AUTH_USER / BASIC_AUTH_PASS. ACCESS_TOKEN hanya dipakai backend untuk public API dan tidak dikirim ke browser.

Release & Docker Image

Release otomatis berjalan saat push ke main memakai semantic-release. Gunakan Conventional Commits, contoh:

feat: add command webhook params
fix: handle empty webhook response

Docker image otomatis dibuat oleh GitHub Actions untuk branch, PR, dan tag release ke:

ghcr.io/<owner>/<repo>

API Documentation

Dokumentasi API lengkap tersedia di:

/openapi