Skip to content

TheSuncatcher222/detective_announcer_bot

Repository files navigation

Detective Announcer Bot 🕵

Бот, предназначен для пересылки записей со стены сообщества Alibi и Detectit в выбранный телеграм чат/канал, создания более удобной системы опросов выбора игрового дня, чем это может предложить Telegram, а также ведения в чате истории побед команды.


Возможности

💨 Мгновенная пересылка новых записей со стены VK в телеграм чат.

🚨 Получение уведомления в телеграм чате от организации об успешной регистрации команды на игре.

📈 Сохранение истории побед (для игр, в которых команда заняла 1-5 место).

🙋‍♀️ Автоматическое создание наглядного сообщения-опроса с кнопками, содержащего вакантные игровые даты предстоящей игры с подробной информацией.

buttons_preview


Технологии

Python - целевой язык программирования.

Python

Telegram API - набор готовых классов, процедур, функций, структур и констант, предоставляемых социальной сетью Telegram, которые позволяют взаимодействовать с ее базой данных с помощью http-запросов.

Telegram

VK API - набор готовых классов, процедур, функций, структур и констант, предоставляемых социальной сетью VK (ВКонтакте), которые позволяют взаимодействовать с ее базой данных с помощью http-запросов.

Вконтакте


Установка

✅ Создать телеграм-бота согласно официальной инструкции .

✅ Получить VK токен по ссылке

Стоит выбрать токен VK.com. Однако в случае возникновения ошибок (например, API VK: vk_api.exceptions.ApiError: [3] Unknown method passed) необходимо выбрать токен VK Admin.

✅ Перейти в целевую папку проекта и клонировать репозиторий

git clone https://github.com/TheSuncatcher222/Detective_Announcer_Bot.git
cd Detective_Announcer_Bot

✅ Создать виртуальное окружение

Windows

python -3.9 -m venv venv

Linux

python3 -m venv venv

MacOS

brew link python@3.9

✅ Активировать виртуальное окружение

source venv/scripts/activate

✅ Обновить инсталлятор pip

python -m pip install --upgrade pip

✅ Установить зависимости из requirements.txt

pip install -r requirements.txt

✅ Перейти в папку с данными для подключения к API

cd project/data

✅ Переименовать файл .env.example в .env и заполнить его согласно примеру

# Нижеуказанный код приведен для консоли Bash:
mv .env.example .env
nano .env

✅ Вернуться в корневую папку и запустить сервер

cd ../..
python main.py

Лицензия

MIT Free Software, Hell Yeah!

Created by TheSuncatcher222

Данный бот не является официальным!