# WhatsCRM

> WhatsCRM is a self-hosted WhatsApp CRM platform built on Node.js + Express + Socket.IO + MySQL. It supports both Baileys (WhatsApp Web QR) and Meta Cloud API connections, multi-agent inbox, broadcast campaigns, AI agents, chatbots, flow builder, and a public Developer REST API.

Stack: Node.js, Express 4, Socket.IO, MySQL 8, Baileys (multi-device WhatsApp Web), JWT auth.
Languages: User interface in 14 languages including Hebrew (RTL), English, Arabic, Spanish, Portuguese, Hindi, Turkish, German, Italian, Malay, Sinhala, Swahili, Luganda.
License: Proprietary (commercial).
Production: https://wcrm.itninja.co.il

## Documentation

- [User Guide (Hebrew, full)](https://wcrm.itninja.co.il/guide.html): End-user manual covering login, dashboard, WhatsApp connection (QR + Meta Cloud), inbox, phonebook, broadcast, templates, chatbot, flow builder, AI agents, human agents, API keys, settings.
- [API Reference (HTML)](https://wcrm.itninja.co.il/api.html): Renders the full REST + Socket.IO + Webhooks reference with TOC and code samples.
- [API Reference (Markdown)](https://wcrm.itninja.co.il/api-docs.md): Raw markdown source — preferred for LLM ingestion (~43KB, Hebrew with English code examples).
- [Help JSON](https://wcrm.itninja.co.il/api/help): Machine-readable index of documentation URLs.

## API Endpoints (developer-facing prefixes)

- `/api/v1/*` — Public Developer REST API (Meta Cloud Send Message, templates, contacts). Auth: `?token=<api_key>`.
- `/api/qr/rest/send_message` — Send via connected Baileys instance. Auth: `api_key`.
- `/api/qr/*` — Manage QR (Baileys) WhatsApp connections.
- `/api/inbox/*` — Live inbox messaging (auth required).
- `/api/broadcast/*` — Campaign management.
- `/api/chatbot/*`, `/api/chat_flow/*`, `/api/ai/*` — Bot/Flow/AI configuration.
- `/api/webhook/*` — Outbound webhook configuration (events: message.received, message.status, qr.connected, qr.disconnected).

## Optional

- [OpenAPI Spec (JSON)](https://wcrm.itninja.co.il/openapi.json): Minimal OpenAPI 3.1 description of the public Developer API.
- [Shortcuts](https://wcrm.itninja.co.il/help): /help, /docs, /guide, /manual → User Guide. /api-docs, /dev → API Reference.