ВКонтакте — подключение и проверка

Что нужно заранее

  • Сообщество ВКонтакте, где вы администратор или редактор (в личном профиле бот не работает).
  • В сообществе включены сообщения: «Управление» → «Сообщения» → «Включить».
  • Роль администратора в проекте ImpactBot и свободный слот канала в тарифе.

Права и доступы

Токену сообщества нужны права messages, manage, photos, docs, market — их выдаёт ВКонтакте при создании ключа доступа сообщества.

Если вы подключаетесь через вход по профилю ВКонтакте, отдельно запрашивается доступ к списку ваших сообществ — по нему мы показываем те, где вы администратор.

Подключение и вебхук

Есть три пути, все из «Каналы» → «Добавить канал» → ВКонтакте:

  1. Вход по профилю ВКонтакте — покажем список сообществ, где у вас есть права, и подключим выбранное.
  2. По ссылке или ID — поле «Ссылка или ID сообщества» принимает `vk.com/club123456` или просто число.
  3. Вручную по токену — три шага: «Название бота» и «ID сообщества», затем «Access Token» вида `vk1.a.…`, затем настройки Callback API.

Callback API мы пытаемся настроить автоматически. Когда это удалось, вы увидите «Callback API настроен автоматически». Когда нет — сообщение прямо скажет, что настроить надо руками: скопируйте значения из полей «Адрес сервера (скопируйте в VK)», «Строка подтверждения» и «Секретный ключ» в «Управление» → «Настройки» → «Работа с API» → «Callback API» и включите события «Входящее сообщение», «Разрешение на сообщения», «Запрет сообщений», «Событие кнопки».

Проверка

Нажмите «Проверить» на карточке канала. Если автонастройка не подтвердилась, диагностика так и скажет — это значит, что Callback API надо досмотреть в сообществе.

Затем напишите сообществу из своего аккаунта: диалог должен появиться в разделе «Диалоги».

Частые ошибки

  • «Invalid VK access token». Ключ доступа создан не для сообщества или отозван.
  • «Token does not belong to the specified group». Токен от одного сообщества, а ID указан от другого.
  • «Не удалось определить сообщество». Введите числовой ID или ссылку вида `vk.com/club123`, а не короткое имя со слэшами.
  • «В VK-профиле не найдено сообществ». Вы не администратор и не редактор ни в одном сообществе — права выдаёт владелец.
  • «Выключены в сообществе: …». Перечисленные события не включены в Callback API, и соответствующие триггеры не сработают.