Дія 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": []
}