Работа с данными в n8n: items, JSON и нормализация ¶

Обновлено: 2026-05-29

В n8n данные проходят по workflow как набор items. Каждый item обычно содержит JSON: строку таблицы, сообщение Telegram, payload webhook, ответ API или подготовленный объект для следующей ноды. Большинство ошибок возникает не из-за интеграций, а из-за неверного ожидания формы данных.

Что такое item ¶

Если Google Sheets вернул 50 строк, дальше пойдёт 50 items. Если HTTP Request вернул один объект, дальше пойдёт один item. Если API вернул массив внутри data, его часто нужно превратить в отдельные items.

Пример нормализованного item:

{
  "name": "Анна",
  "email": "anna@example.com",
  "source": "telegram",
  "status": "new"
}

Нормализация входа ¶

Сразу после trigger добавляйте Set/Edit Fields и приводите данные к стабильному виду:

email: {{ ($json.email || $json.contact?.email || "").toLowerCase() }}
phone: {{ $json.phone || $json.contact?.phone || null }}
created_at: {{ $now.toISO() }}

Так следующие ноды работают с понятными полями, а не с разными вариантами сырого JSON.

Массивы и вложенные поля ¶

Вложенные поля читаются через точку: {{ $json.user.name }}. Массивы — через индекс: {{ $json.items[0].price }}. Если массив может быть пустым, используйте безопасный доступ: {{ $json.items?.[0]?.price || 0 }}.

Set, Code и Merge ¶

Set/Edit Fields подходит для простого переименования и добавления полей. Code node нужен для циклов, группировки и сложной фильтрации. Merge объединяет ветки, но требует внимания к ключам и item linking.

Что читать дальше ¶

Для синтаксиса откройте выражения, для сложных преобразований — JavaScript.

Чеклист внедрения ¶

Перед публикацией workflow проверьте его на нескольких реальных примерах данных, а не только на одном успешном тесте. Убедитесь, что обязательные поля валидируются, пустые значения не ломают выражения, а каждая ветка имеет понятное завершение.

• Ноды названы по действию, а не по типу.
• Входные данные нормализованы в начале workflow.
• Есть fallback для неожиданных статусов и пустых полей.
• Ошибки пишутся в execution и при необходимости отправляются в alert.

Как понять, что тема нужна ¶

Если одна и та же проблема повторяется в нескольких workflow, лучше оформить её как отдельный шаблон: нормализация входа, проверка credentials, обработка ошибки или типовой фрагмент выражения. Так база знаний становится не набором заметок, а рабочей системой поддержки n8n.