Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Telegram Lead Generation Bot (tg-webinar-leadgen)

Профессиональное решение для автоматизации сбора лидов на вебинарах и выдачи бонусных материалов. Бот интегрирован с Google Sheets для передачи данных в отдел продаж и использует локальное кэширование для предотвращения повторных выдач.

Ключевые особенности

  • Google Sheets API Integration: Автоматическая запись данных пользователей в реальном времени.
  • Anti-Abuse System: Локальная БД SQLite предотвращает мультиаккаунтинг и повторное получение подарков.
  • Advanced FSM Logic: Многоуровневая машина состояний для сбора ФИО, телефона и email с валидацией.
  • Environment-Based Config: Полная безопасность данных через переменные окружения, исключающая хардкод ключей.

Стек технологий

  • Python 3.10+
  • Aiogram 3.x (Асинхронный фреймворк)
  • SQLite (Локальный кэш)
  • Google Sheets API (через gspread)

Инструкция по локальному запуску

  1. Клонируйте репозиторий:
   git clone git@github.com:polyakovpavell/tg-webinar-leadgen.git
   cd tg-webinar-leadgen
  1. Настройте виртуальное окружение и установите зависимости:
   python -m venv venv
   source venv/bin/activate  # Для Windows: venv\Scripts\activate
   pip install -r requirements.txt
  1. Настройте переменные окружения:

    Создайте файл .env в корне проекта и заполните его вашими данными. Шаблон:

   BOT_TOKEN=ваш_токен_бота
   ADMINS=username1,username2
   SHEET_NAME=Название_вашего_листа
   SHEET_URL=https://docs.google.com/spreadsheets/d/...
   GOOGLE_SA_JSON_PATH=service_account.json
   GIFT_LINK_SALES=https://ваша-ссылка-на-продажи.com
   GIFT_LINK_STORIES=https://ваша-ссылка-на-сторис.com
   GIFT_LINK_REELS=https://ваша-ссылка-на-рилс.com
   CACHE_PATH=cache.db
   WEBINAR_DATE_ISO=2026-05-01T12:00:00Z
  1. Положите файл ключа сервисного аккаунта Google (service_account.json) в корень проекта.

  2. Запустите проект:

   python bot.py

About

Telegram-бот для автоматизации сбора лидов на вебинарах (Python, aiogram, SQLite, Google Sheets API)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages