VKB Spambot

Подготовка группы

1. Создайте группу ВК, выбрав тип "Группа по интересам"
2. Перейдите в Управление >
   2.1 Сообщения > Сообщения сообщества: Включены > Сохранить
   2.2 Сообщения > Настройки для бота > Возможности ботов: Включены > Разрешать добавлять сообщество в чаты > Сохранить
   2.3 Настройки > Работа с API > Создать ключ > Выбрать все галочки > Создать, затем его скопировать и отложить его, он понадобится позже
   2.4 Настройки > Работа с API > CallBack API > Версия API 5.131
   2.5 Настройки > Работа с API > CallBack API > Типы событий > Выбрать все галочки
   2.6 Настройки > Работа с API > Long Poll API > Long Poll API: Включено > Версия API 5.131
   2.7 Настройки > Работа с API > Long Poll API > Типы событий > Выбрать все галочки
   
3. Готово

Получение токена через сайт, без номера телефона

1. Перейдите на сайт
2. Нажмите на "Найстройки >>" > Сообщество > Введите ID группы > Получить
3. Даёте разрешение
4. Копируйте ваш токен в поле после слов access_token=, он начинается на vk1. (на момент написания readme)
5. Готово

Установка

Локально

1. Установите Python версии не ниже 3.10. При установке убедитесь, что отметили галочку
2. Скачайте и распакуйте
3. Откройте командную строку и введите следующую команду:

pip install -r requirements.txt --upgrade

4. Откройте файл config.py любым текстовым редактором и настройте бота под себя
5. Для запуска введите в командную строку bot.py

Функционал

Глобальный

token - токен(ы) групп. Вводится таким образом: token = ['токен'].
Если надо ввести два или больше, то так: token = ['токен 1', 'токен 2', ... , 'токен n']
owner_id - люди, которые смогут писать /restart. Служит для перезапуска бота. Вводится только цифровой id. Вводится таким образом: owner_id = ['123', '321']

Обязательные параметры для ввода в конфиг

command - команда для вызова. Вызов происходит через /. Вводится таким образом: command = 'something'
delay - задержка перед отправкой следующего сообщения. Вводится таким образом: delay = 0.33
delay_error - задержка перед отправкой следующего сообщения после ошибки. Вводится таким образом: delay_error = 10.0

Второстепенные команды для ввода в конфиг

message_counter_limit - ограничитель на количество сообщений. Отрицательные - спамят бесконечно. По умолчанию стоит -1. Вводится таким образом: message_counter_limit = 10
call_from_id - ID людей, которые могут вызывать бота. Вводится только цифровой id. По умолчанию ничего не стоит. Вводится таким образом: call_from_id = ['123', '321']
group_id - ID групп (ботов), которые будут реагировать на эту команду. Вводится только цифровой id. По умолчанию ничего не стоит. Вводится таким образом: group_id = ['123', '321']
any - False - вызывать смогут только из call_from_id. True - смогут вызывать все. По умолчанию стоит False. Вводится таким образом: any = True
text - текст сообщения. По умолчанию ничего не стоит. Вводится таким образом: text = 'something'
text_mode - режим отправляемого текста. 1 - стандартный режим, 2 - режим построчно, 3 - режим обрезки через символ "\". По умолчанию стоит 1. Со вторым режимом работает так: text = 'first text/nsecond text', сначала отправляет first text, затем second text. С третьим режимом работает так: text = 'one\\sec', сначала отправляет one, затем sec. Вводится таким образом: text_mode = 2
random_text - Случайно отправляет текст из режима текста 2 или 3. False - выключен, True - включен. По умолчанию стоит False. Вводится таким образом: any = True
attachment - Отправляет вложения: 'photo' — фото, 'video' — видео, 'audio' — аудио, 'doc' — докумен, 'wall' — пост на стене. Формат подписи такой: <Вложение><Владелец этого вложения>_<id вложения>, пример: photo514714577_457311228. По умолчанию ничего не стоит. Вводится таким образом: attachment = ['photo514714577_457311228', 'photo514714577_56432156']
random_attachment - Случайно отправляет из вписанных вложений. 0 - выключен, 1 - включен. По умолчанию стоит 0. Вводится таким образом: random_attachment = 1
button_mode - Вид отправляемых кнопок. 1 - стандартный режим, 2 - режим радуги, 3 - режим вируса, 4 - режим из бота "sparta raid", 0 - выключить кнопки. По умолчанию стоит 0. Вводится таким образом: button_mode = 1
mode1_button_colors - Цвета кнопкок для режима 1. Сделанно в виде массива (списка). 0 - зелёная, 1 - красная, 2 - синяя, 3 - серая. По умолчанию стоит [0, 1, 2, 3]. Вводится таким образом: mode1_button_colors = [2, 3, 1, 3]
mode1_2_3_buttons_text - Текст кнопкок для режимов 1, 2 и 3. Сделанно в виде массива (списка). По умолчанию стоит ['Button', 'Button', 'Button', 'Button']. Вводится таким образом: mode1_2_3_buttons_text = ['12', 'wte', 'fasf', '213']

Если attachment и text будут пустыми, то будет отправлять пустой текст

Полезные ссылки

Python 3.10.1 для Windows 7
VK Message editor by command
VK Always stay in conversation