Skip to main content
This page is also available in English.

​
Огляд

Коли AI-асистент виконує дії під час розмови в чаті, бекенд сигналізує фронтенду через frontend_actions — масив рядкових значень, що включається в кожну відповідь чату. 
{
  "role": "assistant",
  "content": "Готово! Я оновив бюджет.",
  "frontend_actions": ["update_campaign_draft"]
}
Масив може містити нуль або більше дій на повідомлення. Обробляйте кожну незалежно.

​
Усі дії

ДіяКонтекстКоли надсилаєтьсяЩо має зробити фронтенд
enable_submit_buttonЛише онбордингАсистент завершив онбординг і користувач може продовжитиУвімкнути кнопку “Submit” / “Continue”
disable_submit_buttonЛише онбордингАсистент потребує більше інформаціїВимкнути кнопку submit
update_campaign_draftВізард кампаніїАсистент змінив дані чернетки (ключові слова, групи оголошень, RSA, розширення тощо)Перезавантажити чернетку кампанії з API
set_campaign_draft_step_1Візард кампаніїАсистент хоче перейти до Кроку 1 (Налаштування кампанії)Переключити UI візарду на крок 1
set_campaign_draft_step_2Візард кампаніїАсистент хоче перейти до Кроку 2 (Групи оголошень)Переключити UI візарду на крок 2
set_campaign_draft_step_3Візард кампаніїАсистент хоче перейти до Кроку 3 (Оголошення / RSA)Переключити UI візарду на крок 3
set_campaign_draft_step_4Візард кампаніїАсистент хоче перейти до Кроку 4 (Розширення)Переключити UI візарду на крок 4
enable_submit_button та disable_submit_button використовуються виключно в процесі онбордингу. Вони не пов’язані зі створенням кампаній. Не плутайте їх з діями візарду кампанії.

​
Деталі обробки

​
update_campaign_draft

Найпоширеніша дія. Спрацьовує, коли асистент створює, оновлює або видаляє будь-яку частину чернетки — групи оголошень, ключові слова, RSA, розширення, стратегію ставок тощо. Очікувана поведінка: перезавантажити чернетку через GET /api/v1/campaigns/drafts/{id} та оновити UI візарду.

​
enable_submit_button / disable_submit_button

Ці дії є специфічними для онбордингу. Асистент перемикає кнопку submit під час онбордингу. Вони не надсилаються під час створення кампанії.

​
set_campaign_draft_step_N (нове)

Чисті сигнали навігації. Асистент надсилає їх, коли хоче направити увагу користувача на конкретну вкладку візарду — наприклад, після редагування ключових слів він може перейти до Кроку 2. Очікувана поведінка: переключити активну вкладку на крок N (1–4). Перезавантаження даних не потрібне — ці дії часто надсилаються разом з update_campaign_draft, який вже оновлює дані.

​
Приклад: кілька дій в одному повідомленні

Асистент може надіслати кілька дій одночасно. Наприклад, після редагування ключових слів та бажання показати вкладку Груп оголошень: 
{
  "role": "assistant",
  "content": "Я додав 5 ключових слів до групи 'Brand'. Подивіться!",
  "frontend_actions": [
    "update_campaign_draft",
    "set_campaign_draft_step_2"
  ]
}
Обробіть обидва: перезавантажте чернетку та переключіться на крок 2.