---
title: "Довідник вбудованих дій у сценаріях"
description: "Довідник часто використовуваних дій для змінних, маршрутизації, операторів, Custom Data, таймерів, Fastline та аналітики."
---

# Довідник вбудованих дій у сценаріях

> **Тип сторінки:** довідник.

**Вбудовані дії** надає ConnectiveOne та його модулі, зокрема Operator Panel, Custom Data, Registered Users і Fastline. Їх не потрібно створювати в Action Jail: додайте ноду **Action** та оберіть функцію в Node Inspector.

> **Повний довідник усіх дій:** [Довідник дій](../../actionjail/reference/actions-reference.md). Нижче наведено **найчастіші** групи з типовими параметрами та результатами.

---

## Зміст

1. [Збереження констант (`set`)](#_1-збереження-констант-set)
2. [Маршрутизація (`goto_alias`, `switch`, `clear_constant`)](#_2-маршрутизація-goto-alias-switch-clear-constant)
3. [Підключення до оператора](#_3-підключення-до-оператора-operator-panel-connect-to-operator-with-msg)
4. [Реєстрація та ідентифікація (`registered_users__*`)](#_4-реєстрація-та-ідентифікація-registered-users)
5. [Custom Data (`custom_modules__*`)](#_5-custom-data-custom-modules)
6. [Графік роботи (`check_schedule`)](#_6-графік-роботи-check-schedule)
7. [Умовна логіка (`if_else`)](#_7-умовна-логіка-if-else)
8. [Таймінги та інтервали (`sleep`, `interval__*`)](#_8-таимінги-та-інтервали-sleep-interval)
9. [Медіа (`send_photo`, `send_video`, `send_file`)](#_9-медіа-send-photo-send-video-send-file)
10. [Вхід користувача (`get_user_input`)](#_10-вхід-користувача-get-user-input)
11. [Fastline / AI (`fastline_completion`, `fastline_pro`)](#_11-fastline-ai-fastline-completion-fastline-pro)
12. [Аналітика (`statistic__set`)](#_12-аналітика-statistic-set)

---

## 1. Збереження констант (`set`)

**Навіщо:** записати значення у змінні стану (константи) — вибір мови, поля реєстрації, результати API.

**Нода-шаблон у редакторі:** часто використовується нода з шаблоном **Set** (`action_set`) — див. [Нода Set (константи)](../explanation/set-node.md) та [Параметри Set](./set-parameters.md).

**Технічна дія `set`:** пари ключ → значення в `json_obj`; підтримуються плейсхолдери `{{const}}` та lodash-об’єкти для складних перетворень.

**Вихід:** зазвичай одна гілка `default` → наступна нода за `next_element_id`.

---

## 2. Маршрутизація (`goto_alias`, `switch`, `clear_constant`)

**Навіщо:**

| Дія | Призначення |
|-----|-------------|
| `goto_alias` | Перехід до ноди за **alias** (назва секції/ноди) — меню, «Назад». |
| `switch` | Розгалуження за **умовами** (ключі = імена подій/гілок, значення = вираз). |
| `clear_constant` | Очистити константи за **префіксом** (`module_name` — префікси через кому). |

**Відмінність від [роутера (Router)](../explanation/router-node.md):** нода **Router** використовує шаблон `action_router` і правила в інтерфейсі. Дії `switch` і `goto_alias` додаються у ноді Action та зручні для JSON і імпортованих сценаріїв.

**Типові виходи `switch`:** перша умова, що стала істинною → відповідна подія; при помилці парсингу — `error`.

---

## 3. Підключення до оператора (`operator_panel__connect_to_operator_with_msg`)

**Навіщо:** створити чат-кімнату й передати діалог оператору з контекстом і темою черги.

**Клієнтські матеріали:** [Нода «Підключення до оператора»](../explanation/connect-to-operator-node.md), [параметри](./operator-panel-connect-parameters.md), [довідник дії](../../actionjail/reference/actions/operator_panel__connect_to_operator_with_msg.md), сценарії з [Operator Line](../../operatorline/explanation/connect-chat-to-operator.md).

**Ключові параметри (скорочено):** `subject_alias`, `customTextToOperator`, `history_count`, кнопки закриття/повернення, `chat_closed_alias`, `fastline_operator` тощо.

**Виходи:** `success`, `banned`, `error` — змикайте окремі гілки на полотні.

---

## 4. Реєстрація та ідентифікація (`registered_users__*`)

**Дії:** `registered_users__set` — зберегти/оновити профіль; `registered_users__get` — знайти клієнта за чатом або телефоном.

**Параметри (загально):** `check_by_phone`, `active`, `anonym`; дані реєстрації зазвичай з констант `registration:*`.

**Виходи `registered_users__get`:** `success` (знайдено) / `error` (не знайдено).

**Деталі:** [Довідник дій — Registered Users](../../actionjail/reference/actions-reference.md) (розділ Registered Users).

---

## 5. Custom Data (`custom_modules__*`)

**Дії:** `custom_modules__get` — знайти запис; `custom_modules__set` — створити; `custom_modules__update` — оновити за `id`.

**Інструкції для інтеграторів:** [Як отримати запис](../../customdata/how-to/use-custom-modules-get.md), [Як створити запис](../../customdata/how-to/use-custom-modules-set.md), [Патерни Custom Data](../../customdata/explanation/custom-data-patterns-and-examples.md).

**Ключові параметри:** `module_name` (alias моделі), `filters`, `fields`, `set_to`, `order`.

---

## 6. Графік роботи (`check_schedule`)

**Навіщо:** перевірити, чи поточний час у межах робочого інтервалу (перед підключенням до оператора або для повідомлення «зараз не працюємо»).

**Параметри:** `morning_time`, `evening_time`, `weekends`, `timezone`.

**Виходи:** `success` (в межах графіку) / `error` (поза графіком або вихідний).

---

## 7. Умовна логіка (`if_else`)

**Навіщо:** складні гілки if / elseif / else з умовами та опційним записом констант у гілках.

**Параметри:** об’єкти `if`, `elseif`, `else` з умовами та полем `event` для імені виходу.

**Вихід:** подія з першої спрацьованої гілки або `default`.

**Пов’язано:** [Дії у сценаріях](../../scenariodialog/explanation/actions-in-scenarios.md) (огляд умовних дій).

---

## 8. Таймінги та інтервали (`sleep`, `interval__*`)

| Дія | Призначення |
|-----|-------------|
| `sleep` | Затримка (секунди), імітація «набору». Параметр: `delay`. |
| `interval__start` | Періодичний таймер (`tick`, `end`, `type`). |
| `interval__end` | Зупинити таймер поточної секції. |
| `interval__end_all` | Зупинити всі таймери для чату. |

**Вихід `sleep`:** зазвичай `success`.

---

## 9. Медіа (`send_photo`, `send_video`, `send_file`)

**Навіщо:** надіслати зображення, відео або файл за URL (промо, чеки, інструкції).

**Детально:** [Відображення зображення користувачу](../../scenariodialog/explanation/display-image-to-user.md) — інтерфейс та дія `send_photo`.

**Параметри:** зазвичай `url` або посилання на константу з масивом посилань.

---

## 10. Вхід користувача (`get_user_input`)

**Навіщо:** нормалізувати текст повідомлення для групових ботів (згадування @bot), записати `user_input`, ім’я, файл тощо.

**Виходи:** `raw_input`, `bot_mentioned`, `no_input`.

**Пов’язано:** [Очікування вводу](../explanation/wait-for-input-node.md) — нода застосунку; `get_user_input` — низькорівнева дія для специфічних випадків.

---

## 11. Fastline / AI (`fastline_completion`, `fastline_pro`)

**Навіщо:** звернення до AI (Fastline) з контекстом сценарію; `fastline_pro` — розширений режим.

**Налаштування агентів і БЗ:** модуль FastlinePro у конструкторі — див. документацію модуля FastlinePro. У сценарії параметри залежать від конфігурації дії в Action Jail.

**Виходи:** текст відповіді або `error`.

---

## 12. Аналітика (`statistic__set`)

**Навіщо:** запис події в статистику (воронки, звіти, позиції).

**Параметри:** залежать від реалізації (назва події, позиція тощо) — уточнюйте в Node Inspector і [довіднику дій](../../actionjail/reference/actions-reference.md).

---

## Підсумкова таблиця

| Група | Типова сила використання | Де читати далі |
|--------|---------------------------|----------------|
| `set` | Дуже висока | [Нода Set](../explanation/set-node.md) |
| `goto_alias` / `switch` / `clear_constant` | Дуже висока | цей документ, §2 |
| Оператор | Дуже висока | [Підключення до оператора](../explanation/connect-to-operator-node.md) |
| `registered_users__*` | Висока | [Довідник дій](../../actionjail/reference/actions-reference.md) |
| `custom_modules__*` | Висока | [Патерни Custom Data](../../customdata/explanation/custom-data-patterns-and-examples.md) |
| `check_schedule` | Висока | цей документ, §6 |
| `if_else` | Висока | цей документ, §7 |
| `sleep` / `interval__*` | Висока | цей документ, §8 |
| Медіа | Середня | [Відображення зображення](../../scenariodialog/explanation/display-image-to-user.md) |
| `get_user_input` | Середня | цей документ, §10 |
| Fastline | Висока | [Хаб FastLinePro](../../fastlinepro/integrator-hub.md) |
| `statistic__set` | Середня | [Довідник дій](../../actionjail/reference/actions-reference.md) |