Подключение сообщества ВКонтакте
Как привязать своё сообщество VK к Adminica и отвечать пользователям по библиотеке знаний в личных сообщениях группы.
Перед началом
- У вас есть сообщество ВКонтакте (группа), где вы администратор.
- Включены сообщения сообщества и доступ к Callback API (документация VK API).
- Создан ключ доступа сообщества с правами «Управление сообществом» и «Сообщения сообщества».
- Аккаунт Adminica с балансом токенов.
Не подходит: личная страница без сообщества; массовые рассылки и push — не поддерживаются.
После подключения пользователи пишут в личные сообщения группы, Adminica отвечает по вашей библиотеке; токены списываются с вашего баланса.
Шаг 1. Настройте сообщество VK
- Откройте сообщество → Управление → Сообщения — включите сообщения сообщества.
- Управление → Работа с API → Ключи доступа — нажмите Создать ключ.
- Отметьте права Управление сообществом и Сообщения сообщества — сохраните ключ и скопируйте его (повторно он не показывается).
- Запишите номер сообщества (ID): в админке или в URL страницы
vk.com/club123456789→ ID123456789(без «club»).
Ссылка для пользователей на диалог с сообществом:
https://vk.com/im?sel=-{номер_сообщества}
Минус перед ID обязателен. Пример: https://vk.com/im?sel=-123456789
Шаг 2. Подключите сообщество в Adminica
- Войдите на adminica.ru под своим аккаунтом.
- Откройте Профиль → Безопасность и интеграции.
- В секции ВКонтакте укажите номер сообщества (ID) и ключ доступа.
- Нажмите Подключить сообщество.
Adminica проверит ключ, зарегистрирует сервер Callback API на adminica.ru, включит событие message_new и сохранит ключ в зашифрованном виде. Ключ в интерфейсе повторно не показывается. Одно сообщество на один аккаунт Adminica.
Шаг 2.1. Персональная ссылка (опционально)
Если у вас есть персональная ссылка с выбранными документами (вкладка «Ссылки» в профиле):
- Убедитесь, что в ссылке выбран хотя бы один документ.
- Нажмите кнопку с иконкой бота в карточке ссылки — она станет зелёной.
- Ответы в VK будут только по документам этой ссылки (и с её настройками характера).
Нужен подключённый MAX или VK. Одновременно активна одна ссылка на аккаунт.
Шаг 3. Как пользователи пишут
| Способ | Действие |
|---|---|
| Сообщения | Кнопка «Написать сообщение» на странице сообщества |
| Ссылка | https://vk.com/im?sel=-{номер_сообщества} |
Шаг 4. Проверка
- Откройте личные сообщения сообщества VK и отправьте короткий вопрос по вашей тематике.
- Ответ должен прийти в том же диалоге.
- В профиле проверьте, что баланс токенов уменьшается после ответов.
Частые проблемы
«Не удалось зарегистрировать Callback API»
- Проверьте права ключа: «Управление сообществом» и «Сообщения сообщества».
- В VK есть лимит серверов Callback — удалите старые в админке сообщества.
- URL Adminica должен быть доступен по HTTPS.
Сообщения не доходят / нет ответа
- Убедитесь, что сообщения сообщества включены.
- На балансе Adminica достаточно токенов.
- Переподключите интеграцию в профиле (отключить → подключить снова).
- Если включена персональная ссылка — проверьте документы в ссылке.
Кнопка бота в персональной ссылке неактивна
- Подключите MAX или VK в профиле.
- Выберите хотя бы один документ в ссылке.
Аналог для MAX: инструкция MAX · API Adminica · VK API
Отключение
Профиль → Безопасность → ВКонтакте → Отключить. Callback API снимается, сообщество в VK остаётся.