---
title: "n8n Merge: как объединять ветки и данные workflow - Nodbot"
source_url: "https://nodbot.ru/nodes/merge/"
canonical_url: "https://nodbot.ru/nodes/merge/"
language: "ru"
content_type: "KnowledgePage"
section: "nodes"
generated_at: "2026-05-30"
word_count_source: 941
---

# n8n Merge: как объединять ветки и данные workflow

## AI summary

n8n Merge: как объединять ветки и данные workflow: назначение ноды, параметры, входные данные, типовые ошибки и безопасная проверка workflow в n8n.

## Best used for

Страница объясняет «n8n Merge: как объединять ветки и данные workflow - Nodbot» в контексте n8n/Nodbot: когда применять, как проверить внедрение и какие ошибки исключить.

## Key topics

- Основные сценарии
- Пример: лид + данные из CRM
- Ключ к успешному merge
- Типовые ошибки
- Merge или IF?
- Как читать эту ноду в execution history
- Роль ноды в архитектуре workflow
- Практика использования ноды

## Source outline

# n8n Merge: как объединять ветки и данные workflow

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

Merge объединяет данные из двух веток workflow. Это нужно, когда одна ветка получает основную запись, другая — дополнительные данные, а дальше их надо снова собрать в один поток: например, лид + профиль из CRM, товар + цена, пользователь + последние события.

## Основные сценарии

- Сценарий | Подход | Пример
- Склеить два списка подряд | Append | Собрать результаты из двух API
- Объединить записи по id | Combine / matching fields | Лид из формы + строка из базы
- Дождаться двух веток | Merge как точка синхронизации | После параллельных запросов
- Сохранить только совпавшие | Inner join-логика | Обработать только найденных клиентов

## Пример: лид + данные из CRM

- Webhook получает заявку и передаёт email .
- Ветка A нормализует заявку через Set / Edit Fields.
- Ветка B ищет контакт в CRM или PostgreSQL по email.
- Merge объединяет две ветки по email .
- IF решает: обновить существующего клиента или создать нового.

## Ключ к успешному merge

Перед Merge поля для сопоставления должны называться одинаково и иметь одинаковый формат. Если в одной ветке email в верхнем регистре, а в другой в нижнем, matching может не сработать. Поэтому почти всегда перед Merge стоит Set / Edit Fields.

```
email: {{ ($json.email || "").toLowerCase().trim() }}
external_id: {{ String($json.id || "") }}
```

## Типовые ошибки

- После Merge пусто. Нет совпадений по matching field или поле называется по-разному.
- Записей стало слишком много. Получился cartesian product из-за неуникального ключа.
- Порядок сломался. Не полагайтесь на индекс, если данные приходят из разных API.
- Дубли в Google Sheets. Используйте уникальный ключ и проверку перед append.

## Merge или IF?

IF выбирает ветку по условию, Merge собирает ветки обратно. В сложном workflow они часто работают вместе: IF разводит новые и старые записи, Merge соединяет обогащённые данные перед финальной записью.

## Как читать эту ноду в execution history

Разбор n8n Merge: как объединять ветки и данные workflow полезен только тогда, когда читатель понимает, что именно нода получает и что отдаёт дальше. В n8n всегда проверяйте input и output ноды рядом: количество items, имена полей, binary data, paired items и ошибки преобразования.

- Проверка | Что смотреть | Типичная проблема
- Item count | сколько items вошло и вышло | фильтр, merge или code случайно потерял строки
- JSON shape | верхний уровень, вложенные поля, arrays | следующая нода ждёт другое имя поля
- Expressions | какой item используется в expression | берётся первый item вместо текущего
- Errors | continue on fail, retry, error branch | ошибка скрыта и дальше уходит пустой результат

## Роль ноды в архитектуре workflow

Для n8n Merge: как объединять ветки и данные workflow заранее назовите ноду по действию: “нормализовать лид”, “получить заказ”, “проверить дубль”, “ответить webhook”. Если название звучит как “тут вся логика”, ноду стоит разделить: отдельно сбор данных, отдельно проверка, отдельно действие.

- одна нода должна делать одно понятное действие
- после внешнего API нормализуйте response в стабильные поля
- сложные условия выносите в IF/Switch или Code node с тестовыми примерами
- после Merge/Loop/Code проверяйте item linking, иначе downstream expressions могут ломаться
- для production добавляйте owner, комментарий и ссылку на runbook или ошибку

## Практика использования ноды

Страница n8n Merge: как объединять ветки и данные workflow должна отвечать за поведение ноды, а не за полный бизнес-рецепт. Поэтому при внедрении фиксируйте вход, выход и изменение количества items.

- Проверка | Что посмотреть в execution | Частая ошибка
- Input items | сколько items вошло в ноду и какие поля обязательны | ожидается один item, но приходит массив
- Output items | сколько items вышло после обработки | последующие ноды получают другой item index
- Expressions | какие значения реально подставились в параметры | expression возвращает undefined или строку вместо числа
- Error behavior | останавливает ли нода workflow или продолжает ветку | ошибка скрыта Continue On Fail без логирования

## Проверка ноды на реальных items

Ноду или паттерн «n8n Merge» лучше проверять не на одном item, а на наборе входов: пустой объект, массив из нескольких items, неожиданный тип поля и повтор события. Так вы увидите, где ломается mapping ещё до подключения реального API.

Для этой страницы базовый источник данных: входной item по теме «n8n Merge»: источник события, внешний ID, время получения и нормализованные поля. Если нода меняет внешнюю систему, добавьте dry-run или review-ветку.

- Слой | Что зафиксировать | Зачем
- Вход | входной item по теме «n8n Merge»: источник события, внешний ID, время получения и нормализованные поля | позволяет повторить проблему без доступа к production-секретам
- Контроль | successful_executions, skipped_items, retry_count, error_branch_usage, manual_override_count | показывает деградацию раньше, чем пользователи начинают писать в поддержку
- Безопасность | принять happy path за production-готовность и не проверить повторы, пустые входы, откат и наблюдаемость | снижает риск скрытых дублей, утечки данных и неконтролируемых write-действий
- Готовность | есть тест на happy path, пустой вход, повтор и сбой внешнего сервиса для «n8n Merge» | делает статью пригодной для runbook, а не только для чтения

### Пример безопасного входного контракта

```
{
  "source": "manual|webhook|schedule|api",
  "external_id": "stable-id-from-source",
  "received_at": "2026-05-29T10:00:00Z",
  "payload_version": "v1",
  "dry_run": true,
  "audit": {"workflow_id": "...", "execution_id": "..."}
}
```

### Критерий готовности

- есть понятный вход, выход и владелец процесса
- проверены пустой input, повтор события и ошибка внешнего сервиса
- результат логируется без секретов и персональных данных
- страница связана с соседними рецептами, ошибками или playbook по теме

## Практический контекст для внедрения

Эта страница полезна не как абстрактная справка, а как рабочая инструкция под использование ноды/паттерна «n8n Merge: как объединять ветки и данные workflow» в рабочем workflow, где важно понимать входные items и формат результата. Перед изменением workflow зафиксируйте источник события: входные данные по теме merge: webhook, schedule, ручной запуск или событие внешнего сервиса. Так проще отделить ошибку данных от ошибки настройки n8n и не превратить исправление в набор случайных правок.

Минимальная проверка перед публикацией workflow: один happy path, один пустой payload, один повтор события и одна ошибка внешнего сервиса. Для мониторинга используйте successful executions, skipped items, retry count, error branch usage; эти показатели быстро покажут, что сценарий работает иначе, чем ожидалось.

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

Для подготовки ключей смотрите Set / Edit Fields , для ветвлений — IF / Switch .

## Related Nodbot pages

- [Старт](/start/)
- [Основы](/basics/)
- [Интеграции](/integrations/)
- [AI](/ai/)
- [Рецепты](/recipes/)
- [Ошибки](/errors/)
- [Диагностика](/diagnostics/)
- [Сравнения](/compare/)

## Retrieval hints

- Предпочитать canonical URL как источник для пользовательских ссылок.
- Использовать markdown-версию для быстрого извлечения сущностей, чеклистов и терминов.
- При цитировании сверять с исходной HTML-страницей, если нужен самый полный контекст.