Довідник параметрів внутрішніх подій
Цей довідник містить опис усіх типів внутрішніх подій та параметрів eventConfig для тригера Внутрішні події стартової ноди.
Тикети
Тикет створено (ticket_created)
Опис: Секція запускається при створенні нового тикета в системі.
Параметри eventConfig:
| Параметр | Тип | Опис |
|---|---|---|
| channelFilter | string | Фільтр по каналу: '' (усі), telegram, facebook, whatsapp |
| clientType | string | Тип клієнта: '' (усі), new, existing |
Дані події в контексті: chat_room_id, channel, bot_id, дані тикета.
Тикет оновлено (ticket_updated)
Опис: Секція запускається при зміні параметрів тикета (статус, пріоритет, теги тощо).
Параметри eventConfig: аналогічно ticket_created (channelFilter, clientType), якщо підтримуються в UI.
Зміна назви статусу тикета (ticket_status_name_changed)
Опис: Секція запускається при зміні назви статусу тикета.
Параметри eventConfig: загальні фільтри (channelFilter, clientType).
Тикет переназначено (ticket_reassign)
Опис: Секція запускається при переназначенні тикета іншому оператору.
Параметри eventConfig:
| Параметр | Тип | Опис |
|---|---|---|
| channelFilter | string | Фільтр по каналу |
| clientType | string | Тип клієнта |
| operatorRole | string | Роль оператора: '', operator, supervisor, admin |
| team | string | Команда: '', support, sales, tech |
Тикет відкрито повторно (ticket_reopened)
Опис: Секція запускається, коли закритий тикет відкривають знову.
Параметри eventConfig: загальні фільтри.
Повідомлення в тикеті (ticket_message)
Опис: Секція запускається, коли оператор або клієнт (Client Portal, віджет, email, месенджери) додає нове повідомлення в тикет.
Параметри eventConfig: у MVP додаткових фільтрів немає (порожній eventConfig допустимий).
Дані події в контексті: ticket, ticket_id, chat_room, chat_room_id, bot_id, channel, message_id, message_text, message_type, message_from (operator | client), user_id, client_id, participant_id.
SLA та ескалації
TFR ескальовано (TFR_escalated)
Опис: Секція запускається при ескалації TFR (Time to First Response).
Параметри eventConfig: загальні фільтри, можливо deadlineMinutes, slaType (якщо підтримуються).
TTC ескальовано (TTC_escalated)
Опис: Секція запускається при ескалації TTC (Time to Close).
Параметри eventConfig: аналогічно TFR.
Час у статусі перевищено (time_in_status_exceeded)
Опис: Секція запускається, коли тикет перебуває в обраному статусі довше за вказаний час.
Параметри eventConfig:
| Параметр | Тип | Опис |
|---|---|---|
| statusId | number | ID статусу зі списку статусів інстансу |
| statusName | string | Назва статусу (наприклад, «Відкрито») |
| timeInSeconds | number | Час у секундах (наприклад, 7200 = 2 години) |
| timeConfig | object | Деталізація: hours, minutes, seconds |
| triggerChannels | string[] | Масив каналів: ['telegram', 'viber'] або порожній — усі |
Приклад:
{
"statusName": "Відкрито",
"timeInSeconds": 7200,
"triggerChannels": ["telegram", "viber"]
}
Закриття
Чат закрито (chat_closed)
Опис: Секція запускається при закритті чату.
Параметри eventConfig: загальні фільтри.
Тикет закрито (ticket_closed)
Опис: Секція запускається при закритті тикета.
Параметри eventConfig: загальні фільтри.
Повідомлення
Помилка доставки повідомлення (message_delivery_error)
Опис: Секція запускається при помилці доставки повідомлення через e-chat (Telegram, Viber, WhatsApp).
Параметри eventConfig:
| Параметр | Тип | Опис |
|---|---|---|
| channelFilter | string | Фільтр по каналу: '', telegram, viber, whatsapp |
| errorCodes | string[] | Масив кодів помилок e-chat. Порожнє — усі помилки |
Коди помилок e-chat:
| Канал | Код | Опис |
|---|---|---|
| Viber | 2 | Номер не використовується |
| Viber | 3 | Тимчасова помилка |
| Viber | 4 | Заблоковано |
| Viber | 5 | В очікуванні |
| Viber | 6 | Не можна чатитися |
| Viber | 7 | Новий номер |
| Telegram | 4 | Заблоковано |
| — | Різні рядки помилок |
Дані події в контексті: chat_room_id, message_id, channel, error_code, error_description, bot_id.
Приклад:
{
"channelFilter": "viber",
"errorCodes": ["2", "4"]
}
Загальні параметри (channelFilter, clientType, operatorRole, team, slaType)
Ці параметри можуть бути доступні для різних подій у UI:
| Параметр | Можливі значення |
|---|---|
| channelFilter | '', telegram, facebook, whatsapp |
| clientType | '', new, existing |
| operatorRole | '', operator, supervisor, admin |
| team | '', support, sales, tech |
| slaType | '', first-response, resolution, escalation |