Интеграции
Внутренняя поддержка
Режим Внутренняя не требует внешних реквизитов. Обращения, ответы, заметки, назначения и статусы обрабатываются в панели администратора.
Используйте его, если команда работает только в MMO-WEB или если внешний helpdesk ещё не готов.
Omnidesk
Для подключения укажите:
- поддомен аккаунта перед .omnidesk.ru;
- email включённого сотрудника;
- API-ключ этого сотрудника;
- секрет входящего webhook;
- сопоставление пользовательских полей.
Сгенерированный URL webhook доступен только для копирования. Добавьте его в Omnidesk для событий ответа сотрудника и изменения статуса.
Реквизиты сохраняются вместе после успешной проверки формата. Значения доступны только администраторам с правом изменения интеграций.
Пользовательские поля
Для каждого внешнего поля задаются его ID, источник, порядок и состояние. Поддерживаются источники:
- игровой сервер;
- игровой аккаунт;
- персонаж;
- ID мастер-аккаунта;
- статическое значение.
Статическое значение заполняется только для соответствующего источника. Пустые необязательные данные не отправляются.
Доставка и повтор
Созданный тикет сохраняется сразу. При внешней обработке доставка выполняется отдельно:
- Ожидает доставки - запись сохранена и поставлена в очередь.
- Доставлено - внешний helpdesk подтвердил приём.
- Ошибка доставки - попытки завершились ошибкой; локальная история остаётся доступной.
- Повтор - администратор возвращает неуспешную доставку в очередь после исправления реквизитов или доступности провайдера.
Ограничения Omnidesk
Лимит запросов определяется тарифом аккаунта Omnidesk. Система учитывает служебные заголовки оставшегося лимита и времени повторной попытки; запросы на запись расходуют лимит быстрее чтения.
Не запускайте массовый повтор, пока аккаунт заблокирован лимитом или реквизиты неверны. Сначала восстановите соединение, затем повторите несколько записей и проверьте результат.
Проверка подключения
- Сохраните реквизиты и убедитесь, что проверка сотрудника успешна.
- Настройте webhook.
- Создайте обращение с игровым сервером, аккаунтом и персонажем.
- Проверьте внешнюю категорию и пользовательские поля.
- Ответьте из Omnidesk и проверьте ответ в кабинете.
- Измените статус во внешнем helpdesk и проверьте синхронизацию.
- Повторите webhook с тем же событием: дубликат сообщения не должен появиться.