Шаблон чат-бота VKBotKit

Стандартный шаблон чат-бота, работающего на vkbotkit. Используйте этот репозиторий как основу для своего бота.

Структура репозитория

Файл / каталог	Назначение
assets	Каталог с медиафайлами (доступ через toolkit.assets либо tools.upload)
library	Каталог со скриптами обработчиков
bot.py	Корневой скрипт чат-бота (запуск и конфигурация основных настроек)
requirements.txt	Зависимости, необходимые для работы шаблона
.env	Файл с переменными окружения (создаётся вручную, см. шаг 5)

Установка и настройка бота в вашем сообществе ВКонтакте

0. Создайте сообщество ВКонтакте

Перейдите во вкладку «Сообщества» на сайте ВКонтакте или используйте ссылку vk.com/groups.

1. Перейдите в раздел для работы с API

Откройте вкладку «Управление» через первую ссылку в админ-меню вашего сообщества, затем перейдите во вкладку «Работа с API».

2. Создайте токен

В шапке раздела нажмите «Создать ключ». Выберите необходимые права для токена, нажмите «Создать» и подтвердите свою личность.

3. Настройте Long Poll сервер

1. В шапке раздела нажмите «Long Poll API».
2. Во вкладке «Настройки» включите пункт «Long Poll API» и выберите нужную версию API.
3. Во вкладке «Типы событий» выберите типы, которые будет обрабатывать бот. Обязательно включите «Входящие сообщения».

4. Клонируйте репозиторий бота

Мы используем репозиторий vkbotkit/template как шаблон. В результате получается репозиторий your_name/your_bot, где your_name — ваш никнейм, а your_bot — название созданного репозитория.

git clone https://github.com/your_name/your_bot.git
cd your_bot
pip install -r requirements.txt

5. Настройте переменные окружения

Бот готов к использованию, но перед запуском нужно указать полученный на шаге 2 ключ доступа и ID сообщества. Создайте в корне репозитория файл .env:

PUBLIC_TOKEN=ключ доступа от сообщества
PUBLIC_ID=ID сообщества
DEBUG_TOKEN=ключ доступа от сообщества в режиме отладки

• PUBLIC_TOKEN — ключ доступа от сообщества
• PUBLIC_ID — ID сообщества
• DEBUG_TOKEN — ключ доступа от сообщества в режиме отладки

6. Запустите бота

python bot.py

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

• vkbotkit — основной фреймворк
• Примеры — готовые примеры ботов