Skip to content

About

Telegram bot for collecting leads (aiogram 3): step-by-step form, validation, CSV / Google Sheets, admin notifications. Telegram-бот для приёма заявок.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Telegram-бот для приёма заявок

Демо-проект: бот, который принимает заявки от клиентов круглосуточно, проверяет введённые данные и сразу передаёт заявку администратору. Все заявки сохраняются в 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

Настройки (.env)

Параметр Что это
BOT_TOKEN токен бота от @BotFather
ADMIN_IDS Telegram ID администраторов через запятую (узнать свой ID: @userinfobot)
STORAGE csv или gsheet
CSV_PATH путь к CSV-файлу с заявками
GSHEET_ID ID Google Таблицы (для gsheet)
GOOGLE_CREDS путь к ключу сервисного аккаунта Google

Чтобы подключить Google Таблицу:

  1. Создайте сервисный аккаунт в Google Cloud и включите Google Sheets API.
  2. Дайте почте этого аккаунта доступ «Редактор» к таблице.

Работа 24/7 на сервере (Linux, systemd)

# /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.target
sudo systemctl enable --now leads-bot

Структура

leads_bot/
  texts.py       — все тексты, услуги, цены, FAQ (меняются без программиста)
  handlers.py    — логика диалога и анкета
  keyboards.py   — кнопки
  validators.py  — проверка телефона, почты, имени
  storage.py     — сохранение в CSV / Google Sheets
  config.py      — настройки из .env
tests/           — тесты логики без Telegram

Тесты

pytest -q

Стек

Python 3.11+, aiogram 3, gspread, python-dotenv, pytest.

About

Telegram bot for collecting leads (aiogram 3): step-by-step form, validation, CSV / Google Sheets, admin notifications. Telegram-бот для приёма заявок.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages