Looping
Циклы — повторное выполнение
Ожидание (Waiting)
Пауза выполнения workflow с возобновлением по времени или событию
Waiting позволяет приостановить выполнение workflow и возобновить его позже — по таймеру или при получении webhook.
Зачем нужен Waiting
Заголовок раздела «Зачем нужен Waiting»| Сценарий | Описание |
|---|---|
| Rate limiting | Задержка между API вызовами |
| Ожидание подтверждения | Пауза до одобрения пользователем |
| Scheduled actions | Отложенное выполнение |
| External events | Ожидание внешнего события |
Wait Node
Заголовок раздела «Wait Node»Нода Wait приостанавливает выполнение workflow.
Режимы работы
Заголовок раздела «Режимы работы»Возобновление через указанное время:
┌────────────┐ ┌────────────┐ ┌────────────┐│ Trigger │───→│ Wait │───→│ Следующая ││ │ │ (5 минут) │ │ нода │└────────────┘ └────────────┘ └────────────┘Настройки:
- Amount: число
- Unit: секунды, минуты, часы, дни
Возобновление в конкретное время:
// Примеры:// - Завтра в 9:00// - Через 3 дня// - В конкретную дату и времяНастройки:
- Resume at: дата и время
Возобновление при получении webhook:
┌────────────┐ ┌────────────┐ ┌────────────┐│ Trigger │───→│ Wait │ ← hook ─│ External ││ │ │ (webhook) │ │ System │└────────────┘ └────────────┘ └────────────┘ │ ↓ ┌────────────┐ │ Следующая │ │ нода │ └────────────┘Настройки:
- Resume URL: уникальный URL для возобновления
Примеры использования
Заголовок раздела «Примеры использования»Пример 1: Rate limiting
Заголовок раздела «Пример 1: Rate limiting»При работе с API с лимитами:
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐│ Get Data │───→│ Process │───→│ Wait │───→│ Next Batch ││ │ │ │ │ (1 секунда)│ │ │└────────────┘ └────────────┘ └────────────┘ └────────────┘Пример 2: Approval workflow
Заголовок раздела «Пример 2: Approval workflow»Отправка письма с ссылками на одобрение/отклонение:
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐│ Request │───→│ Send Email │───→│ Wait │───→│ Switch ││ │ │ (с ссылками)│ │ (webhook) │ │(approve?) │└────────────┘ └────────────┘ └────────────┘ └────────────┘ │ ┌─────────┴─────────┐ ↓ ↓ ┌──────────┐ ┌──────────┐ │ Approved │ │ Rejected │ └──────────┘ └──────────┘Email содержит:
Новый запрос на отпуск от {{ $json.employee }}
[Одобрить]({{ $node.Wait.resumeUrl }}?action=approve)[Отклонить]({{ $node.Wait.resumeUrl }}?action=reject)Пример 3: Scheduled reminder
Заголовок раздела «Пример 3: Scheduled reminder»Напоминание через определённое время:
┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐│ Create │───→│ Slack │───→│ Wait │───→│ Slack ││ Task │ │ (создано) │ │ (24 часа) │ │(напомнить) │└────────────┘ └────────────┘ └────────────┘ └────────────┘Пример 4: Multi-step form
Заголовок раздела «Пример 4: Multi-step form»Сбор данных в несколько этапов:
Step 1: Получить email ↓ [Wait for webhook] ← Пользователь заполняет форму ↓Step 2: Получить контактные данные ↓ [Wait for webhook] ← Пользователь продолжает ↓Step 3: ФинализацияWebhook Resume URL
Заголовок раздела «Webhook Resume URL»При использовании режима On webhook call, Wait нода предоставляет уникальный URL:
// Доступ к URL в выражениях:{{ $node.Wait.resumeUrl }}
// Полный URL примерно такой:https://n8n.example.com/webhook-waiting/abc123-def456Передача данных через webhook
Заголовок раздела «Передача данных через webhook»Данные, отправленные на webhook, доступны в следующих нодах:
# Пример вызова:curl -X POST "https://n8n.example.com/webhook-waiting/abc123" \ -H "Content-Type: application/json" \ -d '{"action": "approve", "comment": "OK"}'// В следующей ноде:{{ $json.action }} // "approve"{{ $json.comment }} // "OK"Хранение состояния
Заголовок раздела «Хранение состояния»Ограничения
Заголовок раздела «Ограничения»| Ограничение | Описание |
|---|---|
| Максимальное время | Зависит от настроек (по умолчанию 365 дней) |
| Память | Данные хранятся в БД, не в памяти |
| Webhooks | URL валиден только пока execution ожидает |
Настройки
Заголовок раздела «Настройки»Timeout
Заголовок раздела «Timeout»// В переменных окружения:EXECUTIONS_TIMEOUT=3600 // Общий timeout (секунды)EXECUTIONS_TIMEOUT_MAX=86400 // Максимальный timeoutLimit Wait Time
Заголовок раздела «Limit Wait Time»В настройках Wait ноды можно установить максимальное время ожидания webhook:
Limit Wait Time: 7 daysЕсли webhook не получен за это время — execution завершается с ошибкой.
Best Practices
Заголовок раздела «Best Practices»1. Устанавливайте разумные лимиты
Заголовок раздела «1. Устанавливайте разумные лимиты»// ✅ Хорошо: конкретный лимитWait: 24 hours (max 7 days)
// ❌ Плохо: бесконечное ожиданиеWait: forever2. Информируйте пользователя
Заголовок раздела «2. Информируйте пользователя»При отправке approval ссылок:
- Укажите deadline
- Объясните последствия бездействия
- Добавьте fallback (автоматическое отклонение)
3. Обрабатывайте timeout
Заголовок раздела «3. Обрабатывайте timeout»┌────────────┐ ┌────────────┐ ┌────────────┐│ Wait │───→│ Switch │───→│ Process ││ (webhook) │ │ (timeout?) │ │ │└────────────┘ └─────┬──────┘ └────────────┘ │ Timeout ↓ ┌────────────┐ │ Fallback │ └────────────┘4. Используйте уникальные идентификаторы
Заголовок раздела «4. Используйте уникальные идентификаторы»При работе с webhooks добавляйте ID для отслеживания:
// В URL:{{ $node.Wait.resumeUrl }}?request_id={{ $json.id }}Альтернативы
Заголовок раздела «Альтернативы»| Задача | Лучший выбор |
|---|---|
| Простая задержка | Wait с time interval |
| Задержка между batch | Split In Batches |
| Запуск по расписанию | Schedule Trigger |
| Ожидание события | Wait с webhook |
| Polling внешней системы | Loop + Wait + IF |