helpdesk.message.add
Scope:
helpdeskКто может вызывать: Доступ к обращению.
Добавить сообщение в обращение
HTTP: POST
Побочные эффекты: добавляет сообщение в обращение; Forum-комментарий; уведомление агентам (NOTIFY_AGENT_DONE / обработчики модуля через SetTicket)
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
ticketId / TICKET_ID |
int |
да | ID обращения |
message / MESSAGE |
string |
да* | Текст (*или непустой files) |
files / FILES |
array |
нет | ID файлов b_file (владелец = текущий пользователь или уже в обращении) |
isHidden / HIDDEN / IS_HIDDEN |
bool |
нет | Скрытое сообщение (только admin/support/responsible) |
Возвращаемые данные
Ответ: созданное сообщение (как message.get).
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INVALID_ID |
Некорректный ticketId или fileId |
TICKET_NOT_FOUND |
Обращение не найдено |
ACCESS_DENIED |
Нет доступа |
FORBIDDEN |
Файл не принадлежит пользователю |
VALIDATION_ERROR |
Пустое тело и нет файлов |
INTERNAL |
Внутренняя ошибка |
Пример запроса (POST)
curl -X POST "https://76575.dev.wehive.digital/rest/1/lus1tijk9ll7mg7h/helpdesk.message.add.json" \
-H "Content-Type: application/json" \
--data '{"ticketId":2,"message":"Ответ поддержки"}'
Пример ответа
{
"result": {
"result": {
"id": 8,
"ticketId": 2,
"message": "Ответ поддержки",
"bySupportTeam": true,
"files": []
},
"error": null
}
}
См. также
Предыдущая
Следующая