Загрузка...

Подключение сообщества ВКонтакте

Как привязать своё сообщество VK к Adminica и отвечать пользователям по библиотеке знаний в личных сообщениях группы.

Перед началом

  • У вас есть сообщество ВКонтакте (группа), где вы администратор.
  • Включены сообщения сообщества и доступ к Callback API (документация VK API).
  • Создан ключ доступа сообщества с правами «Управление сообществом» и «Сообщения сообщества».
  • Аккаунт Adminica с балансом токенов.

Не подходит: личная страница без сообщества; массовые рассылки и push — не поддерживаются.

После подключения пользователи пишут в личные сообщения группы, Adminica отвечает по вашей библиотеке; токены списываются с вашего баланса.

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

  1. Откройте сообщество → Управление → Сообщения — включите сообщения сообщества.
  2. Управление → Работа с API → Ключи доступа — нажмите Создать ключ.
  3. Отметьте права Управление сообществом и Сообщения сообщества — сохраните ключ и скопируйте его (повторно он не показывается).
  4. Запишите номер сообщества (ID): в админке или в URL страницы vk.com/club123456789 → ID 123456789 (без «club»).

Ссылка для пользователей на диалог с сообществом:

https://vk.com/im?sel=-{номер_сообщества}

Минус перед ID обязателен. Пример: https://vk.com/im?sel=-123456789

Шаг 2. Подключите сообщество в Adminica

  1. Войдите на adminica.ru под своим аккаунтом.
  2. Откройте Профиль → Безопасность и интеграции.
  3. В секции ВКонтакте укажите номер сообщества (ID) и ключ доступа.
  4. Нажмите Подключить сообщество.

Adminica проверит ключ, зарегистрирует сервер Callback API на adminica.ru, включит событие message_new и сохранит ключ в зашифрованном виде. Ключ в интерфейсе повторно не показывается. Одно сообщество на один аккаунт Adminica.

Шаг 3. Как пользователи пишут

СпособДействие
СообщенияКнопка «Написать сообщение» на странице сообщества
Ссылкаhttps://vk.com/im?sel=-{номер_сообщества}

Шаг 4. Проверка

  1. Откройте личные сообщения сообщества VK и отправьте короткий вопрос по вашей тематике.
  2. Ответ должен прийти в том же диалоге.
  3. В профиле проверьте, что баланс токенов уменьшается после ответов.

Частые проблемы

«Не удалось зарегистрировать Callback API»

  • Проверьте права ключа: «Управление сообществом» и «Сообщения сообщества».
  • В VK есть лимит серверов Callback — удалите старые в админке сообщества.
  • URL Adminica должен быть доступен по HTTPS.

Сообщения не доходят / нет ответа

  • Убедитесь, что сообщения сообщества включены.
  • На балансе Adminica достаточно токенов.
  • Переподключите интеграцию в профиле (отключить → подключить снова).
  • Если включена персональная ссылка — проверьте документы в ссылке.

Кнопка бота в персональной ссылке неактивна

  • Подключите MAX или VK в профиле.
  • Выберите хотя бы один документ в ссылке.

Аналог для MAX: инструкция MAX · API Adminica · VK API

Отключение

Профиль → Безопасность → ВКонтакте → Отключить. Callback API снимается, сообщество в VK остаётся.