Appearance
ВКонтакте
Подключение сообщества ВКонтакте — чтобы агент отвечал в личных сообщениях группы. Настройка многошаговая: часть данных заводится в Диолеум, часть — в настройках сообщества VK. Порядок важен — идите строго по шагам.
Почему так сложно
VK не даёт «токен в один клик», как Telegram. Нужно вручную связать ваше сообщество и Диолеум через Callback API. Один раз настроите — дальше работает само.
Что понадобится
- Сообщество (группа или публичная страница) ВКонтакте, где вы — администратор
- Включённые сообщения сообщества
- Пара ключей из настроек VK (получим по ходу)
Шаг 1. Включите сообщения сообщества
- Ваше сообщество → Управление → Сообщения.
- Включите «Сообщения сообщества».
- Там же → Настройки для бота → включите «Возможности ботов» (чтобы бот мог отвечать).
Без этого VK не пропустит входящие сообщения к боту.
Шаг 2. Получите ключ доступа и ID сообщества
- Управление → Работа с API → Ключи доступа → Создать ключ.
- Отметьте права: «Сообщения сообщества» (и «Управление сообществом», если предложат).
- Скопируйте полученный токен — длинная строка.
- ID сообщества — число. Видно в адресе (
vk.com/club123456789→123456789) или в Управление → Работа с API.
Шаг 3. Заведите данные в Диолеум и получите адрес вебхука
- В Диолеум: Каналы → Добавить → ВКонтакте.
- Вставьте токен и ID сообщества.
- Сохраните — Диолеум покажет адрес вебхука (URL). Он понадобится на следующем шаге.
Шаг 4. Настройте Callback API в VK
- В VK: Управление → Работа с API → вкладка Callback API.
- Вставьте адрес вебхука из Диолеум в поле «Адрес сервера».
- VK покажет строку подтверждения — скопируйте её и вставьте в Диолеум в поле «Код подтверждения».
- В том же разделе VK задайте «Секретный ключ» (придумайте любую строку) и вставьте тот же ключ в Диолеум в поле «Секретный ключ».
Секретный ключ обязателен
Без него VK и Диолеум не смогут доверять друг другу — входящие сообщения будут отбрасываться. Ключ в VK и в Диолеум должен совпадать.
Шаг 5. Подтвердите и включите события
- В VK нажмите «Подтвердить» — статус сервера станет активным.
- В разделе «Типы событий» включите «Входящее сообщение».
- В Диолеум: Общее → выберите агента → включите канал.
Проверка
Напишите сообществу личное сообщение с другого аккаунта → ответ должен прийти от агента → диалог появится в Диалогах.
Проблемы
| Проблема | Решение |
|---|---|
| «Подтверждение не проходит» | Сначала сохраните токен+ID в Диолеум, возьмите адрес вебхука, только потом жмите «Подтвердить» в VK |
| Бот не отвечает | Проверьте: включены «Сообщения сообщества» и «Возможности ботов», задан секретный ключ, включено событие «Входящее сообщение» |
| Отвечает с задержкой/через раз | Проверьте, что права ключа включают «Сообщения сообщества» |
VK поддерживает исходящие рассылки и напоминания.
Дальше: Avito · Каналы: обзор · Диалоги