| Информация | |
|---|---|
Чтобы сервис Онлайн-помощник парка корректно работал с вашим VK-ботом, необходимо правильно настроить сообщество и выдать доступы. Ниже приведено подробное и понятное руководство.
|
1. Настройка сообщений сообщества и приветственного сообщения
Чтобы пользователи могли писать вашему боту и получать первое автоматическое сообщение, необходимо настроить раздел Сообщения в сообществе ВКонтакте.
Шаги настройки:
Откройте ваше сообщество ВКонтакте.
Перейдите в Управление → Сообщения.
Убедитесь, что пункт Сообщения сообщества — включён.
Это обязательное условие, иначе пользователи не смогут начать диалог с ботом.В этом же разделе настройте Приветствие.
Укажите текст приветствия, который увидит пользователь при первом открытии чата.
✦ Важно: приветственное сообщение отправляется автоматически, без участия администратора, и формирует первое впечатление о вашем сервисе.
Рис. 1
Рис. 2
...
2. Настройка модуля "Сообщения" → "Настройки для бота"
Здесь вы включаете параметры, без которых бот не сможет полноценно работать.
Необходимо включить:
Возможности ботов — должно быть включено.
Это основная настройка, которая разрешает вашему сообществу работать как чат-бот.Добавить кнопку «Начать»
Кнопка отображается у пользователя при первом входе в чат и помогает запустить бота.Разрешать добавлять сообщество в чаты
Это нужно для корректной работы некоторых функций и повышает стабильность взаимодействия.
Рис. 3
Рис. 4
...
4. Получение ключа доступа (API Token)
Ключ доступа — это «пароль» для безопасной связи бота с системой GK.
Без него интеграция работать не будет.
Как получить ключ:
Откройте ваше сообщество.
Перейдите: Управление → Дополнительно → Работа с API.
Нажмите Создать ключ.
Отметьте необходимые права (сообщения, управление и т.п.).
Подтвердите создание нажав кнопку - Создать.
Скопируйте целиком весь ключ и сохраните его.
Этот ключ необходимо передать представителю Game-Keeper для подключения бота к системе.
Рис. 5
Рис. 6
Рис. 7
Рис. 8
...
5. Настройка Long Poll API
Long Poll API — это механизм, через который бот получает сообщения от пользователей в режиме реального времени.
Чтобы включить Long Poll API:
Перейдите: Управление → Дополнительно → Работа с API → Long Poll API → Настройки.
Включите Long Poll API.
Установите версию API: 5.199.
Рис. 9
...
6. Настройка типов событий
Чтобы бот корректно обрабатывал сообщения и действия пользователей, необходимо включить все необходимые события.
Перейдите в:
Управление → Дополнительно → Работа с API → Long Poll API → Типы событий
и включите:
Входящее сообщение
Исходящее сообщение
Редактирование сообщения
Действия с сообщением
Разрешение на получение
(позволяет боту обрабатывать подписки/разрешения пользователей)
Рис. 10
...
Итог
После выполнения всех шагов:
✓ ваше сообщество готово принимать сообщения;
✓ приветственное сообщение корректно отправляется;
✓ включён бот-режим и кнопка «Начать»;
✓ настроен Long Poll API;
✓ получен ключ доступа для интеграции;
✓ все типы событий активированы.
Бот полностью готов к подключению к системе GK
Для создания бота вам потребуются:
- Сообщество, от имени которого ваш бот будет общаться с пользователями ВКонтакте.
Сообщество
Для подключения чат-бота вы можете использовать любое своё сообщество ВКонтакте — группу, встречу или публичную страницу. Ваш бот должен соответствовать правилам, подробнее о них вы можете узнать здесь.
Первым делом нужно указать, что в вашем сообществе будет работать бот. Для этого в сообществе перейдите в Управление → Сообщения → Настройки для бота и включите пункт Возможности ботов.
Сообщество — это точка входа для пользователей, которые будут общаться с вашим ботом. Стоит позаботиться о том, чтобы оно выглядело привлекательно и содержало описание вашего бота, иначе его действия могут стать сюрпризом для пользователей. Не забудьте включить сообщения в вашем сообществе (Управление → Сообщения), когда бот будет готов к использованию, чтобы ему можно было написать.
Итак, если вы выбрали сообщество, можно приступать к настройке уведомлений.
Получение ключа доступа
Ключ доступа потребуется вам для получения обновлений (в Long Poll), а также для работы с API.
...
Откройте vk.com и перейдите в сообщество, в котором вы являетесь администратором.
...
В меню справа выберите Управление и затем Дополнительно → Работа с API.
...
.