Довідка
Markdown статтіПовідомити про помилку

Actions Reference — Довідник по діях

Повний довідник по всіх стандартних actions (діях) у ConnectiveOne. Actions — функції, які виконуються під час сценарію бота.

Що таке actions?

Actions — функції, які викликаються, коли бот досягає ноди типу Action. Параметри передаються з конфігурації ноди; результат (подія) визначає наступну гілку сценарію.

Загальна кількість стандартних actions: 98

Детальні сторінки (параметри, події, приклади) — у підкаталозі actions/. У таблицях нижче — короткий огляд; назва дії веде на детальну статтю.

Також: Стандартні константи бота (Operator Panel).

Типи actions

  • Стандартні actions — вбудовані в платформу, доступні всім ботам
  • Кастомні actions — через модуль Action Jail під задачі проєкту

Детальніше: Action Jail, створення actions, тестування.

Використання в сценаріях


Стандартні actions по групах

Action Jail (1)

Назва System ID Опис Конфігурація Повертає
log action_log Записує повідомлення в консоль сервера для налагодження сценарію. {}

Api (1)

Назва System ID Опис Конфігурація Повертає
api__callnode action_api__callnode Викликає ноду (конектор) в іншому боті через внутрішній API. { "bot_id": "12345", "connector_alias": "welcome_message", "chat_id": … ok, not_ok

Autobroadcast (2)

Назва System ID Опис Конфігурація Повертає
autobroadcast__create action_autobroadcast__create Створює заплановану авторозсилку для поточного користувача. { "template_id": 123, "alias": "follow_up", "one_time": true, "send_af… success
autobroadcast__remove action_autobroadcast__remove Видаляє заплановані авторозсилки поточного користувача. { "template_id": 123, "alias": "weekly_newsletter" } success

Broadcast (3)

Назва System ID Опис Конфігурація Повертає
broadcast__subscribe action_broadcast__subscribe Підписує поточного користувача на тему розсилки (broadcast). { "topic_id": "newsletter", "template_id": 123, "time": "09:00" } success, error
broadcast__unsubscribe action_broadcast__unsubscribe Відписує поточного користувача від теми розсилки або від усіх тем. { "topic_id": "newsletter" } success, error
broadcast__subscribed action_broadcast__subscribed Перевіряє, чи підписаний поточний користувач на тему розсилки. { "topic_id": "newsletter" } success, error

Core Actions (63)

Назва System ID Опис Конфігурація Повертає
check_language action_check_language Перевіряє, чи вибрано мову діалогу для поточного користувача. {} defined, not_defined
set_language action_set_language Встановлює вибрану мову користувача за кодом з константи lang_code. {} success, error
get_language action_get_language Повертає код вибраної мови користувача або гілку error. {} error
get_channel action_get_channel Повертає назву каналу, через який спілкується користувач. {}
validate action_validate Перевіряє введення користувача або константи за типом чи regex-шаблоном. [ { "type": "email" }, { "constant": "user_phone", "type": "phone" }, … success, error
test_list action_test_list Генерує тестовий список із 7 елементів для перевірки списків у сценарії. {}
generate_list action_generate_list Формує список для UI зі масиву в константах і зберігає його в іншу константу. { "list": "products.list", "output": "formatted_products", "mapping": …
get_command action_get_command Обробляє команду месенджера (/command) або deeplink і повертає її імʼя. {} no_command
get_user_input action_get_user_input Зчитує текст, файли та згадки бота з поточного повідомлення користувача. {} bot_mentioned, raw_input, no_input
send_request action_send_request Надсилає HTTP-запит до зовнішньої системи з опційною автентифікацією. { "url": "https://api.example.com/endpoint", "method": "POST", "data":… ok, not_ok
create_hash action_create_hash Створює криптографічний хеш зі значення константи та секретного ключа. { "key_in_const": "user_id", "secret_key": "my_secret_key_123", "algor… success, error
send_me action_send_me Надсилає HTTP-запит із автоматичним додаванням chat_id і channel. { "url": "https://example.com/webhook", "method": "POST", "data": { "e… ok, not_ok
call_node action_call_node Асинхронно викликає ноду (конектор) у поточному боті без очікування відповіді. { "alias": "send_notification", "data": { "order_id": "{{order_id}}", …
if_else action_if_else Умовне розгалуження сценарію за виразами з підтримкою AND/OR і встановленням констант. { "if": { "{{total}}>3": "gt3", "set": { "doubled": "(({{total}}*2))" … (імʼя з конфігу), default
switch action_switch Багатогілкове розгалуження: перша істинна умова повертає імʼя своєї події. { "low": "{{score}} < 50", "medium": "({{score}} >= 50)*({{score}} < 8… (ключ з конфігу), error
set action_set Встановлює або змінює константи діалогу: значення, вирази, методи над обʼєктами. { "price": "100", "quantity": "2", "total": "{{price}}*{{quantity}}", … default
set_current_date action_set_current_date Зберігає поточну дату й час у константу діалогу. { "set_to": "registration_date" } default
menu_slider action_menu_slider Формує структуру слайдера / пагінації для багатосторінкового меню. { "cycle": true }
send_photo action_send_photo Надсилає користувачу фото за URL або з масиву в константі. { "product": "https://example.com/images/product.jpg", "detail": "{{ph…
send_video action_send_video Надсилає користувачу відео за URL з індикатором набору тексту. { "tutorial": "https://example.com/videos/tutorial.mp4", "demo": "{{vi…
send_file action_send_file Надсилає користувачу файли за URL через поточний канал. { "invoice": "https://example.com/invoices/invoice_123.pdf", "receipt"…
send_email action_send_email Надсилає HTML-лист через SMTP з вкладеннями та збором констант. { "subject": "Нова реєстрація", "to": "[email protected]", "html": "Да… success
loop_start action_loop_start Починає цикл по масиву: поточний елемент доступний у константі loop_data. { "constant": "photos" } success, error
loop_end action_loop_end Перевіряє, чи цикл завершено, чи потрібна наступна ітерація. {} success, error
check_schedule action_check_schedule Перевіряє, чи поточний час у межах робочих годин (з урахуванням вихідних і часового поясу). { "morning_time": 9, "evening_time": 18, "weekends": [0, 6], "timezone… success, error
send_sticker action_send_sticker Надсилає стікер у поточному каналі за ідентифікатором каналу. { "telegram_sticker": "CAACAgIAAxkBAAIBY2...", "viber_sticker": "12345…
clear_constant action_clear_constant Очищає константи та повʼязаний контекст за префіксами ключів. { "module_name": "payment,order,cart" } success
goto_alias action_goto_alias Переходить до ноди сценарію за її alias. { "alias": "{{selected_section}}" }
add_to_cart action_add_to_cart Додає товар у кошик у константах діалогу й оновлює підсумки. { "item_model": "product.model", "item_id": "product.id", "price": "pr… success, error
remove_from_cart action_remove_from_cart Видаляє товар з кошика за моделлю та ID і перераховує підсумки. { "item_model": "product.model", "item_id": "product.id", "save_to": "… success, error
sleep action_sleep Пауза сценарію на задану кількість секунд з індикатором набору тексту. { "delay": 3 } success
scan_barcode action_scan_barcode Розпізнає штрихкод на зображенні за URL і зберігає значення в константу. { "source_url": "{{product_image_url}}", "type": "ean13", "set_to": "s… recognized, not_recognized
scan_qr action_scan_qr Розпізнає QR-код на зображенні за URL і зберігає дані в константу. { "source_url": "{{uploaded_image_url}}", "set_to": "scanned_qrcode" } recognized, not_recognized, error
generate_barcode action_generate_barcode Генерує зображення штрихкоду або QR-коду з тексту та зберігає URL у константу. { "code": "{{order_id}}", "type": "code128", "height": 10, "scale": 3,… generated, generation_error
custom_modules_list action_custom_modules_list Повертає список унікальних значень поля кастомного модуля для списків і випадаючих меню. { "total": 0, "value": null, "list": [] }
existing_chatroom action_existing_chatroom Перевіряє, чи є в користувача активна чат-кімната Operator Panel. {} exists
close_chatroom action_close_chatroom Закриває чат-кімнату Operator Panel зі сценарію. { "chat_room_id": "123" } success, no_chatroom_id
create_message action_create_message Створює текстове або файлове повідомлення в чат-кімнаті Operator Panel. { "id": "{{chat_room_id}}", "message": "Доброго дня, потрібна допомога… success, error
get_client_by_chat_room_id action_get_client_by_chat_room_id Завантажує дані клієнта чат-кімнати в константи сценарію. { "chat_room_id": "{{chat_room_id}}" } success, error
get_chat_room_messages action_get_chat_room_messages Отримує повідомлення чат-кімнати з пагінацією та зберігає їх у константи. { "filters": { "chat_room_id": "{{chat_room_id}}" }, "pagination": { "… success, error
fastline_completion action_fastline_completion Генерує текст через ШІ без пошуку в базі знань Fast Line. { "prompt": "Напиши коротке вітальне повідомлення для {{user_name}}", … error
fastline action_fastline Шукає відповідь у базі знань Fast Line і генерує відповідь ШІ. { "user_input": "{{user_question}}", "prompt": "Дай відповідь на основ… success, not_found, error
fastline_search action_fastline_search Шукає в базі знань Fast Line без генерації відповіді ШІ. { "user_input": "{{user_question}}", "category": "support", "max_dista… success, error
fastline_summarize action_fastline_summarize Генерує ШІ-резюме історії діалогу чат-кімнати (Fast Line). { "prompt": "Коротко підсумуй розмову для наступного оператора: основн… success, no_prompt, chat_room_not_found, chat_user_not_found, no_dialog_logs, no_meaningful_content, error
fastline_transcribe action_fastline_transcribe Транскрибує голосове повідомлення в текст (Fast Line). { "set_to": "transcribed_voice" } success, no_audio, error
fl_transfer_to_skill_group action_fl_transfer_to_skill_group Передає чат з Fast Line на skill group операторів. { "skill_group_alias": "support_team" } success, queue, error, no_fastline_operator, no_skill_group, operator_already_connected
fl_transfer_to_operator action_fl_transfer_to_operator Передає чат з Fast Line конкретному оператору. { "operator_id": "{{operator_id}}" } success, error, no_fastline_operator, no_operator, limit
fastline_pro action_fastline_pro Надсилає запит агенту Fast Line Pro і зберігає відповідь у константу. { "agent_name": "customer_support", "user_input": "{{user_question}}",… error
meta_type action_meta_type Визначає тип взаємодії Meta (Facebook/Instagram): коментар, Stories або direct. {} post_comment, story_comment, direct, not_meta
card_pay_block_scenario action_card_pay_block_scenario Позначає оплату як активну й блокує сценарій до підтвердження платежу. {} success
card_pay action_card_pay Формує URL сторінки карткової оплати й зберігає його в константу payment_url. {} success, error
apple_google_pay action_apple_google_pay Надсилає запит Apple Pay / Google Pay у Viber через LiqPay. { "description": "Замовлення #12345", "product_name": "Premium Subscri… success, error
verify_online_payment action_verify_online_payment Перевіряє результат онлайн-оплати за кодом у стані запиту. {} success, error
tickets_create action_tickets_create Створює тікет: збирає кастомні поля, підключає до оператора та записує тікет. { "subject_alias": "support", "auto_assignee": true, "ticket_descripti… success, banned, limit, error, select_custom_field, required_custom_field, optional_custom_field
tickets_create_v2 action_tickets_create_v2 Створює тікет (покращена версія): кастомні поля, черга, підключення до оператора. { "subject_alias": "support", "auto_assignee": true, "type": "ticket" … success, banned, limit, error, select_custom_field, required_custom_field, optional_custom_field
chatroom_update action_chatroom_update Оновлює користувацький статус чат-кімнати оператора й скидає внутрішній статус на new. { "chat_room_id": "{{chat_room_id}}", "status_name": "awaiting_review"… success, error
tickets_update action_tickets_update Оновлює існуючий тікет: призначення, пріоритет, статус, поля, спостерігачі, resolved. { "assignee_id": "{{operator_id}}", "status_name": "In Progress", "sta… success, error
get_ticket_info action_get_ticket_info Завантажує дані тікета за ID і зберігає їх у константу ticket. { "ticket_id": "{{selected_ticket_id}}" } success, error
my_chatrooms_list action_my_chatrooms_list Повертає список активних чат-кімнат поточного клієнта в константу chat_rooms_list. {} no_chat_rooms
return_to_chatroom action_return_to_chatroom Повертає користувача в раніше активну (незакриту) чат-кімнату оператора. { "alias_return_scenario": "main_menu" } error
tickets_clear_input action_tickets_clear_input Очищає константи кастомних полів теми після створення або скасування тікета. { "subject_alias": "support" } success, error
tickets_create_wrapped action_tickets_create_wrapped Створює тікет від імені користувача за номером телефону (обгортка над tickets_create). { "subject_alias": "support" } success, banned, limit, error, select_custom_field, required_custom_field, optional_custom_field
tickets_list action_tickets_list Повертає відфільтрований і розбитий на сторінки список тікетів у константи. { "filters": { "resolved": false, "assignee_id": "{{operator_id}}" }, … success, error

Custom Modules (4)

Назва System ID Опис Конфігурація Повертає
custom_modules__set action_custom_modules__set Створює запис кастомного модуля й зберігає його в константу. { "module_name": "customer", "fields": { "first_name": "John", "last_n… success, error
custom_modules__update action_custom_modules__update Оновлює існуючий запис кастомного модуля за ID. { "module_name": "order", "fields": { "id": "{{order_id}}", "status": … success, error
custom_modules__get action_custom_modules__get Знаходить запис кастомного модуля за фільтрами й зберігає в константу. { "module_name": "order", "filters": { "status": "pending", "user_id":… success, error
custom_modules__export action_custom_modules__export Експортує записи кастомного модуля у файл (CSV/JSON) і зберігає URL. { "module_name": "products", "format": "csv", "filename": "products_ex… success, error

Esputnik (1)

Назва System ID Опис Конфігурація Повертає
esputnik__push_contact action_esputnik__push_contact Надсилає контакт поточного чату в eSputnik (синхронізація для email-маркетингу). {} success

Files (1)

Назва System ID Опис Конфігурація Повертає
files__get action_files__get Отримує файли поточного користувача з файлового менеджера в константу files. { "name": "invoice.pdf" } success, error

Interval (4)

Назва System ID Опис Конфігурація Повертає
interval__end action_interval__end Зупиняє таймер неактивності для поточної секції сценарію. {}
interval__end_all action_interval__end_all Зупиняє всі таймери неактивності поточного користувача в усіх секціях. {} success, error
interval__start action_interval__start Запускає таймер неактивності з маршрутизацією за хвилинами очікування. { "type": "inactive", "tick": 30, "end": 15 } error
interval__last action_interval__last Повертає користувача на позицію сценарію до спрацювання таймера неактивності. {}

Language (2)

Назва System ID Опис Конфігурація Повертає
language__set action_language__set Встановлює вибрану мову користувача за кодом з константи lang_code. {} success, error
language__get action_language__get Повертає код вибраної мови користувача або гілку error. {} error

Loop (2)

Назва System ID Опис Конфігурація Повертає
loop__start action_loop__start Починає цикл по масиву: поточний елемент доступний у константі loop_data. { "constant": "photos" } success, error
loop__end action_loop__end Перевіряє, чи цикл завершено, чи потрібна наступна ітерація. {} success, error

Operator Panel (4)

Назва System ID Опис Конфігурація Повертає
operator_panel__connect_to_operator_with_msg action_operator_panel__connect_to_operator_with_msg Довідник параметрів, констант і подій дії Підключення до оператора (action_operator_panel__connect_to_operator_with_msg) { "waiting_message": { "en": "Please wait, connecting you to an operat… success, connected, queue, banned, limit, error
operator_panel__clear_data action_operator_panel__clear_data Очищає всі константи користувача в поточному стані діалогу. {}
operator_panel__nps_confirm_answer action_operator_panel__nps_confirm_answer Зберігає відповіді NPS-опитування з констант користувача. {} success, error
operator_panel__get_last_dialog action_operator_panel__get_last_dialog Отримує повідомлення та учасників останньої чат-кімнати Operator Panel. { "format": "json", "set_to": "dialog_history" } success, error

Registered Users (3)

Назва System ID Опис Конфігурація Повертає
registered_users__check_phone action_registered_users__check_phone Перевіряє й нормалізує номер телефону для реєстрації користувача. {} success, error
registered_users__set action_registered_users__set Створює або оновлює зареєстрованого користувача за даними з констант. { "check_by_phone": true, "active": 1, "anonym": 0 } success
registered_users__get action_registered_users__get Знаходить зареєстрованого користувача і завантажує дані в константи. { "check_by_phone": true } success, error

Schedule (1)

Назва System ID Опис Конфігурація Повертає
schedule__check action_schedule__check Перевіряє, чи поточний час у межах робочих годин (з урахуванням вихідних і часового поясу). { "morning_time": 9, "evening_time": 18, "weekends": [0, 6], "timezone… success, error

Statistic (1)

Назва System ID Опис Конфігурація Повертає
statistic__set action_statistic__set Зберігає оцінку NPS або quality після закритого діалогу з оператором. { "type": "nps" } success, error

Subscription (3)

Назва System ID Опис Конфігурація Повертає
subscription__set action_subscription__set Підписує поточного користувача на тему розсилки (broadcast). { "topic_id": "newsletter", "template_id": 123, "time": "09:00" } success, error
subscription__remove action_subscription__remove Відписує користувача від однієї або всіх тем розсилки. { "topic_id": "news" } success, error
subscription__check action_subscription__check Перевіряє, чи підписаний користувач на тему розсилки. { "topic_id": "news" } success, error

Testing (1)

Назва System ID Опис Конфігурація Повертає
testing__search action_testing__search Перевіряє, чи поточний chat_id є в заданому списку (для тестів). { "chat_id": [123456789, 987654321] } success, error

Widget (1)

Назва System ID Опис Конфігурація Повертає
widget__callout action_widget__callout Надсилає callout-повідомлення у віджет (текст і додаткові параметри). { "text": "Оплату отримано!", "type": "info", "duration": 5000 } ok, not_ok

Примітки

  • Конфігурація — скорочений приклад JSON; повний список полів — на сторінці дії
  • Повертає — короткі імена подій (гілок); деталі — на сторінці дії
  • Деякі дії не повертають іменовану гілку (silent) або повертають динамічне значення (код мови, канал, текст AI)

Повʼязані матеріали

Працюєте з власним ШІ-агентом?Встановіть відкритий skill, щоб ваш ШІ-агент працював з актуальною офіційною документацією ConnectiveOne.Отримати skillПотрібна підтримка?Не знайшли відповідь або потрібна допомога команди ConnectiveOne? Створіть запит у Client Portal.Створити запит