Перейти к основному содержимому

Интеграции

Внутренняя поддержка​

Режим Внутренняя не требует внешних реквизитов. Обращения, ответы, заметки, назначения и статусы обрабатываются в панели администратора.

Используйте его, если команда работает только в MMO-WEB или если внешний helpdesk ещё не готов.

Omnidesk​

Для подключения укажите:

  • поддомен аккаунта перед .omnidesk.ru;
  • email включённого сотрудника;
  • API-ключ этого сотрудника;
  • секрет входящего webhook;
  • сопоставление пользовательских полей.

Сгенерированный URL webhook доступен только для копирования. Добавьте его в Omnidesk для событий ответа сотрудника и изменения статуса.

Реквизиты сохраняются вместе после успешной проверки формата. Значения доступны только администраторам с правом изменения интеграций.

Пользовательские поля​

Для каждого внешнего поля задаются его ID, источник, порядок и состояние. Поддерживаются источники:

  • игровой сервер;
  • игровой аккаунт;
  • персонаж;
  • ID мастер-аккаунта;
  • статическое значение.

Статическое значение заполняется только для соответствующего источника. Пустые необязательные данные не отправляются.

Реквизиты, webhook и типизированное сопоставление пользовательских полей

Доставка и повтор​

Созданный тикет сохраняется сразу. При внешней обработке доставка выполняется отдельно:

  1. Ожидает доставки - запись сохранена и поставлена в очередь.
  2. Доставлено - внешний helpdesk подтвердил приём.
  3. Ошибка доставки - попытки завершились ошибкой; локальная история остаётся доступной.
  4. Повтор - администратор возвращает неуспешную доставку в очередь после исправления реквизитов или доступности провайдера.
Состояние доставки видно отдельно от рабочего статуса обращения
После исправления причины сотрудник запускает повтор без создания дубликата

Ограничения Omnidesk​

Лимит запросов определяется тарифом аккаунта Omnidesk. Система учитывает служебные заголовки оставшегося лимита и времени повторной попытки; запросы на запись расходуют лимит быстрее чтения.

Не запускайте массовый повтор, пока аккаунт заблокирован лимитом или реквизиты неверны. Сначала восстановите соединение, затем повторите несколько записей и проверьте результат.

Проверка подключения​

  1. Сохраните реквизиты и убедитесь, что проверка сотрудника успешна.
  2. Настройте webhook.
  3. Создайте обращение с игровым сервером, аккаунтом и персонажем.
  4. Проверьте внешнюю категорию и пользовательские поля.
  5. Ответьте из Omnidesk и проверьте ответ в кабинете.
  6. Измените статус во внешнем helpdesk и проверьте синхронизацию.
  7. Повторите webhook с тем же событием: дубликат сообщения не должен появиться.