Files
ragflow/api/channels/whatsapp/gateway-node/README.md
buua436 aba5d172bd feat: add whatsapp web qr chat channel (#16238)
Adds a WhatsApp chat channel backed by a QR-based web login flow so users can connect without manual token setup.
2026-06-23 17:45:31 +08:00

35 lines
764 B
Markdown

# RAGFlow WhatsApp Gateway
This directory contains a minimal WhatsApp gateway built on top of
`@whiskeysockets/baileys`.
## Install
```bash
cd api/channels/whatsapp/gateway-node
npm install
```
## Run
```bash
WHATSAPP_GATEWAY_PORT=3005 \
WHATSAPP_GATEWAY_DATA_DIR=~/.ragflow/whatsapp-gateway \
npm start
```
## API
- `POST /whatsapp/:sessionKey/start`
- `GET /whatsapp/:sessionKey/status`
- `GET /whatsapp/:sessionKey/events/ws?after=<seq>` (WebSocket)
- `POST /whatsapp/:sessionKey/send`
- `POST /whatsapp/:sessionKey/stop`
## Notes
- Authentication state is persisted under `WHATSAPP_GATEWAY_DATA_DIR`.
- Scan the QR code exposed in `status.qr_data_url`.
- RAGFlow polls `status` and `events` and forwards inbound messages to the
connected assistant.