WhatsApp Adapter

Project-local documentation for the WhatsApp Adapter stack.

Overview

This repository is organized around a small set of deployable modules with a strict dependency direction:

• whatsapp-adapter-app is the operator-facing web UI.
• whatsapp-adapter-api is the stable project-owned HTTP API.
• whatsapp-adapter-waha is the WAHA runtime kept behind the API boundary.
• whatsapp-adapter-docs packages and serves the canonical root docs/ content.

Module Dependency Diagram

The runtime path is app -> api -> waha. The docs module stands on its own and does not sit in the runtime call chain.

PlantUML source: assets/diagrams/module-dependencies.puml

Endpoints

Local endpoints use the dedicated 81xx range to avoid collisions with other local projects.

• whatsapp-adapter-api: http://127.0.0.1:8100
• whatsapp-adapter-app: http://127.0.0.1:8101
• whatsapp-adapter-waha: http://127.0.0.1:8102/ for dashboard redirect, http://127.0.0.1:8102/ping for health
• whatsapp-adapter-docs: http://127.0.0.1:8103

Production endpoints:

• whatsapp-adapter-api: https://whatsapp-adapter-api.mathbox.90.cz assigned hostname on mathbox;
• whatsapp-adapter-app: https://whatsapp-adapter-app.mathbox.90.cz assigned hostname on mathbox;
• whatsapp-adapter-docs: https://whatsapp-adapter-docs.mathbox.90.cz
• whatsapp-adapter-waha dashboard: https://whatsapp-adapter-waha.mathbox.90.cz/dashboard/ operator dashboard entry on mathbox;

When production hostnames are assigned, record them in Remote Server.

Start Here

• Project Layout
• Container Runtime Contract
• Architecture Guidelines
• Authentication Contract
• API Reference
• API Publication Policy
• Data Storage