# Одноклассники

Эта статья содержит в себе инструкцию по интеграции сервиса **Webim** с социальной сетью **Одноклассники**.

Сегодня все компании и организации, ориентированные на клиента, вынуждены использовать максимально большое число коммуникационных каналов для общения с ними, регистрации заказов, технической поддержки. У каждого пользователя свои предпочтения: одни используют мессенджеры, другие социальные сети, третьи службу онлайн-консультирования на сайте.

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

**Одноклассники** - одна из самых популярных в России социальных сетей. По аналогии с другими соцсетями, **Одноклассники** предлагают функциональность групп.

Кроме прочего, для участников группы предусмотрена функциональность **Написать сообщение** администрации этой группы. После чего между ними откроется чат. Этот чат с пользователями и можно подключить к сервису **Webim** в качестве канала общения.

Все сообщения пользователей из этих чатов попадут в общую очередь **Webim** и будут распределяться из неё между Вашими операторами. Общий интерфейс, общая очередь, общий список операторов и механизм обработки обращений. Это удобно и эффективно.

Вы можете подключить любое число групп в **Одноклассниках** к своей учётной записи **Webim**.

!!! Note "N.B."
    Речь о функциональности, доступной через кнопку **Написать сообщение** на странице в группе, не о комментариях в темах группы и т. д.

## Введение

Чтобы настроить интеграцию с социальной сетью **Одноклассники** в **Webim**, выполните следующие шаги:

  1. Откройте сайт [ok.ru](https://ok.ru) и выполните вход в Ваш аккаунт **Одноклассники**, от лица которого создана (будет создана) группа. Обратите внимание, что для осуществления интеграции необходимо использовать аккаунт администратора группы. В противном случае (если аккаунт имеет иную роль в группе), сеть **Одноклассники** не предоставит доступа к группе для интеграции (т.е. не будет доступно получение токена - об этом речь идёт в следующих шагах данной инструкции).

  1. Если группа уже была Вами создана, то перейдите к [следующему разделу](#group-settings). Если нет, то создайте её, выполнив следующие шаги.

## Создание группы

  1. Перейдите в раздел **Группы** и нажмите кнопку **Создать группу**.

    ![Раздел «Группы»: кнопка «Создать группу»](https://webim.ru/kb/11.0/img/channels/social-network-messengers/ok/create-ok-group.webp){ style="width: 1024px; max-width: 100%" }

  1. Выберите тип Вашей группы.

  1. Укажите название группы, её тематику, а также степень доступа к группе для других пользователей сети **Одноклассники**.

     Далее нажмите **Создать**, чтобы завершить создание группы.

     После создания группы Вы окажетесь на её главной странице.

## Настройка группы { #group-settings }

  1. На странице Вашей группы откройте вкладку **Настройки**.

    ![Вкладка «Настройки» на странице группы](https://webim.ru/kb/11.0/img/channels/social-network-messengers/ok/open-group-settings.webp){ style="width: 1024px; max-width: 100%" }

    !!! Note "N.B."
        Если Вы являетесь администратором группы, рядом с её названием отображается пометка **Администратор**. Если Вы её не наблюдаете, проверьте, что выполнен вход в аккаунт администратора группы.

  1. В **Настройках** перейдите в раздел **Сообщения**. В выпадающем списке **Отправлять сообщения могут** выберите **Гости и участники**, затем нажмите **Сохранить**.

    ![Раздел «Сообщения»: кто может писать в группу и ключ доступа](https://webim.ru/kb/11.0/img/channels/social-network-messengers/ok/group-messages-settings.webp){ style="width: 1024px; max-width: 100%" }

  1. В этом же разделе в секции **Работа с API** напротив **Ключ доступа** нажмите **Получить ключ доступа**. Во всплывающем окне подтвердите создание нового ключа доступа. Далее скопируйте полученный ключ.

    !!! Warning "Внимание!"
        В целях безопасности настоятельно рекомендуем сохранить данный ключ доступа в месте, недоступном для третьих лиц; также обратите внимание, что при генерации нового ключа доступа старый становится недействительным.

  1. Откройте **Панель управления Webim** и перейдите в раздел **Настройки**, пункт **Каналы общения**.

  1. В списке доступных каналов общения найдите **Одноклассники** и нажмите **Добавить**.

  1. Заполните форму добавления канала сети **Одноклассники**:

    * **Название канала**: укажите имя, под которым канал будет виден оператору. Это имя не обязано совпадать с названием группы в **Одноклассниках**.

    * **Токен авторизации группы**: вставьте здесь скопированный ключ доступа.

    * **Системные сообщения**: поставьте галочку в этом чекбоксе, если Вы хотите, чтобы посетители видели системные сообщения в чате сети **Одноклассники**.

    * **Выбор отдела**: если Вы хотите, чтобы посетители могли выбрать отдел для обращения, то в первом поле укажите **Обязателен**, а во втором укажите отделы, среди которых может выбрать посетитель. Если выбор отдела посетителями не требуется, то в первом поле укажите **Не нужен**, а во втором выберите отдел, в который будут направляться обращения из сети Одноклассники, или оставьте **Без отдела** - в этом случае новые обращения будут видеть все свободные операторы вне зависимости от отдела.

    * **Внешний идентификатор** и **Автоотключение при ошибках** описаны в разделе [Каналы общения](https://webim.ru/kb/11.0/channels/). **Внешний идентификатор** нужен, только если к аккаунту подключён бот **ЦРТ**.

  1. По окончании заполнения формы нажмите **Сохранить**.

На этом настройка интеграции **Webim** и **Одноклассники** завершается. Следующий раздел статьи описывает, как пользоваться созданным каналом общения.

---

## Как использовать канал { #usage }

После того, как Вы успешно настроили и подключили канал общения, можно приступить к проверке канала общения. Для этого выполните следующие шаги:

  1. Откройте группу в сети **Одноклассники** под учётной записью, которая не является администратором группы.

  1. Нажмите кнопку **Написать**.

    ![Кнопка «Написать» на странице группы](https://webim.ru/kb/11.0/img/channels/social-network-messengers/ok/write-message-to-group.webp){ style="width: 1024px; max-width: 100%" }

  1. В открывшемся окне чата наберите сообщение произвольного содержания, например «тест», и нажмите кнопку отправки. Если интеграция настроена правильно, оператор в **РМО** увидит новое обращение из сети **Одноклассники** и сможет на него ответить.

Если при первой настройке сообщение не появляется в **РМО**, проверьте шаги этой инструкции. Если канал уже работал, а ответы оператора перестали доходить до посетителя, см. раздел [Если ключ доступа стал недействительным](#invalid-access-key). Если восстановить обмен не удалось, обратитесь в службу [технической поддержки](mailto:support@webim.ru) **Webim**.

---

## Если ключ доступа стал недействительным { #invalid-access-key }

Для отправки сообщений из **Webim** в **Одноклассники** нужен действительный ключ доступа группы из поля **Токен авторизации группы**. **Webim** не показывает срок действия ключа, не предупреждает о необходимости его замены и не обновляет ключ автоматически. В **Webim** нельзя заранее определить, когда ключ перестанет действовать: можно проверить только текущую работоспособность обмена сообщениями. Такая проверка не гарантирует, что ключ останется действительным дальше.

### Когда ключ может стать недействительным

По ответу службы поддержки API Одноклассников от 24 апреля 2024 года ключ может стать недействительным в следующих случаях:

  * пользователь, который получил ключ, заблокирован (обычно это администратор группы);

  * этот пользователь сменил пароль;

  * этот пользователь вышел из **Одноклассников** на всех устройствах;

  * для группы получен новый ключ доступа: предыдущий становится недействительным;

  * ключом не пользовались 30 дней.

Менять ключ каждые 30 календарных дней не нужно. По более раннему разъяснению поддержки Одноклассников, условие относится к отсутствию запросов с этим ключом в течение 30 дней. Поступление входящих сообщений само по себе не гарантирует, что такой запрос выполняется. Актуальная публичная документация Одноклассников не раскрывает механизм учёта активности ключа. В документации [Bot API](https://apiok.ru/dev/graph_api/bot_api) на октябрь 2026 года из перечисленных причин подтверждена только выдача нового ключа: предыдущий при этом становится недействительным.

### Как заметить возможную проблему с ключом

Сообщения посетителей могут по-прежнему появляться в **РМО**, а ответ оператора до посетителя не доходит. В диалоге при этом выводится **Посетитель не получил сообщение.** Эта надпись сама по себе не доказывает, что ключ недействителен.

Сообщения, отправленные с профиля администратора группы, могут не поступать в **РМО** даже при действительном ключе.

### Как проверить обмен сообщениями

Проверка показывает, работает ли канал сейчас. Она не предсказывает момент, когда ключ перестанет действовать.

  1. Откройте группу под учётной записью **Одноклассников**, которая не является администратором группы. Как отправить сообщение, описано в разделе [Как использовать канал](#usage).

  1. Убедитесь, что сообщение появилось в **РМО**.

  1. Ответьте на него от имени оператора.

  1. Убедитесь, что ответ виден в чате группы на стороне **Одноклассников**.

Если сообщение посетителя не появилось в **РМО**, сначала убедитесь, что оно отправлено не с профиля администратора группы. Если входящие сообщения поступают, а ответы оператора не доставляются, одной из возможных причин является недействительный ключ. Проверьте, не возникло ли одно из перечисленных выше обстоятельств. При необходимости замените ключ по инструкции ниже.

### Как заменить ключ в подключённом канале

Новый канал создавать не нужно.

  1. Войдите на [ok.ru](https://ok.ru) под учётной записью администратора группы.

  1. Откройте **Настройки** группы, раздел **Сообщения**. В секции **Работа с API** нажмите **Получить ключ доступа**, подтвердите создание и скопируйте новый ключ. Прежний ключ после этого недействителен.

  1. В **Панели управления Webim** откройте **Настройки**, пункт **Каналы общения**.

  1. Откройте уже добавленный канал **Одноклассники**.

  1. Вставьте новый ключ целиком в поле **Токен авторизации группы**. Сохранённый ключ в форме показан не полностью: замените значение поля целиком, а не дописывайте символы к скрытой части.

  1. Нажмите **Сохранить**.

  1. Ещё раз проверьте обмен: сообщение с учётной записи, которая не является администратором группы, должно появиться в **РМО**, а ответ оператора — в чате на стороне **Одноклассников**.

Если форма не сохраняется и сообщает об ошибке обращения к внешнему сервису, настройки с новым ключом не сохранены. Проверьте, что скопирован ключ целиком и что вход выполнен администратором группы. Если после успешного сохранения ответы оператора по-прежнему не доходят или сообщение посетителя не появляется в **РМО**, обратитесь в службу [технической поддержки](mailto:support@webim.ru) **Webim**.

---

Источник: https://webim.ru/kb/11.0/channels/social-network-messengers/ok.html
