ChatbotX

Agentic chat marketing platform built for OpenClaw, Hermes, and Claude
An alternative to ManyChat, Chatfuel, Wati, Respond, etc...

Website | Roadmap | Docs | Discord

✨ Features

• Visual Flow Builder: Drag-and-drop chatbot builder with 15+ node types
• AI Agent: AI-powered responses and actions using OpenAI, DeepSeek, or Gemini
• Live Chat Inbox: Real-time inbox with human takeover and conversation assignment
• Contact CRM: Manage contacts with tags, custom fields, and segmentation
• Broadcasting: Send targeted messages to specific contact segments
• Sequences: Automate drip campaigns with scheduled messages and auto-enrollment
• Team Management: Invite team members, assign roles, and manage permissions
• Multi-Platform: Connect across WhatsApp, Facebook, Instagram, Telegram, Zalo, Email, and Webchat
• Rich Messaging: Support for buttons, quick replies, catalogs, and carousel cards
• Comment-to-DM: Automatically message users who comment with specific keywords
• A/B Testing: Test and optimize different message flows
• Triggers: Execute actions based on events within your bot
• Webhooks & HTTP: Integrate external APIs directly into your flows
• Growth Tools: Generate conversation starter links for each platform
• Analytics: Track performance metrics, user engagement, and campaign results
• APIs, CLI, and MCP: Build advanced agent workflows with MCP-compatible clients

Tech Stack

• Node.js 24
• TypeScript 5
• pnpm 10 workspaces
• Turborepo
• Next.js 16 and React 19 for apps/builder
• PartyKit / PartySocket for realtime messaging
• Drizzle ORM with PostgreSQL and pgvector
• Redis and BullMQ for queues and worker coordination
• RustFS / S3-compatible storage for uploaded assets
• Docker Compose for local infrastructure

Quick Start

To have the project up and running, please follow the Quick Start Guide.

Project Structure

.
|-- apps/
|   |-- builder/       # Next.js web app and product builder
|   |-- worker/        # background workers for chat, AI, triggers, webhooks, analytics, sequences
|   |-- partysocket/   # realtime server
|   |-- cli/           # ChatbotX command line client
|   `-- mcp-server/    # MCP server backed by public APIs
|-- integrations/
|   |-- whatsapp/
|   |-- messenger/
|   |-- instagram/
|   |-- telegram/
|   |-- zalo/
|   |-- webchat/
|   |-- smtp/
|   |-- openai/
|   `-- google-sheets/
|-- packages/
|   |-- database/
|   |-- ai/
|   |-- analytics/
|   |-- public-apis/
|   |-- sdk/
|   |-- scheduler/
|   |-- sequence-scheduler/
|   |-- ui/
|   `-- worker-config/
|-- docker-compose.yml
|-- pnpm-workspace.yaml
`-- turbo.json

Development Commands

pnpm dev              # run turbo dev
pnpm build            # build all packages/apps through Turborepo
pnpm lint             # run Ultracite lint
pnpm fix              # run Ultracite fix
pnpm check:circular   # check circular dependencies
pnpm check:unused     # check unused files and dependencies

Useful package-level commands:

pnpm --filter builder dev
pnpm --filter worker dev
pnpm --filter partysocket dev
pnpm --filter chatbotx-cli dev:cli
pnpm --filter chatbotx-mcp-server dev:mcp
pnpm --filter @chatbotx.io/database db:studio

Services

The default Docker Compose stack includes:

• PostgreSQL with pgvector on 5432
• Redis on 6379
• RedisInsight on 5540
• RustFS object storage on 9000 and console on 9001
• MailHog SMTP on 1025 and UI on 8025
• Adminer on 8080

License

ChatbotX' Community Edition is released as open source under the AGPLv3 license and enterprise features are released under Commercial License