🤖 BizBot

WhatsApp automation for small businesses — auto-reply, bot flows & shared inbox

Turn WhatsApp into a 24/7 sales & support agent for your business — without paying for enterprise SaaS.

Features • Quick Start • How it works • Roadmap • Contributing

---

💡 Why BizBot?

Small and medium businesses live on WhatsApp — but they answer every message by hand. Missed messages = missed sales. Enterprise tools cost hundreds a month and are overkill.

BizBot is an open-source WhatsApp automation layer for SMBs: build bot flows, auto-reply to common questions, qualify leads, and manage every conversation from one inbox.

✨ Features

• 💬 Auto-reply — instant answers to FAQs, pricing, hours, location
• 🔀 Visual bot flows — branching conversations without code
• 📥 Shared inbox — one team, one view of every chat
• 🏷️ Lead capture & tagging — never lose a hot buyer
• 🔌 Extensible — plug in your own handlers and integrations

🚀 Quick Start

# 1. Clone
git clone https://github.com/Manish567Kumar/bizbot.git
cd bizbot

# 2. Install
npm install

# 3. Start infra (Postgres + Redis) and configure
cp .env.example .env
# add your WhatsApp API credentials to .env
docker compose up -d

# 4. Run the monorepo in dev
npm run dev

Then connect your WhatsApp Business number and send a test message.

🛠️ How it works

BizBot is a TypeScript monorepo (Turborepo). Inbound WhatsApp webhooks are validated and queued, then a worker matches them to a flow or hands off to the shared inbox.

Incoming WhatsApp webhook
        │  (validate + enqueue, return 200 fast)
        ▼
   ┌──────────┐   BullMQ / Redis   ┌──────────┐
   │  Express │ ─────────────────▶ │  Worker  │
   └──────────┘                    └────┬─────┘
                                        │
                                        ▼
   ┌──────────┐     matches a flow?     ┌─────────────┐
   │  Router  │ ──────────────────────▶ │  Bot Flow   │
   └──────────┘                         └─────────────┘
        │ no match                            │
        ▼                                     ▼
   ┌──────────┐                        ┌─────────────┐
   │  Inbox   │ ◀───── hand off ──────│ Auto-reply  │
   └──────────┘                        └─────────────┘

Stack: Express · Prisma · PostgreSQL · Redis + BullMQ · Zod · JWT — organized as apps/server, apps/mobile (React Native), and packages/shared.

🗺️ Roadmap

• Core message router
• Auto-reply engine
• Visual flow builder UI
• AI-powered replies (LLM fallback for unknown questions)
• Analytics dashboard
• Multi-number / multi-agent support

🤝 Contributing

PRs and issues are welcome! If BizBot is useful to you, please ⭐ star the repo — it genuinely helps others discover it.

1. Fork it
2. Create your branch (git checkout -b feature/amazing)
3. Commit (git commit -m 'Add amazing feature')
4. Push and open a PR

📄 License

MIT © Manish Kumar