n8n
Миграция с v1
Обновление необязательно. Все существующие workflow на v1 продолжают работать без изменений.
Полная обратная совместимость
Версия 2.0 на 100% совместима с v1. При обновлении расширения:
- Существующие workflow остаются на v1 и работают как прежде
- Новые workflow по умолчанию создаются на v2 с обновлёнными именами
- Переход с v1 на v2 — опциональный
Переименованные ресурсы
| v1 | v2 | Изменение |
|---|---|---|
reactions | reaction | Единственное число |
status | profile | Более точное имя |
customFields | customProperty | Более точное имя |
Переименованные операции
| Ресурс | v1 | v2 |
|---|---|---|
| Message | send | create |
| Message | getById | get |
| Chat | getById | get |
| User | getById | get |
| Group Tag | getById | get |
| Group Tag | getUsers | getAllUsers |
| Reaction | addReaction | create |
| Reaction | deleteReaction | delete |
| Reaction | getReactions | getAll |
| Custom Property | getCustomProperties | get |
| Profile | getProfile | get |
| Thread | createThread | create |
| Thread | getThread | get |
| Form | createView | create |
| File | upload | create |
Перенесённые операции
Некоторые операции из v1 ресурсов были перенесены в новые v2 ресурсы:
| v1 ресурс | v1 операция | v2 ресурс | v2 операция |
|---|---|---|---|
| Chat | getMembers | Chat Member | getAll |
| Chat | addUsers | Chat Member | create |
| Chat | removeUser | Chat Member | delete |
| Chat | updateRole | Chat Member | update |
| Chat | leaveChat | Chat Member | leave |
| Group Tag | addTags | Chat Member | addGroupTags |
| Group Tag | removeTag | Chat Member | removeGroupTags |
| Message | getReadMembers | Read Member | getAll |
| Message | unfurl | Link Preview | create |
Все перенесённые операции продолжают работать в v1 workflow без изменений. Маршрутизатор автоматически транслирует v1 имена в v2.
Новые ресурсы (только v2)
| Ресурс | Описание |
|---|---|
| Chat Member | Управление участниками чата: добавление, удаление, роли, теги |
| Custom Property | Дополнительные поля пространства |
| Read Member | Список прочитавших сообщение |
| Link Preview | Разворачивание ссылок в сообщениях |
| Search | Полнотекстовый поиск по чатам, сообщениям, пользователям |
| Chat Export | Экспорт сообщений из чатов |
| Security | Журнал безопасности |
Новые функции
| Функция | Описание |
|---|---|
| Return All / Limit | Курсорная автопагинация вместо ручного per/page |
| Simplify | Переключатель для получения только ключевых полей из ответа API (подробнее) |
| Pachca Trigger | Webhook-нода с авторегистрацией вебхука через Bot ID, 16 типов событий |
| AI Tool Use | Использование узлов как инструментов AI Agent |
| Searchable Dropdowns | Поиск по чатам и пользователям в выпадающих списках |
| File Upload | Загрузка файлов через S3 с поддержкой URL и Binary Data |
| Task CRUD | Полный CRUD для задач (было только создание) |
Как работает совместимость
Расширение использует паттерн VersionedNodeType с defaultVersion: 2:
- V1 и V2 — отдельные классы с собственными описаниями ресурсов и операций
- Общий SharedRouter обрабатывает запросы обеих версий, транслируя v1 имена ресурсов и операций в v2 на лету
- При обновлении расширения существующие ноды сохраняют
typeVersion: 1и используют V1 класс — все параметры и поведение остаются прежними - Новые ноды по умолчанию создаются с
typeVersion: 2и используют чистый V2 класс - В Node Creator отображаются только v2 операции — без дубликатов
- V1 ноды в существующих workflow показывают жёлтый баннер «New node version available» с предложением обновиться
Как обновить workflow (необязательно)
При открытии существующего workflow вы увидите жёлтый баннер в настройках v1 нод — это информационное уведомление, менять ничего не нужно.
Если вы хотите перевести ноду на v2:
- Откройте workflow в n8n
- Удалите v1 ноду Pachca
- Добавьте новую ноду Pachca (по умолчанию v2)
- Перенастройте с v2 именами ресурсов и операций
- API-вызовы идентичны — изменились только имена в UI
При удалении ноды и добавлении новой вы получите v2 с обновлёнными именами и новыми ресурсами. Все параметры и API endpoint-ы остались прежними.