Aggregate и Summarize в n8n: группировка, отчёты и сводки по items ¶
Обновлено: 2026-05-29
Aggregate и Summarize нужны, когда workflow должен не просто обработать каждую запись отдельно, а собрать общую картину: сколько лидов пришло за день, какая сумма оплат прошла через ЮKassa, какие товары заканчиваются на складе, какие ошибки повторяются чаще всего. Эти ноды превращают поток items в отчёт, массив, список или сводку.
Коротко
Aggregate собирает items или поля в один item/список. Summarize считает агрегаты: сумму, среднее, количество, min/max, concatenation и другие сводные значения. Если нужен отчёт для Telegram или email, часто нужны обе ноды.
Когда брать Aggregate, а когда Summarize ¶
| Задача | Нода | Пример результата |
|---|---|---|
| собрать все товары в один массив | Aggregate | items: [{sku, qty}, ...] |
| посчитать сумму оплат | Summarize | total_amount: 154300 |
| сделать список ошибок за сутки | Aggregate | массив failed executions |
| посчитать количество лидов по источнику | Summarize | source=tilda, count=42 |
| собрать текстовый дайджест | Summarize или Code | строка для Telegram/email |
Как работают items ¶
В n8n каждая запись обычно идёт отдельным item. Например, Google Sheets вернул 100 строк — это 100 items. Если дальше отправить Telegram без группировки, получится 100 сообщений. Если нужен один дайджест, сначала соберите эти items в одну структуру, а уже потом отправляйте уведомление.
Aggregate: собрать данные в один объект ¶
Aggregate полезен, когда следующая нода ожидает один JSON-объект. Например, AI Agent должен получить список обращений и написать краткую сводку; email должен содержать таблицу заказов; HTTP API требует массив позиций заказа.
{
"orders": [
{"id": "1001", "amount": 4900, "status": "paid"},
{"id": "1002", "amount": 12900, "status": "paid"}
]
}Перед Aggregate удалите лишние поля: сырой payload, большие вложения, служебные объекты. Иначе один aggregated item может стать слишком тяжёлым.
Summarize: посчитать метрики ¶
Summarize похож на простую сводную таблицу. Он нужен для отчётов: сумма, количество, среднее, минимум, максимум, объединение строк. В бизнес-сценариях это закрывает ежедневные отчёты по лидам, продажам, оплатам, остаткам и ошибкам.
{
"date": "2026-05-29",
"leads_count": 37,
"paid_orders": 12,
"revenue_total": 154300,
"top_source": "yandex"
}Группировка по источнику или статусу ¶
Если нужно посчитать лиды по источникам, сначала нормализуйте поле source: tilda, vk, telegram, manual. Затем Summarize сможет дать понятную сводку. Без нормализации появятся отдельные строки для VK, vk, vkontakte и отчёт станет бесполезным.
Дайджест в Telegram ¶
- Schedule Trigger запускает workflow вечером.
- Google Sheets/Postgres/CRM возвращает записи за день.
- Filter убирает тестовые и пустые записи.
- Summarize считает количество и суммы.
- Aggregate собирает детали в список.
- Code или Set/Edit Fields формирует текст сообщения.
- Telegram отправляет один дайджест.
Типовые ошибки ¶
| Симптом | Причина | Что сделать |
|---|---|---|
| ожидали 1 item, получили много | данные не были агрегированы | добавить Aggregate перед отправкой отчёта |
| сумма неверная | числа пришли строками или с пробелами | привести типы перед Summarize |
| появились дубли в отчёте | нет уникального ключа или фильтра периода | добавить external_id и границы даты |
| Telegram не принимает сообщение | слишком длинный текст | разбить отчёт или отправить файл |
| AI Agent получает слишком много данных | Aggregate собрал весь payload | оставить только нужные поля |
Когда лучше Code node ¶
Если сводка требует сложной логики: сгруппировать по нескольким полям, отсортировать, обрезать топ-10, собрать markdown-таблицу, проще использовать Code node после Aggregate или Summarize. Но не стоит начинать с кода, если задачу можно решить стандартными нодами — визуальный workflow легче поддерживать.
Практический контекст для внедрения ¶
Эта страница полезна не как абстрактная справка, а как рабочая инструкция под использование ноды/паттерна «Aggregate и Summarize в n8n: группировка, отчёты и сводки по items» в рабочем workflow, где важно понимать входные items и формат результата. Перед изменением workflow зафиксируйте источник события: входные данные по теме aggregate summarize: webhook, schedule, ручной запуск или событие внешнего сервиса. Так проще отделить ошибку данных от ошибки настройки n8n и не превратить исправление в набор случайных правок.
Минимальная проверка перед публикацией workflow: один happy path, один пустой payload, один повтор события и одна ошибка внешнего сервиса. Для мониторинга используйте successful executions, skipped items, retry count, error branch usage; эти показатели быстро покажут, что сценарий работает иначе, чем ожидалось.
Связанные материалы ¶
- Schedule Trigger — запуск ежедневных отчётов.
- Filter — убрать лишние items перед сводкой.
- Code node — сложная сборка дайджеста.
- Email digest — пример отчёта по расписанию.