Подключение ВКонтакте#

ВКонтакте (VK) — это социальная сеть, объединяющая множество инструментов и сервисов для общения и ведения бизнеса.

Эта пошаговая инструкция поможет вам подключить чат-бот Wisebot в мессенджер ВКонтакте.

Чат-бот способен взаимодействовать с пользователями через различные форматы контента:

• Текстовые сообщения любой сложности,
• Изображения,
• Интерактивные карусели,
• Аудиосообщения,
• Кнопки с предустановленными действиями или ссылками.

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

Этапы интеграции:

• Шаг 1. Настройки сообщений в VK
• Шаг 2. Создание ключа доступа в VK
• Шаг 3. Настройка Callback API в VK
• Шаг 4. Настройка интеграции в Wisebot
• Шаг 5. Подтверждение настроек в VK
• Советы по настройке ответов бота

Шаг 1. Настройки сообщений в VK#

1. Откройте страницу своего сообщества.

   

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

3. Включите настройку Сообщения сообщества и сохраните изменения.

   

4. Перейдите в раздел Настройки для бота.

5. Включите настройку Возможности ботов и установите отметку чекбокса Добавить кнопку «Начать». Сохраните изменения.

   

Шаг 2. Создание ключа доступа в VK#

1. Перейдите в раздел Настройки → Работа с API → вкладка Ключи доступа.
2. Нажмите на кнопку Создать ключ.

3. В открывшемся окне установите отметки чекбокса напротив настроек:

   • Разрешить приложению доступ к сообщениям сообщества,
   • Разрешить приложению доступ к фотографиям сообщества,
   • Разрешить приложению доступ к документам сообщества.

4. Нажмите Создать.

   

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

   

Шаг 3. Настройка Callback API в VK#

1. Перейдите на вкладку Callback API → Настройки сервера в разделе Настройки → Работа с API.
2. В поле Название при необходимости замените название сервера, выставленное по умолчанию.
3. В поле Версия API выберите версию 5.199.

4. В поле Адрес укажите адрес проекта Wisebot в формате https://your-domain.com/dev/123434/webhooks/vk/webhook.

   Адрес можно скопировать в Wisebot. Перейдите в раздел Настройки → Учетные данные. При необходмости выберите вкладку со средой развертывания Development или Production. Скопируйте значения base_url и socket_path.

   • Замените your-domain.com на значение из строки base_url.
   • Замените /dev/123434/ на значение из строки socket_path (без /socket.io/).

   

5. В поле Секретный ключ придумайте ключ.

6. Нажмите кнопку Сохранить.

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

Шаг 4. Настройка интеграции в Wisebot#

1. Откройте Wisebot и убедитесь, что настраиваете нужного бота. В боковом меню должно отображаться его имя.
2. Перейдите в раздел Настройки → Учетные данные.

3. Выберите вкладку со средой развертывания Development или Production.

   

4. Добавьте конфигурацию для ВКонтакте.

   vk:
     access_token: "Значение" # Ключ доступа, созданный на шаге 2
     confirmation_token: "Значение" # Строка, которую должен вернуть сервер, созданная на предыдущем шаге
     secret_key: "Значение"  # Секретный ключ, созданный на предыдущем шаге
     max_buttons_in_row: 1  # Опционально, максимальное кол-во кнопок в ряду, по умолчанию 1
   

   

5. Нажмите Сохранить и подтвердите перезапуск инстанса для выбранного окружения.

   

Шаг 5. Подтверждение настроек в VK#

1. Дождитесь окончания перезапуска и вернитесь на вкладку Callback API → Настройки сервера в разделе Настройки → Работа с API. Подтвердите настройки сервера по кнопке Подтвердить.

   

2. Перейдите на вкладку Типы событий.

3. Установите отметку чекбокса напротив настройки Входящее сообщение.

   

Теперь можно пообщаться с ботом. Для этого нажмите на кнопку Сообщение на странице сообщества. Можно ввести сообщение в появившемся окне, либо перейти к диалогу в разделе Чаты.

Для начала разговора пользователь может нажать кнопку «Начать».

💡 Чтобы бот смог правильно ответить на стартовое сообщение, убедитесь, что в Wisebot создана история или правило с намерением get_started.

Советы по настройке ответов бота#

• ВКонтакте не поддерживает разметку Markdown, поэтому все сообщения, оформленные в этом формате, в WiseBot преобразуются в обычный текст.

• ВКонтакте требует загружать все файлы в скрытый альбом группы. Если у вас есть изображения и аудиофайлы, рекомендуется вызвать интенты с этими элементами после первого запуска бота. Это позволит им загрузиться в альбомы, и в последующие разы они будут доступны из кэша (который очищается после каждой перезагрузки Rasa).

• Структурно все элементы карусели должны быть одинаковыми, при этом первый элемент определяет структуру остальных. Например, если первый элемент содержит заголовок, подзаголовок и три кнопки, то и все остальные элементы должны иметь такую же структуру.

• Нажатие на каждый из элементов карусели может сопровождаться выполнением действия: можно открыть ссылку или увеличить изображение. Если в WiseBot не установить действие по умолчанию, то по умолчанию будет установлено увеличение изображения. Если действие по умолчанию для первой карточки установить открытие ссылки, то и для всех остальных карточек должно быть установлено аналогичное действие.

• Требования для изображений: пропорции изображения: 13/8, минимальный размер: 221х136.

🔍 Подробнее про карусели можно прочитать на официальном портале документации dev.vk.com.