Build intelligent AI agents that don't just chat—they learn, act, and engage customers 24/7 across every channel.
AgentDesk isn't just another chatbot. It's a production-ready AI Agent that takes action on behalf of your business.
| Traditional Chatbots | AgentDesk AI Agents |
|---|---|
| 🤖 Scripted responses | 🧠 Learns from your content (RAG) |
| 💬 Just answers questions | 💪 Acts - Books meetings, captures leads |
| 🔄 Forgets context | 🤔 Remembers - Full conversation memory |
| 🌐 Website only | 🚀 Everywhere - Web, Telegram, WhatsApp |
| 🎲 One-size-fits-all | 🎨 Adapts - Custom personality & brand |
Built for scale. Multi-tenant architecture • Enterprise security • Production-ready.
🧠 RAG-Powered Intelligence - Click to expand
- Semantic Search with pgvector (1536-dim embeddings)
- GPT-4o-mini for natural conversations
- Conversation Memory - Context across entire chat history
- Website Scraper - Auto-index your content (Cheerio + Puppeteer)
- Multi-source Knowledge - Websites, docs, manual FAQs
- Real-time Learning - Updates knowledge base automatically
💪 AI Agent Actions - Click to expand
- 📅 Appointment Scheduling - Google Calendar integration with OAuth 2.0
- 📧 Email Automation - Confirmation & notifications via Resend API
- 💬 WhatsApp Business - Twilio integration with Message Templates
- 📱 SMS Fallback - Automatic SMS if WhatsApp unavailable
- 🎯 Lead Capture - Smart validation & automated follow-ups
- 🔄 Multi-step Workflows - Complex task automation with user confirmation
- 🔗 Extensible Actions - Add custom actions via OpenAI Function Calling
🌐 Multi-Channel Deployment - Click to expand
- 🌐 Web Widget - Embeddable on any website with customization
- 🔌 WordPress Plugin v1.2.0 - One-click install with auto-updates
- 📱 Telegram - Native bot integration with webhook support
- 💬 WhatsApp Business - Direct customer messaging via Twilio
- 🔗 Unified Knowledge Base - One agent, multiple channels
- 🎨 Brand Customization - Colors, personality, welcome messages
📊 Analytics & Usage Tracking - Click to expand
- Real-time Dashboard - Monitor conversations & performance
- Usage Analytics - Track bots, messages, WhatsApp sends
- Plan Limits Display - Visual progress bars with color-coded alerts
- Conversation History - Full audit trail & export capabilities
- Performance Metrics - Response times, user satisfaction
- Knowledge Gap Analysis - Identify missing content
💳 Subscription Management - Click to expand
- 4 Pricing Tiers - Starter, Growth, Plus, Premium
- 7-Day Free Trial - No credit card required, full feature access
- Trial Countdown - Real-time expiration tracking in header
- Automated Email Reminders - Days 3, 1, 0 before expiration
- Feature Gating - Enforce limits per plan automatically
- Usage Dashboard - Collapsible view of limits vs. current usage
- Plan Enforcement - Backend + Frontend validation
🔐 Enterprise Security - Click to expand
- Multi-Tenant RLS - Complete data isolation at database level
- Bot Token Auth - Secure API access per bot
- Domain Validation - Restrict bot usage to authorized domains
- Encrypted Storage - AES-256 encryption at rest
- TLS 1.3 - Encryption in transit
- Audit Logs - Track all bot interactions and changes
- Row Level Security - PostgreSQL RLS policies
graph LR
A[Client] --> B[Next.js Dashboard]
A --> C[Chat Widget]
B --> D[NestJS Backend]
C --> D
D --> E[OpenAI GPT-4o]
D --> F[(Supabase<br/>PostgreSQL + pgvector)]
D --> G[Google Calendar]
D --> H[Twilio WhatsApp]
D --> I[Resend Email]
style D fill:#00d4aa
style E fill:#10a37f
style F fill:#3ecf8e
📚 Tech Stack Details - Click to expand
Frontend:
- Framework: Next.js 14 (App Router)
- UI Library: React 18
- Styling: Tailwind CSS 3
- Components: shadcn/ui
- Auth: Supabase Auth
- Deployment: Vercel
Backend:
- Framework: NestJS 10
- Language: TypeScript 5
- API: REST
- Scraping: Cheerio, Puppeteer
- Deployment: Railway
Database:
- Primary: PostgreSQL (Supabase)
- Vector Search: pgvector extension
- Auth: Supabase Auth
- Real-time: Supabase Realtime
AI & ML:
- LLM: OpenAI GPT-4o-mini
- Embeddings: text-embedding-3-small (1536 dims)
- Similarity: Cosine similarity
- Actions: OpenAI Function Calling
Integrations:
- Messaging: Telegram Bot API, Twilio WhatsApp
- Calendar: Google Calendar API (OAuth 2.0)
- Email: Resend API
- WordPress: Custom plugin with auto-update system
📋 Prerequisites - Click to expand
Required:
- Node.js 18+
- Supabase Account (free tier available)
- OpenAI API Key (Get one here)
Optional (for bot actions):
- Google Cloud Account (for Calendar integration)
- Twilio Account (for WhatsApp)
- Resend Account (for email - 100/day free)
🚀 Installation Steps - Click to expand
git clone https://github.com/michalwilman/AgentDesk.git
cd AgentDesk
npm run install:allcp env.example .env# Database
SUPABASE_URL=https://xxxxx.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-key
# AI
OPENAI_API_KEY=sk-your-key
# Optional: Actions
GOOGLE_CLIENT_ID=your-client-id
GOOGLE_CLIENT_SECRET=your-secret
RESEND_API_KEY=re_your_key
TWILIO_ACCOUNT_SID=your-sid
TWILIO_AUTH_TOKEN=your-token
TWILIO_WHATSAPP_FROM=whatsapp:+14155238886- Create project at supabase.com
- Enable pgvector extension:
CREATE EXTENSION IF NOT EXISTS vector;
- Run
supabase/schema.sqlin SQL Editor - Apply all migrations from
supabase/migrations/
npm run dev
# Services:
# Frontend: http://localhost:3000
# Backend: http://localhost:3001/api
# Widget: http://localhost:3002- Visit
http://localhost:3000→ Register - Create Bot → Add website URL or content
- Configure Actions → Enable appointments, leads
- Test in Preview → Chat with your agent
- Get Embed Code → Add to your website!
🔌 WordPress Plugin - Full Installation Guide - Click to expand
Production-ready plugin with full Hebrew & RTL support.
- Download
wordpress-plugin/agentdesk-chatbot.zip - Upload to WordPress: Plugins → Add New → Upload
- Activate plugin
- Go to Settings → AgentDesk
- Enter your Bot Token (from AgentDesk dashboard)
- Save settings - ✅ Live in 60 seconds!
- ✅ One-click auto-updates - Update without deactivation
- ✅ Full Hebrew & RTL support - Perfect for Hebrew sites
- ✅ Real-time connection status - See bot health in dashboard
- ✅ Bot training status - Know when knowledge is ready
- ✅ Domain security - Restrict to your domain only
- ✅ Display rules - Control where widget appears
- ✅ Zero coding required - Configure in WordPress admin
Plugin Version: 1.2.0 (November 2025)
WordPress Requirements: 5.0+, PHP 7.4+
💳 View All Pricing Tiers - Click to expand
Perfect for small businesses getting started with AI
Limits:
- 1 AI Agent
- 100 conversations/month
- 500 WhatsApp messages/month
Features:
- Web widget
- Email notifications
- Lead capture
- Basic analytics
- Community support
For growing businesses scaling customer engagement
Limits:
- 3 AI Agents
- 500 conversations/month
- 2,000 WhatsApp messages/month
Features:
- Everything in Starter, plus:
- All channels (Telegram, WhatsApp)
- Google Calendar sync
- Appointment reminders
- Advanced analytics
- Priority email support
For established businesses with high volume
Limits:
- 10 AI Agents
- 5,000 conversations/month
- 10,000 WhatsApp messages/month
Features:
- Everything in Growth, plus:
- Remove AgentDesk branding
- Webhook integrations
- Custom branding
- Multiple team members
- API access
- Dedicated account manager
Enterprise solution with unlimited everything
Limits:
- ∞ Unlimited AI Agents
- ∞ Unlimited conversations
- ∞ Unlimited WhatsApp messages
Features:
- Everything in Plus, plus:
- Bring your own Twilio account
- SLA guarantee (99.9% uptime)
- 24/7 priority phone support
- Custom deployment options
- White-label solution
- Custom AI model training
Contact Sales for enterprise pricing
No credit card required • All features unlocked • Cancel anytime
E-Commerce • Order status, shipping info, product recommendations
SaaS • User onboarding, product questions, demo scheduling
Healthcare • Appointment scheduling, patient pre-screening
Real Estate • Property inquiries, viewing bookings, lead qualification
Professional Services • Consultation booking, client intake, automated follow-ups
🌐 Production Deployment Guide - Click to expand
- Dashboard: https://agentdesk-frontend-production.up.railway.app/
- Backend API: https://agentdesk-backend-production.up.railway.app/api
- Widget: https://agentdesk-widget-production.up.railway.app/
Live Demo: See it in action at tirufai.com
NODE_ENV=production
NEXT_PUBLIC_API_URL=https://your-backend.up.railway.app/api
FRONTEND_URL=https://your-frontend.vercel.app
WP_PLUGIN_VERSION=1.2.0- Backend: Connect Railway to GitHub → Deploy
- Frontend: Connect Vercel to GitHub → Deploy
- Database: Already hosted on Supabase
- Widget: Deploy to Railway alongside backend
- Configure: Update environment variables
📅 Completed & Planned Features - Click to expand
- ✅ Core RAG engine with pgvector semantic search
- ✅ Multi-channel deployment (Web, Telegram, WhatsApp)
- ✅ AI Agent Actions (Calendar, Email, WhatsApp Business)
- ✅ WordPress plugin v1.2.0 with auto-updates
- ✅ Subscription management (4 tiers: Starter, Growth, Plus, Premium)
- ✅ 7-day trial system with automated email reminders
- ✅ Usage tracking & plan limit enforcement
- ✅ Multi-tenant architecture with Row Level Security
- ✅ Full Hebrew & RTL support
- ✅ Google Calendar OAuth integration
- ✅ Twilio WhatsApp Business API integration
- ✅ Resend email automation
- 🔨 Document upload (PDF, DOCX, TXT)
- 🔨 Advanced analytics dashboard
- 🔨 Stripe payment integration
- 🔨 Bot performance optimization
- Q1 2026: Slack & Discord integration, A/B testing, Custom AI fine-tuning
- Q2 2026: Voice assistants, Multi-bot orchestration, Conversation flows
- Q3 2026: Mobile apps (iOS & Android), White-label solution, Enterprise SSO
- Q4 2026: AI marketplace, Advanced BI reporting, Multi-language models
- 📖 Backend Guide - API development & architecture
- 🎨 Frontend Guide - Dashboard development
- 🪟 Widget Integration - Embed widget on your site
- 🗄️ Database Schema - Migrations & RLS policies
- 🔌 WordPress Plugin - WordPress integration
We welcome contributions! Fork → Feature branch → Commit → Push → PR
Code Style: TypeScript strict mode • ESLint + Prettier • Conventional commits
Business Source License 1.1 - The Licensed Work is protected under BSL 1.1.
- ✅ Free for non-commercial use and companies < $1M revenue
- ✅ View, modify, and learn from the source code
- ❌ Not allowed: Using for competing AI chatbot/agent platforms commercially
- 🔄 Converts to MIT on November 4, 2028 (3 years)
For commercial/enterprise licensing: sales@agentdesk.com
See LICENSE for full details.
- 🐛 Bug Reports: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📧 Email Support: support@agentdesk.com
- 🏢 Enterprise Sales: sales@agentdesk.com
Built with ❤️ in Israel
AgentDesk - Where AI Meets Action 🚀
Get Started • Live Demo • ⭐ Star on GitHub
© 2025 AgentDesk. All rights reserved.