Для разработчиков

Миграция с v1

Обновление необязательно. Все существующие workflow на v1 продолжают работать без изменений.

Полная обратная совместимость

Версия 2.0 на 100% совместима с v1. При обновлении расширения:

  • Существующие workflow остаются на v1 и работают как прежде
  • Новые workflow по умолчанию создаются на v2 с обновлёнными именами
  • Переход с v1 на v2 — опциональный

Переименованные ресурсы

v1v2Изменение
reactionsreactionЕдинственное число
statusprofileБолее точное имя
customFieldscustomPropertyБолее точное имя

Ресурс task сохраняет значение, а в списке ресурсов v2 называется Reminder, как напоминания в Пачке. В v1 он называется Task.

Переименованные операции

Ресурсv1v2
Messagesendcreate
MessagegetByIdget
ChatgetByIdget
UsergetByIdget
Group TaggetByIdget
Group TaggetUsersgetAllUsers
ReactionaddReactioncreate
ReactiondeleteReactiondelete
ReactiongetReactionsgetAll
Custom PropertygetCustomPropertiesget
ProfilegetProfileget
ThreadcreateThreadcreate
ThreadgetThreadget
FormcreateViewcreate
Fileuploadcreate

Перенесённые операции

Некоторые операции из v1 ресурсов были перенесены в новые v2 ресурсы:

v1 ресурсv1 операцияv2 ресурсv2 операция
ChatgetMembersChat MembergetAll
ChataddUsersChat Membercreate
ChatremoveUserChat Memberdelete
ChatupdateRoleChat Memberupdate
ChatleaveChatChat Memberleave
Group TagaddTagsChat MemberaddGroupTags
Group TagremoveTagChat MemberremoveGroupTags
MessagegetReadMembersRead MembergetAllReadMemberIds
MessageunfurlMessageunfurl
FormprocessSubmissionPachca 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:

  1. Откройте workflow в n8n
  2. Удалите v1 ноду Pachca
  3. Добавьте новую ноду Pachca (по умолчанию v2)
  4. Перенастройте её с v2 именами ресурсов, операций и параметров
  5. Проверьте выражения в следующих узлах
Методы API в v2 те же, но ответ и параметры узла отличаются. У операций Get и Get Many по умолчанию включён Simplify: ответ сообщений, чатов, сотрудников и других ресурсов из таблицы ключевых полей урезается до этих полей, и выражения, которые ссылаются на другие поля, получат пустые значения. Чтобы получить полный ответ, как в v1, выключите Simplify. Пагинация задаётся полями Return All и Limit вместо per и page. Часть параметров переименована: например, кнопки задаются полем Button Layout, а блоки формы — полями Builder Mode и Form Blocks.