# Миграция с 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 ([подробнее](/guides/n8n/resources#simplify)) |
| **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:

1. Откройте workflow в n8n
2. Удалите v1 ноду Pachca
3. Добавьте новую ноду Pachca (по умолчанию v2)
4. Перенастройте с v2 именами ресурсов и операций
5. API-вызовы идентичны — изменились только имена в UI

> При удалении ноды и добавлении новой вы получите v2 с обновлёнными именами и новыми ресурсами. Все параметры и API endpoint-ы остались прежними.