Multi-Agent Salon Appointment Management with Telegram, GPT5-mini & Claude MCP

Description

🤖 Multi-Agent AI Telegram Bot for Service Businesses

Transform your salon/service business with this streamlined Telegram automation system featuring Claude integration, zero-setup database management, and intelligent conversation handling.

How It Works

Core Architecture
Claude MCP Integration** - Direct connection to Claude Sonnet 4 via Model Context Protocol
Streamlined 2-Agent System** - Booking Agent and Admin Agent (simplified from 5 for better reliability)
GPT-5 Mini Primary** with Gemini 2.5 Flash backup for cost-effective processing
Multi-Media Support** - Handles text, voice (Whisper transcription), images, and PDFs with cost extraction
Smart Acknowledgments** - "One moment…", "Let me check availability…" during processing
Rate Limiting & Spam Protection** - Configurable limits (default: 100 msg/hour) with professional UX

Zero-Setup Database Management

Autonomous Airtable Creation** - Bot creates all necessary tables automatically
Complete CRUD Operations** - Create, edit, delete services and settings via Telegram
Dynamic Business Configuration** - Modify hours, pricing, services conversationally
Friend Booking Support** - "Book for my friend Sarah" functionality

Setup Steps

Telegram Business API setup (detailed instructions included)
Airtable Base ID extraction (store in Redis or hardcode - recommended)
Google Calendar integration for scheduling
Redis for caching, rate limiting, and conversation memory
MCP Server deployment for Claude integration
Telegram for notifications

Key Features

Booking Management
Booking Limit Control** - Default 6 appointments per customer (configurable in workflow)
Service Name Matching** - GPT-5 Nano workflow for cost-optimized service recognition
24-Hour Advance Reminders** - Automatic Telegram reminders sent at 8 PM

Conversation Handling
Conversation Memory** maintains context across interactions
Error Resilience** with backup models and graceful failure handling

Use Cases

Perfect for:
Salons
Spas
Clinics
Consulting services
Any appointment-based business

Complete business setup happens through conversational commands - no manual database configuration required.

Transform your service business with intelligent automation powered by AI and Telegram integration.