# Подключение Radiant Service Desk

Как установить коннектор и подключить Radiant Service Desk к ChatRex.

Интеграция подключает локальную систему Radiant Service Desk к ChatRex. Новые сообщения могут поступать как источник, а ответы бота — публиковаться в заявке как канал.

# Перед подключением

  • создайте отдельного пользователя интеграции в Radiant с минимально необходимыми правами;
  • подготовьте доступный извне HTTPS-адрес коннектора;
  • убедитесь, что сервер может принимать исходящие и входящие HTTPS-запросы.

# Установка коннектора

  1. В ChatRex откройте карточку Radiant Service Desk.
  2. Скачайте подготовленный пакет коннектора.
  3. Установите пакет в Radiant Service Desk по инструкции администратора вашей версии.
  4. В настройках коннектора создайте или скопируйте API-токен.
  5. Запишите HTTPS URL установленного коннектора.

# Подключение в ChatRex

  1. Укажите HTTPS URL коннектора ChatRex в Radiant.
  2. Вставьте API-токен коннектора.
  3. Нажмите Подключить и дождитесь проверки версии и возможностей коннектора.
  4. Проверьте, включены ли нужные режимы: Новые сообщения как источник и Публичные ответы как канал.
  5. Скопируйте появившиеся URL вебхука и секрет HMAC SHA-256.
  6. Настройте отправку исходящих событий в коннекторе Radiant.

Секрет HMAC показывается один раз. Сохраните его в защищённом хранилище. Коннектор подписывает тело события и передаёт идентификатор установки; изменённые или неподписанные события ChatRex отклоняет.

# Возможности

  • получение заявки и её переписки;
  • добавление внутренней заметки;
  • изменение статуса и приоритета;
  • назначение очереди или исполнителя;
  • передача заявки оператору с кратким резюме.

Фактический набор операций зависит от версии и возможностей установленного коннектора. Если нужная возможность не объявлена коннектором, соответствующее действие выполнить нельзя.

# Действия бота

Настройка операций описана в статье Действия Radiant Service Desk.

# Проверка

  1. Создайте тестовую заявку в Radiant.
  2. Проверьте получение сообщения в ChatRex.
  3. Добавьте внутреннюю заметку и смените статус тестовой заявки.
  4. Если включён канал, отправьте публичный ответ и проверьте его в Radiant.

# Отключение

Отключите интеграцию в ChatRex, затем отзовите API-токен и удалите настройки вебхука в коннекторе Radiant.