Запросы (ticket/clientticket)

Запросы от имени учётной записи администратора

Объект: ticket

Результат: список элементов

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`ticket`	Положительное целое число	Нет	Код запроса.
`name`	Строка	Нет	Тема запроса. Содержит краткое описание вопроса.
`client`	Строка	Нет	Клиент, создавший запрос.
`delay`	Строка	Нет	Время ожидания запроса в очереди.
`deadline`	Строка	Нет	Срок, когда истекает регламент ответа на запрос.
`responsible`	Строка	Нет	Отдел или сотрудник, на которого назначен запрос.
`project`	Строка	Нет	Провайдер, к которому относится запрос.
`queue`	Положительное целое число	Нет	Внутренний вес (приоритет) запроса.
`props`	Строка (перечисление)	Нет	Дополнительная информация по запросу. Возможные значения: `from_gate` — сообщение пришло по электронной почте; `note` — комментарий к клиенту; `accgroup` — клиент состоит в группах; `unread` — есть не прочитанные сообщения; `abuse` — запрос связан с нарушением; `abuse_id` — id клиента, запрос которого связан с нарушением; `priority` — текущий приоритет запроса; `favorite` — запрос в списке избранных; `highpriority` — приоритет поднят вручную; `attitude` — характеристика клиента; `premium` — клиент имеет платную поддержку; `from_abuse_process` — запрос помещён в активные из-за отсутствия реакции клиента.

Открыть запрос

Функция: ticket.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Открыть.

Открывает форму просмотра и ответа на запрос. Функция используется для просмотра параметров, создания и изменения объекта.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Положительное целое число	Нет	Уникальный идентификатор запроса.
`plid`	Положительное целое число	Нет	Уникальный идентификатор родительского списка.
`name`	Строка	Нет	Тема запроса.
`message`	Строка	Нет	Текст сообщения. Поддерживает Markdown-разметку.
`ticket_item`	Строка	Нет	Услуга, к которой относится запрос.
`ticket_project_select`	Строка	Нет	Провайдер, к которому относится тема запроса.
`client_department`	Строка	Нет	Отдел провайдера, в который будет передан запрос.
`priority`	Строка (перечисление)	Нет	Приоритет запроса. Возможные значения: `0` — низкий; `1` — средний; `2` — высокий.
`client_priority`	Строка (перечисление)	Нет	Приоритет запроса (клиентский). Возможные значения: `0` — низкий; `1` — средний; `2` — высокий.
`show_optional`	Флаг	Нет	Показать дополнительные поля.
`note_message`	Строка	Нет	Внутренний комментарий. Виден только сотрудникам.
`ticket_expense`	Строка	Нет	Сумма средств, которая будет списана со счёта клиента.
`high_priority`	Флаг	Нет	Значение `on` поднимает приоритет запроса.
`low_priority`	Флаг	Нет	Значение `on` сбрасывает признак повышенного приоритета.
`incident_count`	Положительное целое число	Нет	Количество обращений в поддержку.
`show_abuse`	Флаг	Нет	Зарегистрировать нарушение. Значение `on` отображает параметры регистрации нарушения.
`score`	Положительное целое число	Нет	Количество баллов за нарушение.
`score_note`	Строка	Нет	Комментарий к нарушению.
`action`	Строка	Нет	Функция, применяемая к нарушению.
`deadline_date`	Дата и время	Нет	Дата дедлайна. Формат: `YYYY-MM-DD`
`deadline_time`	Дата и время	Нет	Время дедлайна. Формат: `HH:MM:SS`
`sok`	Строка	Нет	Значение `ok` подтверждает выполнение операции. Без этого параметра изменения не будут применены.

Закрыть запрос

Функция: ticket.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Закрыть.

Закрывает запрос. Удаляет его из очереди. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов запросов через запятую. Например, `123,456`.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Разблокировать запрос

Функция: ticket.unblock

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Разблок.

Разблокирует запрос. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов запросов через запятую. Например, `123,456`.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Добавить в избранное

Функция: ticket.favorite

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка В избранное.

Добавляет запрос в избранные. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов запросов через запятую. Например, `123,456`.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Показать список сообщений

Функция: ticket.message

Результат: список элементов

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Сообщения.

Возвращает список сообщений запроса. Поддерживает фильтрацию и пагинацию.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Положительное целое число	Да	Уникальный идентификатор из функции `ticket`.
`id`	Положительное целое число	Нет	Идентификатор сообщения.
`message`	Строка	Нет	Текст сообщения.
`date_post`	Дата и время	Нет	Дата написания. Формат: `YYYY-MM-DD HH:MM:SS`
`message_user`	Строка	Нет	Автор сообщения.

Редактировать сообщение

Функция: ticket.message.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Сообщения → кнопка Открыть.

Используется для редактирования текста сообщения. Поддерживает Markdown-разметку. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`plid`	Положительное целое число	Да	Идентификатор родительского запроса. Элемент `id` из функции `ticket.`
`elid`	Положительное целое число	Нет	Элемент `id` из функции `ticket.message`. Не указывается при создании нового сообщения.
`message`	Строка	Да	Текст сообщения. Поддерживает Markdown-разметку.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Разделить запрос на два, начиная с выбранного сообщения

Функция: ticket.split

Результат: успешное выполнение операции или сообщение об ошибке

Разделяет запрос на два. Начинает с выбранного сообщения. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов запросов через запятую. Например, `123,456`.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Скрыть сообщение

Функция: ticket.message.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Сообщения → кнопка Скрыть.

Скрывает сообщение от клиента. Не удаляет запись из базы данных. Требуется подтверждение через параметр sok.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов запросов через запятую. Например, `123,456`.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.

Установить фильтр по клиенту

Функция: ticket.setfilter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка По клиенту.

Задаёт условия отбора по клиенту. Параметры передаются в теле запроса. Условия фильтра сохраняются и применяются при каждом отображении списка до изменения или сброса.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Один или несколько идентификаторов клиента через запятую. Например, `123,456`.

Применить расширенный фильтр

Функция: ticket.filter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Фильтр.

Применяет расширенные условия фильтрации к списку запросов. Поддерживает фильтрацию по номеру, провайдеру, отделу, типу продукта и другим параметрам.

Уровень доступа: root, admin

Параметр	Тип	Обязательный	Значение
`reset`	Флаг	Нет	Сбросить фильтр.

Войти в панель с правами пользователя

Функция: ticket.su

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Поддержка → Запросы → кнопка Войти.

Выполняет вход в панель управления с правами выбранного клиента для просмотра его данных.

Уровень доступа: root, admin

Запросы под учётной записью клиента

Функция: clientticket

Результат: список элементов

Уровень доступа: user

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	Да	Уникальный идентификатор.
`name`	Строка	Нет	Тема запроса.
`last_message`	Строка	Нет	Последнее сообщение.
`wait_time`	Строка	Нет	Задержка. Время ожидания ответа.
`create_user`	Строка	Нет	Автор.
`tstatus`	Строка (перечисление)	Нет	Статус запроса. Возможные значения: `0` — новый; `1` — на рассмотрении; `2` — ожидает ответа; `3` — закрыт; `10` — в архиве.

Установить фильтр

Функция: clientticket.filter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: доступно под учётной записью клиента. Раздел Поддержка → Запросы → кнопка Фильтр.

Задаёт условия отбора для списка клиентских запросов.

Уровень доступа: user

Купить обращения в техническую поддержку

Функция: incident

Результат: успешное выполнение операции или сообщение об ошибке

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

Уровень доступа: user

Параметр	Тип	Обязательный	Значение
`elid`	Положительное целое число	Нет	Идентификатор клиента.
`count`	Положительное целое число	Нет	Количество обращений.
`sok`	Строка	Нет	Значение `ok` подтверждает выполнение операции.

Редактировать запрос

Функция: clientticket.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: доступно под учётной записью клиента. Раздел Поддержка → Запросы → кнопка Открыть.

Создаёт новый запрос или изменяет существующий. Клиент может добавить сообщение к активному запросу.

Уровень доступа: user

Параметр	Тип	Обязательный	Значение
`elid`	Положительное целое число	Да	Идентификатор запроса.
`name`	Строка	Нет	Тема запроса.
`ticket_item`	Строка	Нет	Услуга, к которой относится запрос.
`ticket_project_select`	Строка	Нет	Провайдер, к которому относится тема запроса.
`client_department`	Строка	Нет	Отдел провайдера, в который будет передан запрос.
`item`	Строка	Нет	Услуга, к которой относится запрос.
`client_priority`	Строка (перечисление)	Нет	Приоритет запроса. Возможные значения: `0` — низкий; `1` — средний; `2` — высокий.
`priority`	Строка (перечисление)	Нет	Приоритет запроса. Возможные значения: `0` — низкий; `1` — средний; `2` — высокий.
`message`	Строка	Нет	Текст добавляемого сообщения. Поддерживает Markdown-разметку.
`show_optional`	Флаг	Нет	Показать дополнительные настройки запроса.
`note_message`	Строка	Нет	Внутренний комментарий.
`ticket_expense`	Строка	Нет	Сумма средств, которая будет списана со счёта клиента.
`high_priority`	Флаг	Нет	Поместить запрос в начало очереди.
`low_priority`	Флаг	Нет	Сбросить признак повышенного приоритета.
`incident_count`	Положительное целое число	Нет	Счётчик инцидентов.
`show_abuse`	Флаг	Нет	Показать параметры регистрации нарушения.
`score`	Положительное целое число	Нет	Количество баллов за нарушение.
`action`	Строка	Нет	Функция, которая будет применена.
`deadline_date`	Дата и время	Нет	Дата дедлайна по запросу.
`deadline_time`	Дата и время	Нет	Время дедлайна по запросу.
`score_note`	Строка	Нет	Комментарий к нарушению.
`sok`	Строка	Нет	Значение `ok` подтверждает выполнение операции.

Переместить в архив

Функция: clientticket.archive

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: доступно под учётной записью клиента. Раздел Поддержка → Запросы → кнопка В архив.

Перемещает запрос в архив. Доступно для закрытых запросов. Поддерживает архивирование нескольких запросов.

Уровень доступа: user

Параметр	Тип	Обязательный	Значение
`elid`	Строка (список)	Да	Уникальный идентификатор из функции clientticket.
`sok`	Строка	Да	Значение `ok` подтверждает выполнение операции.