helpdesk.ticket.add
Scope:
helpdeskКто может вызывать: Авторизованный пользователь.
Создать обращение через CAllTicketHelpdesk::SetTicket
HTTP: POST
Побочные эффекты: создаёт обращение и при наличии message — первое сообщение; уведомления TICKET_NEW_FOR_TECHSUPPORT, TICKET_NEW_FOR_AUTHOR (через SetTicket с sendEmailToAuthor/sendEmailToTechsupport = Y, плюс IM/почтовые обработчики модуля)
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
title / TITLE |
string |
да | Заголовок обращения |
message / MESSAGE |
string |
нет | Текст первого сообщения |
categoryId / CATEGORY_ID |
int |
нет | Категория |
criticalityId, priority, CRITICALITY_ID |
int |
нет | Критичность (priority ≡ criticalityId) |
statusId / STATUS_ID |
int |
нет | Статус; по умолчанию — из настройки CREATE_TICKET_FOR_STATUS |
markId / MARK_ID |
int |
нет | Оценка |
responsibleId / RESPONSIBLE_USER_ID |
int |
нет | Ответственный |
ownerId / OWNER_USER_ID |
int |
нет | Автор |
slaId / SLA_ID |
int |
нет | SLA |
siteId / SITE_ID |
string |
нет | Сайт; по умолчанию s1 |
sourceId / SOURCE_ID |
int |
нет | Источник |
files / FILES |
array |
нет | Вложения |
supportComments / SUPPORT_COMMENTS |
string |
нет | Комментарии поддержки |
Возвращаемые данные
Ответ в конверте модуля: result.result — созданное обращение (как ticket.get).
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Пустой title или ошибка сохранения |
INTERNAL |
Модуль недоступен |
Пример запроса (POST)
curl -X POST "https://76575.dev.wehive.digital/rest/1/lus1tijk9ll7mg7h/helpdesk.ticket.add.json" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{"title":"Новое обращение","message":"Текст обращения","categoryId":28}'
Пример ответа
{
"result": {
"result": {
"id": 3,
"title": "Новое обращение",
"statusId": 43,
"criticalityId": 0,
"priority": 0,
"isClosed": false
},
"error": null
}
}
См. также
Предыдущая
Следующая