Дія tickets_create
System ID:
action_tickets_create
Опис
Створює новий тікет за темою (subject_alias): збирає кастомні поля з констант користувача, створює чат у Operator Panel (через підключення до оператора), призначає виконавця за потреби й зберігає тікет. Якщо для теми потрібне введення полів — повертає відповідну гілку для збору даних.
Під час створення викликає підключення до оператора; тому можливі гілки banned і limit (як у дії підключення до оператора).
Події (гілки сценарію)
| Подія | Коли виникає |
|---|---|
| success | Тікет успішно створено |
| banned | Користувач у активному бані (від підключення до оператора) |
| limit | Немає вільного оператора (від підключення до оператора) |
| error | Немає subject_alias, тему не знайдено, збій підключення або створення тікета |
| select_custom_field | Потрібен вибір значення кастомного поля зі списку |
| required_custom_field | Обовʼязкове кастомне поле ще не заповнене |
| optional_custom_field | Опційне кастомне поле можна заповнити або пропустити |
Параметри
| Параметр | Тип | Обовʼязковий | Типово | Опис |
|---|---|---|---|---|
subject_alias |
string | так | — | Alias теми тікета (плейсхолдери) |
additional_fields |
object | ні | {} |
Додаткові кастомні поля (ключ–значення; плейсхолдери в значеннях) |
keep_original_message |
boolean | ні | false |
true — зберегти оригінальний текст повідомлення користувача |
resolved |
boolean | ні | false |
true — створити тікет як вирішений і закрити чат |
assignee_id |
string / number | ні | null |
ID оператора для призначення (плейсхолдери) |
unassigned |
string | ні | false |
"true" — не призначати, навіть якщо є assignee_id |
auto_assignee |
boolean | ні | false |
true — автоматичне призначення (round-robin) |
reporter_id |
string / number | ні | null |
ID оператора-репортера (плейсхолдери) |
watchers |
array | ні | [] |
ID операторів-спостерігачів (плейсхолдери) |
status_name |
string | ні | null |
Користувацький статус чату (плейсхолдери) |
ticket_description |
string | ні | null |
Опис тікета (плейсхолдери). Має пріоритет над константою ticket_description |
Після створення ID тікета зберігається в стані модуля тікетів; підтвердження клієнту — з константи бота ticket_created (якщо задана).
Приклад конфігурації
{
"subject_alias": "support",
"auto_assignee": true,
"ticket_description": "{{user_request.text}}",
"watchers": []
}