Одноклассники — подключение и проверка

Бот отвечает в сообщениях группы в Одноклассниках. Подключение идёт через приложение разработчика OK.

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

  • Группа в Одноклассниках, где вы администратор.
  • Приложение в настройках разработчика OK (apiok.ru) и его ключи.
  • Числовой ID группы — вида `70000000000000`.
  • Роль администратор в проекте ImpactBot: канал подключает только она.
  • Свободный слот канала в тарифе — иначе подключение остановится с сообщением про лимит.

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

ImpactBot спрашивает четыре значения, и все четыре обязательны: Access Token, Application Key, Application Secret Key и Group ID. Меньшим набором подключение не создаётся.

Приложению нужно выдать доступ к сообщениям группы — иначе токен формально живой, а список диалогов пустой. Application Key публичный, Application Secret Key секретный: поля местами не меняются, подпись запроса считается именно секретным ключом. Секрет хранится в базе зашифрованным.

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

  1. Создайте приложение в настройках разработчика OK, скопируйте Application Key и Application Secret Key.
  2. Выдайте приложению доступ к сообщениям группы.
  3. Получите Access Token и скопируйте ID группы.
  4. Проект → Каналы → Одноклассники → название, Access Token, Application Key, Application Secret Key, Group ID → «Подключить».

Адрес приёма указывается на стороне OK вручную. После подключения окно показывает готовый адрес с параметром `?token=` — скопируйте его кнопкой и укажите в настройках платформы OK как адрес уведомлений о сообщениях.

Параметр `?token=` — не украшение и не часть пути: подписи запросов у OK нет, поэтому приёмник проверяет источник события именно по этому секрету и отвергает всё остальное. Адрес без `?token=` работать не будет.

Проверка

Нажмите «Проверить» на карточке канала. Диагностика OK показывает: подтверждены ли ключи и какая это группа, приходили ли входящие, и отдельной строкой — что пробы отправки для Одноклассников нет. Проба не делается намеренно: OK не различает в ответе «нет прав» и «нет адресата», а проверка, которая не умеет отличить одно от другого, вводит в заблуждение.

После этого напишите в группу из Одноклассников — сообщение должно появиться в разделе «Диалоги».

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

  • «OK application key, application secret and group ID are required». Заполнены не все четыре поля.
  • «Invalid OK API credentials». Ключи от другого приложения, токен просрочен либо ID группы не тот.
  • Подключение прошло, диалогов нет. Приложению не выдан доступ к сообщениям группы.
  • Бот молчит. Адрес уведомлений не сохранён на стороне OK или указан без `?token=`.
  • Перепутаны ключи. Application Key публичный, Application Secret Key секретный — в поле секрета публичный ключ не подойдёт.