Yusuf078996/wells-carlton-telegram-bot

Telegram AI Concierge for The Wells Carlton Hotel & Apartments, Abuja, Nigeria # The Wells Carlton Hotel & Apartments — Telegram AI Concierge A professional, production-ready Telegram AI concierge bot for **The Wells Carlton Hotel & Apartments**, Abuja, Nigeria. The bot acts as a digital hotel concierge — handling room enquiries, reservation enquiries, dining information, spa & wellness, gym, pool, events, airport transfers, location, FAQs, and human escalation — all through natural conversational English. --- ## Table of Contents 1. Requirements 2. Python Installation 3. Virtual Environment Setup 4. Installing Dependencies 5. Creating the Telegram Bot with BotFather 6. Creating `.env` 7. Adding TELEGRAM_BOT_TOKEN 8. Adding AI API Key 9. Running Locally 10. Testing 11. Database Setup 12. Admin Configuration 13. Deployment 14. Troubleshooting --- ## 1. Requirements - **Python 3.11+** - A Telegram bot token (from @BotFather) - An AI API key (OpenAI or any OpenAI-compatible provider) — *optional but recommended* - pip (Python package manager) --- ## 2. Python Installation ### Ubuntu / Debian ```bash sudo apt update sudo apt install python3.11 python3.11-venv python3-pip ``` ### macOS (via Homebrew) ```bash brew install python@3.11 ``` ### Windows Download from python.org and install Python 3.11+. Verify: ```bash python3 --version ``` --- ## 3. Virtual Environment Setup ```bash cd wells-carlton-telegram-bot python3 -m venv venv ``` Activate: - **Linux/macOS:** `source venv/bin/activate` - **Windows:** `venv\Scripts\activate` --- ## 4. Installing Dependencies ```bash pip install -r requirements.txt ``` --- ## 5. Creating the Telegram Bot with BotFather 1. Open Telegram and search for @BotFather 2. Send `/newbot` 3. Follow the prompts: - Name: `Wells Carlton Concierge` - Username: `wells_carlton_concierge_bot` (must end in `_bot`) 4. BotFather will give you a **bot token** like: ``` 123456789:ABCdefGHIjklMNOpqrsTUVwxyz ``` 5. Copy the token — you'll add it to `.env` --- ## 6. Creating `.env` Copy the example file: ```bash …