Справочники
Миграция с v1
Обновление необязательно. Все существующие workflow на v1 продолжают работать без изменений.
Полная обратная совместимость
Версия 2.0 на 100% совместима с v1. При обновлении расширения:
- Существующие workflow остаются на v1 и работают как прежде
- Новые workflow по умолчанию создаются на v2 с обновлёнными именами
- Переход с v1 на v2 — опциональный
Переименованные ресурсы
| v1 | v2 | Изменение |
|---|---|---|
reactions | reaction | Единственное число |
status | profile | Более точное имя |
customFields | customProperty | Более точное имя |
Ресурс task сохраняет значение, а в списке ресурсов v2 называется Reminder, как напоминания в Пачке. В v1 он называется Task.
Переименованные операции
| Ресурс | 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 | getAllReadMemberIds |
| Message | unfurl | Message | unfurl |
| Form | processSubmission | Pachca Trigger | событие Form Submitted |
Все перенесённые операции продолжают работать в v1 workflow без изменений. Маршрутизатор автоматически транслирует v1 имена в v2. Операции
processSubmission в узле Pachca v2 нет: отправку формы принимает узел Pachca Trigger с событием Form Submitted. Бот без адреса исходящего вебхука отвечает на отправку формы операцией Form > Submit Response.Новые ресурсы (только v2)
| Ресурс | Описание |
|---|---|
| Chat Member | Управление участниками чата: добавление, удаление, роли, теги |
| Draft | Черновики и отложенные сообщения |
| Important Message | Личный раздел «Важное» владельца токена |
| Read Member | Список прочитавших сообщение |
| Search | Полнотекстовый поиск по чатам, сообщениям, сотрудникам |
| OAuth | Информация о токене (скоупы, даты) |
| Security | Журнал безопасности |
| Workspace | Пространство: название и настройки, ссылка-приглашение |
Новые функции
| Функция | Описание |
|---|---|
| Return All / Limit | Курсорная автопагинация вместо ручного per/page |
| Simplify | Переключатель для получения только ключевых полей из ответа API (подробнее) |
| Pachca Trigger | Узел с ручной и автоматической регистрацией адреса вебхука и 19 событиями |
| Searchable Dropdowns | Поиск по чатам и сотрудникам в выпадающих списках |
| Reminder CRUD | Полный CRUD для напоминаний (в v1 ресурс Task умел только создание) |
Как работает совместимость
Расширение использует паттерн VersionedNodeType с defaultVersion: 2:
- V1 и V2 — отдельные классы с собственными описаниями ресурсов и операций
- Общий SharedRouter обрабатывает запросы обеих версий, транслируя v1 имена ресурсов и операций в v2 на лету
- При обновлении расширения существующие ноды сохраняют
typeVersion: 1и используют V1 класс — все параметры и поведение остаются прежними - Новые ноды по умолчанию создаются с
typeVersion: 2и используют чистый V2 класс - В панели узлов отображаются только v2 операции — без дубликатов
- V1 ноды в существующих workflow показывают жёлтый баннер «New node version available» с предложением обновиться
Как обновить workflow (необязательно)
При открытии существующего workflow вы увидите жёлтый баннер в настройках v1 нод — это информационное уведомление, менять ничего не нужно.
Если вы хотите перевести ноду на v2:
- Откройте workflow в n8n
- Удалите v1 ноду Pachca
- Добавьте новую ноду Pachca (по умолчанию v2)
- Перенастройте её с v2 именами ресурсов, операций и параметров
- Проверьте выражения в следующих узлах
Методы API в v2 те же, но ответ и параметры узла отличаются. У операций Get и Get Many по умолчанию включён Simplify: ответ сообщений, чатов, сотрудников и других ресурсов из таблицы ключевых полей урезается до этих полей, и выражения, которые ссылаются на другие поля, получат пустые значения. Чтобы получить полный ответ, как в v1, выключите Simplify. Пагинация задаётся полями Return All и Limit вместо
per и page. Часть параметров переименована: например, кнопки задаются полем Button Layout, а блоки формы — полями Builder Mode и Form Blocks.