Telegram Auto-Funnel Bot (aiogram)

Бот делает простую авто-воронку: /start → выбор сегмента → проверка подписки на канал → серия сообщений по расписанию.

Требования

• Python 3.10+ (aiogram v3 требует современный Python) citeturn0search17
• Токен бота от @BotFather
• Канал, в который ты ведёшь трафик (бот должен быть админом канала, чтобы проверять подписку через getChatMember) citeturn0search2

Быстрый старт (локально)

1) Скачать проект и поставить зависимости

cd tg_autofunnel_bot
python -m venv .venv
# macOS/Linux:
source .venv/bin/activate
# Windows PowerShell:
# .\.venv\Scripts\Activate.ps1

python -m pip install --upgrade pip
pip install -r requirements.txt

2) Настроить .env

Скопируй пример:

cp .env.example .env

Открой .env и заполни:

• BOT_TOKEN — токен бота
• CHANNEL_ID — id канала (например @my_channel или числовой id вида -100...)
• ADMIN_IDS — ids админов через запятую (например 123,456)
• PAYMENT_URL — ссылка на оплату/лендинг (если пусто — кнопка покупки не появится)

3) Запуск

python -m bot.main

Как редактировать воронку

Файл: config/funnel.yaml

Там:

• segments — список сегментов (кнопки выбора)
• steps — шаги воронки
  • delay_minutes — задержка от момента запуска (минуты)
  • text — сообщение
  • buttons — кнопки (url / check_subscribe / restart)

Полезные команды

• /start — начать воронку
• /admin — статистика (только ADMIN_IDS)
• /resetme — стереть себя из базы (удобно для тестов)

Важно про проверку подписки

Telegram ограничивает getChatMember: для проверки подписки на канал бот обычно должен быть администратором канала. citeturn0search2