Демо-проект: бот, который принимает заявки от клиентов круглосуточно, проверяет введённые данные и сразу передаёт заявку администратору. Все заявки сохраняются в CSV (открывается в Excel) или в Google Таблицу.
Пример настроен под вымышленную студию красоты «Лаванда». Под другой бизнес меняется только файл texts.py: услуги, цены, вопросы и ответы.
- Меню: запись, услуги и цены, частые вопросы, контакты.
- Пошаговая анкета: имя → телефон → e-mail (по желанию) → услуга → удобное время → комментарий → подтверждение.
- Проверка ввода:
- телефон в любом формате приводится к виду
+79991234567, международные номера тоже; - можно отправить номер одной кнопкой;
- проверяются e-mail и имя.
- телефон в любом формате приводится к виду
- Подтверждение: перед отправкой клиент видит сводку и может заполнить заявку заново.
- Уведомление администратору (одному или нескольким) с именем, телефоном и ссылкой на Telegram клиента.
- Хранение: CSV или Google Таблица, переключается одной настройкой.
- Для админа: команда
/statsпоказывает число заявок. - Если клиент пишет текст там, где нужна кнопка, бот подсказывает.
/cancelотменяет анкету. - Безопасность: ввод пользователя экранируется, так что HTML-разметка от клиента не ломает сообщения.
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env # и заполните .env
python -m leads_bot| Параметр | Что это |
|---|---|
BOT_TOKEN |
токен бота от @BotFather |
ADMIN_IDS |
Telegram ID администраторов через запятую (узнать свой ID: @userinfobot) |
STORAGE |
csv или gsheet |
CSV_PATH |
путь к CSV-файлу с заявками |
GSHEET_ID |
ID Google Таблицы (для gsheet) |
GOOGLE_CREDS |
путь к ключу сервисного аккаунта Google |
Чтобы подключить Google Таблицу:
- Создайте сервисный аккаунт в Google Cloud и включите Google Sheets API.
- Дайте почте этого аккаунта доступ «Редактор» к таблице.
# /etc/systemd/system/leads-bot.service
[Unit]
Description=Leads Telegram bot
After=network.target
[Service]
WorkingDirectory=/opt/leads-bot
ExecStart=/opt/leads-bot/venv/bin/python -m leads_bot
Restart=always
[Install]
WantedBy=multi-user.targetsudo systemctl enable --now leads-botleads_bot/
texts.py — все тексты, услуги, цены, FAQ (меняются без программиста)
handlers.py — логика диалога и анкета
keyboards.py — кнопки
validators.py — проверка телефона, почты, имени
storage.py — сохранение в CSV / Google Sheets
config.py — настройки из .env
tests/ — тесты логики без Telegram
pytest -qPython 3.11+, aiogram 3, gspread, python-dotenv, pytest.