Skip to main content
Наполегливо рекомендуємо створювати автоматизації за допомогою дії «Запуск сценарію», оскільки вона охоплює всі типи дій, зокрема ті, які інакше довелося б створювати вручну. Просто опишіть свої вимоги ШІ в чаті.Зверніть увагу: якщо ви додасте дії вручну, ШІ надалі не розпізнаватиме й не змінюватиме їх.
Цикл дає змогу виконувати дію один раз для кожного елемента масиву. Замість обробки одного запису або надсилання одного листа цикл повторює дію для кожного елемента списку — масово створює записи, надсилає персоналізовані листи списку контактів або виконує виклики API для кожного елемента. Елементи обробляються по черзі, а результати всіх ітерацій повертаються як масив, який можуть використовувати наступні кроки.

Підтримувані дії

Звідки беруться масиви

Для використання циклу потрібен масив як вхідні дані. Поширені джерела:

Як налаштувати

  1. Відкрийте підтримувану дію (наприклад, «Створити запис» або «Надіслати електронний лист»).
  2. Натисніть Запуск циклу під засобом вибору таблиці (або в області налаштування дії).
  3. У засобі вибору джерела даних виберіть змінну-масив із попереднього кроку. Наприклад, масив записів із кроку «Отримати записи».
  4. В області зіставлення полів тепер відображаються властивості кожного окремого елемента, а не всього масиву. Натисніть +, щоб посилатися на властивості поточного елемента — наприклад, ім’я, електронну адресу або статус поточного запису.
  5. Збережіть дію. Під час виконання робочого процесу дія виконуватиметься один раз для кожного елемента масиву.

Як посилатися на поточний елемент

Коли цикл активний, засіб вибору змінних + показує властивості поточного елемента ітерації. Наприклад:
  • Під час перебору результату дії «Отримати записи» можна посилатися на поточний елемент → поля → Ім’я, поточний елемент → поля → Електронна пошта тощо.
  • Під час перебору масиву вебхука можна посилатися на поточний елемент → product_name, поточний елемент → quantity тощо.
Це відрізняється від режиму без циклу, де ви посилаєтеся на весь масив або певний індекс.

Конкретний приклад: надсилання нагадувань про прострочені завдання

  1. Тригер: у запланований час — щодня о 9:00.
  2. Дія 1: Отримати записи — з таблиці завдань; фільтр: дата виконання раніше за сьогодні І статус не дорівнює «Виконано».
  3. Дія 2: Надіслати електронний лист із увімкненим Циклом, джерело даних = масив записів Дії 1.
    • Кому: поле електронної адреси виконавця поточного елемента.
    • Тема: Нагадування: "{{current item → Task Name}}" прострочено
    • Текст: Вітаємо, {{current item → Assignee Name}}! Термін виконання завдання "{{current item → Task Name}}" минув {{current item → Due Date}}. Оновіть його.
Результат: один персоналізований лист для кожного простроченого завдання.

Масив у тілі HTTP-запиту

Для дій HTTP-запиту цикл пропонує спеціальний режим Масив у тілі. Замість надсилання окремого HTTP-запиту для кожного елемента (що може бути повільним і призвести до перевищення обмежень частоти) цей режим надсилає весь масив як один масив JSON в одному запиті. Це корисно, якщо зовнішній API підтримує пакетні операції — наприклад, створення кількох записів одним викликом API або надсилання пакета подій аналітичному сервісу. Щоб використовувати масив у тілі:
  1. Увімкніть цикл у дії HTTP-запиту.
  2. Виберіть режим Масив у тілі замість стандартного режиму для окремих елементів.
  3. Увесь масив буде серіалізовано як масив JSON і надіслано в тілі запиту.

Міркування щодо продуктивності

  • Цикл обробляє елементи послідовно, а не паралельно. Цикл зі 100 елементів триватиме приблизно в 100 разів довше, ніж одне виконання.
  • Для великих масивів (сотень або тисяч елементів) з’ясуйте, чи може зовнішня дія приймати пакетні вхідні дані. Використовуйте масив у тілі HTTP-запиту, якщо API його підтримує.
  • Якщо ви перебираєте результат дії «Отримати записи» й виконуєте HTTP-запити для кожного запису, зважайте на обмеження частоти зовнішнього API.
  • Для дуже великих наборів даних розділяйте роботу на менші пакети за допомогою пагінації в дії «Отримати записи» (Пропустити/Взяти) і кількох запусків автоматизації.

Коли використовувати

  • Масове створення записів. Отримайте записи з однієї таблиці та в циклі створіть відповідні записи в іншій.
  • Надсилання персоналізованих листів списку. Отримайте список контактів і в циклі надішліть кожному персоналізований лист.
  • Оновлення кількох записів. Отримайте записи, що відповідають умові, і в циклі оновіть кожен із них (наприклад, позначте всі прострочені завдання як «Передано на вищий рівень»).
  • Виклики API для кожного запису. По черзі передавайте дані кожного запису до зовнішньої системи.
  • Обробка пакета записів за допомогою ШІ. Переберіть записи в циклі й скористайтеся дією «Генерування за допомогою ШІ», щоб класифікувати, узагальнити або видобути дані з кожного запису.

Поради

  • Перед увімкненням циклу завжди перевіряйте розмір масиву. Якщо дія «Отримати записи» повертає 1 000 записів, цикл виконається 1 000 разів.
  • Якщо цикл створює або оновлює записи в тій самій таблиці, яка запустила автоматизацію, остерігайтеся повторного запуску автоматизації. Використовуйте фільтри тригера, щоб уникнути циклів.
  • Результати всіх ітерацій циклу доступні наступним крокам як масив, але для дуже великих циклів цей масив може бути великим. Посилайтеся лише на потрібні дані.

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

Останнє оновлення 4 вересня 2026 р.