...

1. Подготовка сообщества ВКонтакте

Бот работает от имени сообщества, поэтому сначала нужно подготовить его для приема сообщений от гостей.

1.1. Включите сообщения сообщества

1. Откройте ваше сообщество ВКонтакте.

2. Перейдите в Управление → Сообщения.

3. Убедитесь, что пункт Сообщения сообщества — включён.
   Это обязательно, иначе пользователи не смогут писать вашему боту.

Image Added

Рис. 1 

Image Added

Рис. 2

...

2. Настройка модуля "Сообщения" → "Настройки для бота"

Здесь вы включаете параметры, без которых бот не сможет полноценно работать.

Необходимо включить:

• Возможности ботов — должно быть включено.
  Это основная настройка, которая разрешает вашему сообществу работать как чат-бот.

• Добавить кнопку «Начать»
  Кнопка отображается у пользователя при первом входе в чат и помогает запустить сценарий общения.

• Разрешать добавлять сообщество в чаты
  Это нужно для корректной работы некоторых функций и повышает стабильность взаимодействия.

...

3. Настройка приветственного сообщения

Это сообщение пользователь увидит сразу после первого открытия чата с вашим ботом.

1. Перейдите: Управление → Сообщения → Приветствие.

2. Включите приветственное сообщение.

3. Введите текст приветствия.

✦ Важно: это сообщение отправляется автоматически, без участия администратора, и создаёт первое впечатление о вашем сервисе.

...

4. Получение ключа доступа (Access Token)

Ключ доступа — это «пароль» для безопасной связи бота с системой GK.
Без него интеграция работать не будет.

Как получить ключ:

1. Откройте ваше сообщество.

2. Перейдите: Управление → Дополнительно → Работа с API.

3. Нажмите Создать ключ.

4. Отметьте необходимые права (сообщения, управление и т.п.).

5. Подтвердите создание.

6. Скопируйте ключ и сохраните его.

Этот ключ необходимо передать вашему представителю Game-Keeper для подключения бота к системе.

...

5. Настройка Long Poll API

Long Poll API — это механизм, через который бот получает сообщения от пользователей в режиме реального времени.

Чтобы включить Long Poll API:

1. Перейдите: Управление → Работа с API → Long Poll API → Настройки.

2. Включите Long Poll API.

3. Установите версию API: 5.199.

...

6. Настройка типов событий

Чтобы бот корректно обрабатывал сообщения и действия пользователей, необходимо включить все необходимые события.

Перейдите в:
Управление → Работа с API → Long Poll API → Типы событий
и включите:

• Входящее сообщение

• Исходящее сообщение

• Редактирование сообщения

• Действия с сообщением

• Разрешение на получение
  (позволяет боту обрабатывать подписки/разрешения пользователей)

...

Итог

После выполнения всех шагов:

✓ ваше сообщество готово принимать сообщения;
✓ приветственное сообщение корректно отправляется;
✓ включён бот-режим и кнопка «Начать»;
✓ настроен Long Poll API;
✓ получен ключ доступа для интеграции;
✓ все типы событий активированы.

Бот полностью готов к подключению к системе GK.

Image Added

Рис. 1 

Image Added

Рис. 2

Image Added

Рис. 3

Для создания бота вам потребуются:

• Сообщество, от имени которого ваш бот будет общаться с пользователями ВКонтакте.

Сообщество

Для подключения чат-бота вы можете использовать любое своё сообщество ВКонтакте — группу, встречу или публичную страницу. Ваш бот должен соответствовать правилам, подробнее о них вы можете узнать здесь.

Первым делом нужно указать, что в вашем сообществе будет работать бот. Для этого в сообществе перейдите в Управление → Сообщения → Настройки для бота и включите пункт Возможности ботов.

Сообщество — это точка входа для пользователей, которые будут общаться с вашим ботом. Стоит позаботиться о том, чтобы оно выглядело привлекательно и содержало описание вашего бота, иначе его действия могут стать сюрпризом для пользователей. Не забудьте включить сообщения в вашем сообществе (Управление → Сообщения), когда бот будет готов к использованию, чтобы ему можно было написать.

...

Получение ключа доступа

Ключ доступа потребуется вам для получения обновлений (в Long Poll), а также для работы с API.

1. 1.

   Откройте vk.com и перейдите в сообщество, в котором вы являетесь администратором.

2. 2.

   В меню справа выберите Управление и затем Дополнительно → Работа с API.

3. 3.

   Нажмите Создать ключ. Отметьте необходимые права доступа и подтвердите свой выбор.

Image Added

Рис. 4

Image Added

Рис. 5

Image Added

Рис. 6

Image Added

Рис. 7

Image Added

Рис. 8

Image Added

Рис. 9