Node.js 22+ Native
Zero NPM Dependencies
Multi-Tenant SaaS
15 Connectors
BotMaster AI โ Autonomous Omnichannel Social Growth SaaS
BotMaster AI is a turnkey, multi-tenant conversational AI SaaS platform. It continuously crawls, detects buying intent, and autonomously replies to discussions across 16 social networks and forums.
๐ Complete Commercial Feature Matrix
๐ 15 Connectors ยท 16 Platforms
Twitter/X v2, Reddit, YouTube, Threads, Instagram, Bluesky, Mastodon, GitHub Discussions, Discord, Telegram, Hacker News, TikTok, Pinterest, Discourse, Disqus, and Quora.
๐ง Conversational AI Engine
Google Gemini (Flash by default, model selectable in /admin), 0-100 tone slider (Professional, Balanced, Witty), multi-turn thread memory, negative sentiment filtering, and smart manual approval queue.
๐ณ Stripe & Razorpay Payments
Stripe Checkout (USD) and Razorpay (INR) with signed webhooks, server-side pricing, and idempotent fulfillment. Dynamic subscription tiers and tax invoices.
๐ง Transactional Emails & Webhooks
Onboarding welcome cards and tax receipts via Resend, SendGrid, or local Sandbox Simulator. Slack Block Kit and Microsoft Teams alerts.
๐ Hardened Security
Signed sessions, scrypt password hashing, admin RBAC, secret masking, and strict per-tenant isolation. Google/Apple sign-in uses verified ID tokens (enable with client IDs in /admin).
๐ First Admin Login
There are no default passwords in production. On first start the superadmin is created from the ADMIN_EMAIL / ADMIN_PASSWORD environment variables; if ADMIN_PASSWORD is unset, a random one-time password is printed to the server log.
The sample accounts below exist only on demo servers started with DEMO_MODE=true:
| Role | URL | Password | |
|---|---|---|---|
| Superadmin (demo) | /admin | [email protected] | admin123 |
| Demo User (demo) | /app | [email protected] | demo123 |
โก Installation & Deployment Guide
BotMaster AI runs with zero external npm dependencies on Node.js 22+ or Docker.
1. Local Development (60 Seconds)
node -v # Verify Node.js is 22 or higher cd social-bot-platform npm start
Open http://localhost:3000 in your browser.
2. Production Docker Compose
docker compose up -d docker compose ps
Mounts ./data to /app/data ensuring SQLite persistence across container updates.
3. Linux VPS (systemd + Nginx SSL)
Refer to the full guide in INSTALLATION_GUIDE.md for systemd unit file templates, Nginx reverse proxy configuration, and free Let's Encrypt SSL setup.
๐ Superadmin Control Center Manual
Access the control center at http://localhost:3000/admin with the superadmin created from ADMIN_EMAIL / ADMIN_PASSWORD (or the one-time password printed to the server log on first start).
Core Administrative Capabilities:
- Tenant Lifecycle: Create, edit, suspend, or delete tenant workspaces with isolated data scopes.
- Dynamic Plans: Add, edit, or archive subscription pricing tiers on the fly.
- Payment Gateways: Configure Stripe and Razorpay test/live credentials and webhook secrets.
- Email Dispatch: Switch between Local Simulator, Resend, and SendGrid, and trigger one-click test emails.
- Slack & Teams: Configure incoming webhooks with Block Kit and MessageCard payload formatting.
- Support Tickets: Review and respond to inquiries submitted from the Help Desk.
Full walkthrough available in ADMIN_MANUAL.md.
๐ 15 Connectors & API Integration Guide
Step-by-step developer portal guides for all 16 supported networks (15 connector modules; Meta covers Threads & Instagram).
| Platform | Method | Keys Required |
|---|---|---|
| Hacker News | Algolia Search API | None! (100% Free Firehose) |
| Bluesky | AT Protocol XRPC | Handle & App Password |
| Mastodon | Decentralized REST | Instance URL & Access Token |
| GitHub | Discussions / Issues | Personal Access Token |
| Discord | Bot & Webhooks | Bot Token & Channel Webhook |
| Telegram | Bot API | Bot Token (via @BotFather) & Chat ID |
| Twitter / X | API v2 REST | API Key & Secret, Access Token & Secret (OAuth 1.0a); Bearer Token for search |
| OAuth 2.0 | Client ID, Secret, Username, Password | |
| YouTube | Data API v3 | Google Cloud API Key |
| Threads / Instagram | Meta Graph API | Meta App ID, Secret, Access Token |
| TikTok & Pinterest | Developer APIs | Client Key, Secret & Access Token |
| Discourse & Disqus | Community APIs | Base URL & API Key |
| Quora | Radar Assistant | Built-in Search Radar & 1-Click Generator |
Full instructions available in CONNECTORS_GUIDE.md.
๐ก REST API Reference
Full specifications for multi-tenant HTTP endpoints. See API_REFERENCE.md for payload examples.
GET /api/stateโ Multi-tenant workspace configuration & metricsPOST /api/auth/registerโ Tenant registration & onboarding triggerPOST /api/crawl/cycleโ Immediate keyword crawl cyclePOST /api/queue/approveโ Manual queue approval & publicationPOST /api/payment/checkoutโ Process payment & dispatch invoice emailPOST /api/admin/email/testโ Trigger test transactional emailPOST /api/webhook/testโ Test Slack / MS Teams webhook alert
๐๏ธ CodeCanyon Item Description
The ready-to-copy HTML item description is saved at CODECANYON_ITEM_DESCRIPTION.html.
Title: BotMaster AI โ Autonomous Omnichannel Social Listening & Auto-Reply SaaS Platform
Tags: ai bot, social listening, auto reply, gemini flash, multi tenant saas, stripe billing, twitter bot, reddit bot, youtube bot, discord bot, threads bot, lead generation, marketing automation, nodejs saas, docker
Pricing: Regular: \$49 โ \$69 | Extended: \$199 โ \$299
๐ฆ Marketplace Packaging & Submission Checklist
Complete packaging structure and pre-submission checklist are documented in MARKETPLACE_SUBMISSION_CHECKLIST.md.
๐ Commercial License Agreement
BotMaster AI Commercial License (Regular & Extended) (c) 2026 BotMaster AI. All Rights Reserved. See LICENSE.txt in the root directory for the complete legal text.
๐ Changelog
See CHANGELOG.md for detailed milestone release notes.