Перейти к основному содержимому
Версия: Последняя

Канал Одноклассники: создание и настройка

Лицензия

Данный функционал доступен только при наличии модуля Одноклассники.

Доступы

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами. Для настройки интеграции также потребуется аккаунт в Одноклассниках с правами администратора группы.

1. Подготовка к настройке​

Перед настройкой канала необходимо:

  1. Иметь аккаунт в Одноклассниках.
  2. Иметь созданную группу в Одноклассниках, через которую будет осуществляться взаимодействие с клиентами.
  3. Иметь права администратора этой группы.
  4. Создать приложение в Одноклассниках и получить токен доступа к API.

2. Создание приложения в Одноклассниках​

Для взаимодействия IQChannels с Одноклассниками необходимо создать приложение и получить данные для работы с API.

2.1. Регистрация приложения​

  1. Перейдите на сайт Одноклассников и войдите в аккаунт.
  2. Убедитесь, что к аккаунту привязан адрес электронной почты.
  3. Получите права разработчика на портале Одноклассников.
  4. Перейдите в раздел «Игры» → «В разработке».
  5. Нажмите «Добавить приложение».
  6. Заполните форму создания приложения:
    • Название — название приложения.
    • Имя в ссылке — уникальное имя приложения латиницей без специальных символов.
    • Описание — краткое описание приложения длиной до 250 символов.
  7. Создайте приложение.

После создания приложения на привязанный адрес электронной почты поступят данные для работы с API:

  • Application ID — идентификатор приложения.
  • Public Key — публичный ключ приложения.
  • Secret Key — секретный ключ приложения.

Сохраните полученные данные.

2.2. Подключение платформы OAuth​

  1. Откройте настройки созданного приложения.
  2. В нижней части страницы нажмите «Добавить платформу».
  3. Выберите OAuth.
  4. При необходимости заполните параметры:
    • Ссылка на страницу — адрес страницы, на которой будет использоваться OAuth-авторизация.
    • Список redirect_uri — адреса, на которые разрешено перенаправлять пользователей после авторизации.
  5. Сохраните изменения.

3. Получение токена доступа​

Для подключения канала в IQChannels используется параметр access_token.

3.1. Генерация токена​

  1. Откройте настройки созданного приложения в Одноклассниках.
  2. Найдите блок «Генерация "вечного" access_token».
  3. Нажмите «Сгенерировать».
  4. Сохраните полученные значения:
    • access_token — токен доступа к API.
    • session_secret_key — секретный ключ сессии.

Для настройки канала в IQChannels потребуется значение access_token.

Безопасность

Не передавайте токен доступа и секретные ключи посторонним лицам. Храните их в защищённом месте.

3.2. Обновление токена​

Если после изменения прав приложения токен перестал работать:

  1. Откройте настройки приложения в Одноклассниках.
  2. Найдите блок «Генерация "вечного" access_token».
  3. Повторно сгенерируйте токен.
  4. Скопируйте новый access_token.
  5. Обновите токен в настройках канала IQChannels согласно разделу 5.

4. Создание канала в IQChannels​

Перед созданием канала убедитесь, что для системы активирована лицензия на модуль Одноклассники.

  1. Откройте нужный проект в IQChannels.
  2. Перейдите в раздел «Сегмент» → «Каналы».
  3. Нажмите «Создать канал».
  4. В поле «Тип канала» выберите «Одноклассники».
  5. Заполните остальные обязательные поля формы создания канала.
  6. Нажмите «Создать канал».

После создания канал появится в общем списке каналов. Откройте его для дальнейшей настройки.

5. Настройка канала​

Для подключения созданного канала необходимо указать токен доступа к API Одноклассников.

  1. В разделе «Сегмент» → «Каналы» откройте созданный канал «Одноклассники».
  2. Перейдите во вкладку «Настройки».
  3. В поле access_token вставьте токен, полученный на шаге 3.
  4. Нажмите «Изменить», чтобы сохранить настройки.

После сохранения система проверит возможность подключения с использованием указанного токена.

  • Если токен корректен и обладает необходимыми правами, система отобразит сообщение об успешном подключении.
  • Если токен некорректен или не имеет необходимых прав, система отобразит сообщение об ошибке.

6. Проверка работоспособности​

После настройки канала необходимо проверить получение и отправку сообщений.

6.1. Проверка входящих сообщений​

  1. Откройте созданную группу в Одноклассниках.
  2. Отправьте тестовое сообщение в чат группы или соответствующий канал взаимодействия.
  3. Откройте IQChannels и проверьте поступление нового обращения.
  4. Убедитесь, что текст сообщения отображается в обращении.

Для получения входящих сообщений приложение должно быть подписано на соответствующие события чатов через Webhook. Если обращения не поступают, перейдите к разделу 7.

6.2. Проверка исходящих сообщений​

  1. Откройте тестовое обращение, поступившее из Одноклассников.
  2. Отправьте ответ через интерфейс оператора IQChannels.
  3. Откройте соответствующий чат в Одноклассниках.
  4. Убедитесь, что сообщение доставлено клиенту.

При успешной проверке оператор может обмениваться сообщениями с клиентами через IQChannels без необходимости переходить в интерфейс Одноклассников.

7. Диагностика проблем​

Не удаётся подключить канал​

Если при сохранении настроек появляется ошибка:

  • Проверьте, что в поле access_token указан актуальный токен без лишних пробелов.
  • Убедитесь, что токен получен для нужного приложения.
  • Проверьте, что приложению предоставлены необходимые права для работы с API.
  • При изменении прав приложения повторно сгенерируйте токен и обновите его в IQChannels.

Входящие сообщения не поступают​

Если канал подключён, но новые обращения не создаются:

  • Убедитесь, что используется нужная группа Одноклассников.
  • Проверьте, что приложение имеет необходимые права для получения сообщений.
  • Убедитесь, что Webhook подписан на события чатов и использует корректный адрес для доставки событий.
  • Если подписка перестала работать, необходимо восстановить её через API Одноклассников.

Если самостоятельно восстановить подключение не удаётся, обратитесь к администратору системы для проверки настройки Webhook.

Исходящие сообщения не доставляются​

Если сообщения из IQChannels не поступают в Одноклассники:

  • Проверьте актуальность access_token.
  • Убедитесь, что у приложения есть права на отправку сообщений.
  • Проверьте наличие ошибок при отправке сообщения в IQChannels.
  • Если проблема сохраняется, обратитесь к администратору системы для проверки интеграции.

Токен перестал работать​

Если ранее работавший токен больше не позволяет взаимодействовать с API:

  1. Откройте настройки приложения в Одноклассниках.
  2. Повторно сгенерируйте access_token.
  3. Откройте настройки канала в IQChannels.
  4. Замените старый токен новым.
  5. Сохраните изменения и повторите проверку подключения.

8. Полезные ссылки​