Подключить сценарий к сообществу ВКонтакте
Для подключения сценария к сообществу ВКонтакте откройте с компьютера полную версию платформы ВКонтакте. Если у вас нет возможности открыть сайт с компьютера или вы используете на компьютере мобильную версию, прокрутите страницу вниз и выберите «Версия для компьютера».
Далее следуйте плану:
Если оно еще не создано, создайте его по инструкции.
Важно, чтобы сообщество было открытым. Изменить тип сообщества можно в разделе «Управление»: нажмите «Настройки» → «Основная информация» → «Тип сообщества» → «Открытое».
Для этого нажмите «Управление» → «Работа с API».
Выберите «Создать ключ», поставьте галочки напротив всех пунктов и нажмите кнопку «Создать».
Далее скопируйте ключ доступа:
Важно! Если вы добавляете ключ из созданного ранее сообщества, убедитесь, что ключ начинается с «vk». Если ваш ключ не начинается с «vk», удалите текущий ключ и создайте новый по этой инструкции. Иначе интеграция не будет настроена.
Далее в верхнем меню с тремя точками нажмите «Интеграции» → «ВКонтакте» → «Создать подключение». Вставьте ключ в строку.
Если подключение чат-бота к сообществу ВКонтакте прошло успешно, появится следующее окно:
Важно! Если в сценарии нет шагов «Сообщение клиента» или «Ждем событие: чат-бот», то после нажатия на кнопку «Интеграции» выбор канала для чат-бота будет недоступен, так как в сценарии нет шагов для подключения к чат-боту.
В новом сообществе они включены по умолчанию. Если вы когда-то отключали сообщения в своем сообществе, можно в любой момент снова их включить. Для этого откройте раздел «Управление» → «Сообщения» → «Включены» и сохраните изменения.
Чтобы подключить возможности ботов, откройте раздел «Управление» → «Сообщения» → «Настройки для бота» → «Включены» и сохраните изменения.
Если хотите, чтобы бот мог видеть информацию о действиях, которые совершаются клиентом в сообществе ВК, необходимо выполнить настройки сервера в разделе «Управление» в сообществе, а также дать боту разрешение видимости тех событий, которые вам необходимы.
1. Для подключения сервера в настройках вашего сообщества откройте раздел «Управление» → «Работа с API» → «Callback API» → «Настройки сервера». В выпадающем списке в правом верхнем углу окна с настройками найдите сервер, в названии которого есть “CxHub”, выберите его и нажмите «Подтвердить».
Важно! После успешного подтверждения при первичном подключении сообщества, не подтверждайте повторно настройки сервера. Это вызовет ошибку интеграции, тогда потребуется потребуется удалить текущую интеграцию и добавить новую.
2. Для того, чтобы выдать боту разрешения видеть события, необходимо перейти во вкладку «Типы событий» и установить необходимые галочки.
Важно! Если у вас есть подключение к нескольким проектам в VK CXhub, убедитесь, что выбран сервер, который привязан к необходимому проекту. В во вкладке «Настройки сервера» в поле «Адрес» должен быть тот проект, который вам необходим:
Если хотите, чтобы бот мог видеть прочитанность сообщений, перейдите в раздел «Типы событий». Установите галочки для «Входящие события» и «Прочитанность сообщений».
Если хотите, чтобы чат-бот мог видеть подписку пользователей на сообщество или выход пользователя из сообщества, в разделе «Типы событий → Пользователи» установите галочки для «Подписка на сообщество» или «Выход из сообщества»:
Если хотите, чтобы чат-бот мог добавлять комментарии на стене сообщества, в разделе «Типы событий → Комментарии на стене» установите галочки для «Добавление».
Для того, чтобы чат-бот мог получать информацию об отметках «Мне нравится» под постом, необходимо установить галочку «Типы событий → Записи на стене → Добавление отметки «Нравится»»:
Для того, чтобы чат-бот мог получать информацию о репостах записей сообщества, необходимо установить галочку «Типы событий → Записи на стене → Добавление отметки «Поделились»»:
Статус набора текста
Для того, чтобы установить для сообщения чат-бота статус «Печатает», необходимо установить галочку «Типы событий → Сообщения → Добавление отметки «Статус набора текста»»:
Интеграция настроена! Нажмите на кнопку «Запустить сценарий», перейдите по ссылке, указанной под названием чат-бота, и протестируйте его по инструкции.
Важно! Перед запуском чат-бота рекомендуем изучить особенности и ограничения ВКонтакте: https://dev.vk.com/ru/bots-rules.