Одноклассники
Эта статья содержит в себе инструкцию по интеграции сервиса Webim с социальной сетью Одноклассники.
Сегодня все компании и организации, ориентированные на клиента, вынуждены использовать максимально большое число коммуникационных каналов для общения с ними, регистрации заказов, технической поддержки. У каждого пользователя свои предпочтения: одни используют мессенджеры, другие социальные сети, третьи службу онлайн-консультирования на сайте.
Для операторов компаний, предоставляющих услуги и товары, это выливается в проблему: необходимо одновременно следить за активностью пользователей во множестве служб с разными интерфейсами. Операторам приходится переключаться между сервисами, ловить сообщения от пользователей, которые те отправляют то через один канал, то через другой. На этом теряется внимание, время, информация.
Одноклассники - одна из самых популярных в России социальных сетей. По аналогии с другими соцсетями, Одноклассники предлагают функциональность групп.
Кроме прочего, для участников группы предусмотрена функциональность Написать сообщение администрации этой группы. После чего между ними откроется чат. Этот чат с пользователями и можно подключить к сервису Webim в качестве канала общения.
Все сообщения пользователей из этих чатов попадут в общую очередь Webim и будут распределяться из неё между Вашими операторами. Общий интерфейс, общая очередь, общий список операторов и механизм обработки обращений. Это удобно и эффективно.
Вы можете подключить любое число групп в Одноклассниках к своей учётной записи Webim.
N.B.
Речь о функциональности, доступной через кнопку Написать сообщение на странице в группе, не о комментариях в темах группы и т. д.
Введение
Чтобы настроить интеграцию с социальной сетью Одноклассники в Webim, выполните следующие шаги:
-
Откройте сайт ok.ru и выполните вход в Ваш аккаунт Одноклассники, от лица которого создана (будет создана) группа. Обратите внимание, что для осуществления интеграции необходимо использовать аккаунт администратора группы. В противном случае (если аккаунт имеет иную роль в группе), сеть Одноклассники не предоставит доступа к группе для интеграции (т.е. не будет доступно получение токена - об этом речь идёт в следующих шагах данной инструкции).
-
Если группа уже была Вами создана, то перейдите к следующему разделу. Если нет, то создайте её, выполнив следующие шаги.
Создание группы
-
Перейдите в раздел Группы и нажмите кнопку Создать группу.

Раздел «Группы»: кнопка «Создать группу» -
Выберите тип Вашей группы.
-
Укажите название группы, её тематику, а также степень доступа к группе для других пользователей сети Одноклассники.
Далее нажмите Создать, чтобы завершить создание группы.
После создания группы Вы окажетесь на её главной странице.
Настройка группы
-
На странице Вашей группы откройте вкладку Настройки.

Вкладка «Настройки» на странице группы N.B.
Если Вы являетесь администратором группы, рядом с её названием отображается пометка Администратор. Если Вы её не наблюдаете, проверьте, что выполнен вход в аккаунт администратора группы.
-
В Настройках перейдите в раздел Сообщения. В выпадающем списке Отправлять сообщения могут выберите Гости и участники, затем нажмите Сохранить.

Раздел «Сообщения»: кто может писать в группу и ключ доступа -
В этом же разделе в секции Работа с API напротив Ключ доступа нажмите Получить ключ доступа. Во всплывающем окне подтвердите создание нового ключа доступа. Далее скопируйте полученный ключ.
Внимание!
В целях безопасности настоятельно рекомендуем сохранить данный ключ доступа в месте, недоступном для третьих лиц; также обратите внимание, что при генерации нового ключа доступа старый становится недействительным.
-
Откройте Панель управления Webim и перейдите в раздел Настройки, пункт Каналы общения.
-
В списке доступных каналов общения найдите Одноклассники и нажмите Добавить.
-
Заполните форму добавления канала сети Одноклассники:
-
Название канала: укажите имя, под которым канал будет виден оператору. Это имя не обязано совпадать с названием группы в Одноклассниках.
-
Токен авторизации группы: вставьте здесь скопированный ключ доступа.
-
Системные сообщения: поставьте галочку в этом чекбоксе, если Вы хотите, чтобы посетители видели системные сообщения в чате сети Одноклассники.
-
Выбор отдела: если Вы хотите, чтобы посетители могли выбрать отдел для обращения, то в первом поле укажите Обязателен, а во втором укажите отделы, среди которых может выбрать посетитель. Если выбор отдела посетителями не требуется, то в первом поле укажите Не нужен, а во втором выберите отдел, в который будут направляться обращения из сети Одноклассники, или оставьте Без отдела - в этом случае новые обращения будут видеть все свободные операторы вне зависимости от отдела.
-
Внешний идентификатор и Автоотключение при ошибках описаны в разделе Каналы общения. Внешний идентификатор нужен, только если к аккаунту подключён бот ЦРТ.
-
-
По окончании заполнения формы нажмите Сохранить.
На этом настройка интеграции Webim и Одноклассники завершается. Следующий раздел статьи описывает, как пользоваться созданным каналом общения.
Как использовать канал
После того, как Вы успешно настроили и подключили канал общения, можно приступить к проверке канала общения. Для этого выполните следующие шаги:
-
Откройте группу в сети Одноклассники под учётной записью, которая не является администратором группы.
-
Нажмите кнопку Написать.

Кнопка «Написать» на странице группы -
В открывшемся окне чата наберите сообщение произвольного содержания, например «тест», и нажмите кнопку отправки. Если интеграция настроена правильно, оператор в РМО увидит новое обращение из сети Одноклассники и сможет на него ответить.
Если при первой настройке сообщение не появляется в РМО, проверьте шаги этой инструкции. Если канал уже работал, а ответы оператора перестали доходить до посетителя, см. раздел Если ключ доступа стал недействительным. Если восстановить обмен не удалось, обратитесь в службу технической поддержки Webim.
Если ключ доступа стал недействительным
Для отправки сообщений из Webim в Одноклассники нужен действительный ключ доступа группы из поля Токен авторизации группы. Webim не показывает срок действия ключа, не предупреждает о необходимости его замены и не обновляет ключ автоматически. В Webim нельзя заранее определить, когда ключ перестанет действовать: можно проверить только текущую работоспособность обмена сообщениями. Такая проверка не гарантирует, что ключ останется действительным дальше.
Когда ключ может стать недействительным
По ответу службы поддержки API Одноклассников от 24 апреля 2024 года ключ может стать недействительным в следующих случаях:
-
пользователь, который получил ключ, заблокирован (обычно это администратор группы);
-
этот пользователь сменил пароль;
-
этот пользователь вышел из Одноклассников на всех устройствах;
-
для группы получен новый ключ доступа: предыдущий становится недействительным;
-
ключом не пользовались 30 дней.
Менять ключ каждые 30 календарных дней не нужно. По более раннему разъяснению поддержки Одноклассников, условие относится к отсутствию запросов с этим ключом в течение 30 дней. Поступление входящих сообщений само по себе не гарантирует, что такой запрос выполняется. Актуальная публичная документация Одноклассников не раскрывает механизм учёта активности ключа. В документации Bot API на октябрь 2026 года из перечисленных причин подтверждена только выдача нового ключа: предыдущий при этом становится недействительным.
Как заметить возможную проблему с ключом
Сообщения посетителей могут по-прежнему появляться в РМО, а ответ оператора до посетителя не доходит. В диалоге при этом выводится Посетитель не получил сообщение. Эта надпись сама по себе не доказывает, что ключ недействителен.
Сообщения, отправленные с профиля администратора группы, могут не поступать в РМО даже при действительном ключе.
Как проверить обмен сообщениями
Проверка показывает, работает ли канал сейчас. Она не предсказывает момент, когда ключ перестанет действовать.
-
Откройте группу под учётной записью Одноклассников, которая не является администратором группы. Как отправить сообщение, описано в разделе Как использовать канал.
-
Убедитесь, что сообщение появилось в РМО.
-
Ответьте на него от имени оператора.
-
Убедитесь, что ответ виден в чате группы на стороне Одноклассников.
Если сообщение посетителя не появилось в РМО, сначала убедитесь, что оно отправлено не с профиля администратора группы. Если входящие сообщения поступают, а ответы оператора не доставляются, одной из возможных причин является недействительный ключ. Проверьте, не возникло ли одно из перечисленных выше обстоятельств. При необходимости замените ключ по инструкции ниже.
Как заменить ключ в подключённом канале
Новый канал создавать не нужно.
-
Войдите на ok.ru под учётной записью администратора группы.
-
Откройте Настройки группы, раздел Сообщения. В секции Работа с API нажмите Получить ключ доступа, подтвердите создание и скопируйте новый ключ. Прежний ключ после этого недействителен.
-
В Панели управления Webim откройте Настройки, пункт Каналы общения.
-
Откройте уже добавленный канал Одноклассники.
-
Вставьте новый ключ целиком в поле Токен авторизации группы. Сохранённый ключ в форме показан не полностью: замените значение поля целиком, а не дописывайте символы к скрытой части.
-
Нажмите Сохранить.
-
Ещё раз проверьте обмен: сообщение с учётной записи, которая не является администратором группы, должно появиться в РМО, а ответ оператора — в чате на стороне Одноклассников.
Если форма не сохраняется и сообщает об ошибке обращения к внешнему сервису, настройки с новым ключом не сохранены. Проверьте, что скопирован ключ целиком и что вход выполнен администратором группы. Если после успешного сохранения ответы оператора по-прежнему не доходят или сообщение посетителя не появляется в РМО, обратитесь в службу технической поддержки Webim.