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