Frontend Actions

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.

Getting started

Customization

Writing content

AI tools

Google Ads

Companies

Campaigns

Огляд

Усі дії

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

`update_campaign_draft`

`enable_submit_button` / `disable_submit_button`

`set_campaign_draft_step_N` (нове)

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

​Огляд

​Усі дії

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

​update_campaign_draft

​enable_submit_button / disable_submit_button

​set_campaign_draft_step_N (нове)

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

Огляд

Усі дії

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

`update_campaign_draft`

`enable_submit_button` / `disable_submit_button`

`set_campaign_draft_step_N` (нове)

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