n8n

Ресурсы и операции

В расширении Пачки каждый узел Pachca работает по модели Resource → Operation: вы выбираете ресурс (например, Message) и операцию над ним (например, Create).

Выбор ресурса в узле Pachca

Для каждого ресурса доступен свой набор операций.

Операции для ресурса Message

Список ресурсов

#	Ресурс	Операций	Описание	Только v2
1	Message	7	Сообщения: создание, редактирование, удаление, закрепление
2	Chat	6	Чаты: создание, обновление, архивация
3	Chat Member	7	Участники чата: добавление, удаление, роли, теги	да
4	User	10	Сотрудники: CRUD, аватар, статус
5	Group Tag	6	Теги сотрудников: CRUD, список пользователей
6	Thread	2	Треды: создание, получение
7	Reaction	3	Реакции: создание, удаление, список
8	Profile	7	Мой профиль: информация, аватар, статус
9	Task	5	Задачи: полный CRUD
10	Bot	3	Боты: обновление, события, удаление событий
11	File	1	Загрузка файлов через S3
12	Form	1	Модальные формы
13	Custom Property	1	Дополнительные поля	да
14	Read Member	1	Список прочитавших сообщение	да
15	Link Preview	1	Разворачивание ссылок	да
16	Search	3	Полнотекстовый поиск	да
17	Chat Export	2	Экспорт сообщений из чатов	да
18	Security	1	Журнал безопасности	да

Для некоторых операций требуются скоупы, которые доступны только определённым ролям (администратор, владелец). При создании персонального токена отображаются только скоупы, доступные вашей роли. Подробнее — в разделе Авторизация.

Message

Сообщения: создание, получение, редактирование, удаление, закрепление и открепление.

Операция	API
Create	POSTСоздание сообщения
Get Many	GETСписок сообщений чата
Get	GETИнформация о сообщении
Update	PUTРедактирование сообщения
Delete	DELETEУдаление сообщения
Pin	POSTЗакрепление сообщения
Unpin	DELETEОткрепление сообщения

Ключевые параметры Create: entityId (ID чата или пользователя), content (текст, Markdown), entityType (discussion, user, thread), files, buttons, parentMessageId.

Сортировка в Get Many: параметры sort (по умолчанию id) и order (asc / desc) определяют порядок выдачи сообщений.

Настройка Message → Get Many

Chat

Чаты: создание, получение, обновление, архивация и разархивация.

Операция	API
Create	POSTСоздание чата
Get Many	GETСписок чатов
Get	GETИнформация о чате
Update	PUTОбновление чата
Archive	PUTАрхивация чата
Unarchive	PUTРазархивация чата

Сортировка в Get Many: параметры sort (id или last_message_at) и order (asc / desc). Также доступны фильтры availability, lastMessageAtAfter, lastMessageAtBefore.

Chat Member

Управление участниками чата: добавление, удаление, изменение ролей, управление тегами.

В v1 эти операции были частью ресурса Chat. В v2 они выделены в отдельный ресурс Chat Member.

Операция	API
Get Many	GETСписок участников чата
Create	POSTДобавление пользователей в чат
Delete	DELETEУдаление пользователя из чата
Update	PUTИзменение роли участника
Leave	DELETEВыход из чата
Add Group Tags	POSTДобавление тегов к чату
Remove Group Tags	DELETEУдаление тегов из чата

User

Сотрудники: полный CRUD, получение и управление статусом.

Операция	API
Create	POSTСоздание сотрудника
Get Many	GETСписок сотрудников
Get	GETИнформация о сотруднике
Update	PUTОбновление сотрудника
Delete	DELETEУдаление сотрудника
Update Avatar	PUTОбновление аватара
Delete Avatar	DELETEУдаление аватара
Get Status	GETПолучение статуса
Update Status	PUTОбновление статуса
Delete Status	DELETEУдаление статуса

Group Tag

Теги (группы) сотрудников: создание, обновление, удаление, список пользователей.

Операция	API
Create	POSTСоздание тега
Get Many	GETСписок тегов
Get	GETИнформация о теге
Update	PUTОбновление тега
Delete	DELETEУдаление тега
Get Many Users	GETСписок пользователей тега

Thread

Треды (комментарии к сообщениям): создание и получение.

Операция	API
Create	POSTСоздание треда
Get	GETИнформация о треде

Reaction

Реакции на сообщения: создание, удаление, список.

Операция	API
Create	POSTДобавление реакции
Delete	DELETEУдаление реакции
Get Many	GETСписок реакций

Profile

Профиль текущего пользователя: информация, статус, информация о токене.

Операция	API
Get	GETИнформация о профиле
Get Info	GETИнформация о токене
Update Avatar	PUTОбновление аватара
Delete Avatar	DELETEУдаление аватара
Get Status	GETПолучение статуса
Update Status	PUTОбновление статуса
Delete Status	DELETEУдаление статуса

Загрузка аватара: операция Update Avatar принимает бинарные данные из предыдущего узла (например, HTTP Request или Read Binary File). В поле Input Binary Field укажите имя бинарного свойства (по умолчанию data).

Task

Задачи (напоминания): полный CRUD.

Операция	API
Create	POSTСоздание задачи
Get Many	GETСписок задач
Get	GETИнформация о задаче
Update	PUTОбновление задачи
Delete	DELETEУдаление задачи

Типы задач: call, email, event, meeting, reminder.

Bot

Управление ботами: обновление настроек, получение и удаление событий.

Операция	API
Update	PUTОбновление бота
Get Many Events	GETСписок событий бота
Remove Events	DELETEУдаление событий

File

Загрузка файлов через двухшаговый S3 upload.

Операция	API
Create	POSTЗагрузка файла

Подробнее — в разделе Продвинутые функции.

Form

Модальные формы (представления).

Операция	API
Create	POSTОткрытие представления

Подробнее — в разделе Продвинутые функции и в документации форм.

Custom Property

Дополнительные поля пространства.

Операция	API
Get	GETСписок дополнительных полей

Read Member

Список пользователей, прочитавших сообщение.

Операция	API
Get Many	GETСписок прочитавших

Link Preview

Разворачивание ссылок в сообщениях.

Операция	API
Create	POSTСоздание превью ссылки

Подробнее — в документации разворачивания ссылок.

Search

Полнотекстовый поиск по сообщениям, чатам и пользователям.

Операция	API
Get Many Chats	GETПоиск чатов
Get Many Messages	GETПоиск сообщений
Get Many Users	GETПоиск пользователей

Обязательный параметр: query — строка поиска.

Chat Export

Экспорт сообщений из чатов: запрос экспорта и скачивание архива.

Операция	API
Create	POSTЗапрос экспорта
Get	GETСкачивание архива

Ключевые параметры Create: startAt (дата начала, YYYY-MM-DD), endAt (дата окончания), webhookUrl (URL для уведомления о готовности).

Дополнительные параметры: chatIds (экспорт конкретных чатов, до 50), skipChatsFile (не создавать chats.json).

Экспорт выполняется асинхронно. После завершения Пачка отправит вебхук на указанный webhookUrl с export_id. Используйте операцию Get для скачивания готового архива.

Подробнее — в разделе Продвинутые функции и в документации экспорта.

Security

Журнал безопасности: отслеживание действий пользователей.

Операция	API
Get Many	GETСписок событий аудита

Фильтры: eventKey, actorId, actorType, entityId, entityType, startTime, endTime.

Подробнее — в документации журнала аудита.

Пагинация

Все операции Get Many поддерживают автоматическую курсорную пагинацию:

Return All = true — получить все результаты автоматически, переключаясь между страницами
Return All = false — получить не более Limit результатов (по умолчанию 50)

Return All и Limit для операции Get Many

n8n автоматически отправляет повторные запросы с курсором до получения всех данных.

Для операций со списками (Get Many) рекомендуется использовать Return All = false с разумным Limit, чтобы избежать долгих запросов при большом объёме данных.

Simplify

Операции получения данных (Get, Get Many) поддерживают переключатель Simplify (включён по умолчанию). Когда Simplify включён, из ответа API возвращаются только ключевые поля — остальные отбрасываются.

Ресурс	Ключевые поля
Message	`id`, `entity_id`, `chat_id`, `content`, `user_id`, `created_at`
Chat	`id`, `name`, `channel`, `public`, `members_count`, `created_at`
User	`id`, `first_name`, `last_name`, `nickname`, `email`, `role`, `suspended`
Task	`id`, `content`, `kind`, `status`, `priority`, `due_at`, `created_at`
Bot	`id`, `name`, `created_at`
Group Tag	`id`, `name`, `users_count`
Reaction	`id`, `code`, `user_id`, `created_at`
Chat Export	`id`, `status`, `created_at`

Чтобы получить все поля ответа — выключите Simplify.

Simplify доступен только в v2. В v1 workflow всегда возвращают полный ответ API.

Поисковые выпадающие списки

Поиск чата по имени в поле Chat ID

Для поля Chat ID доступен поиск по имени: начните вводить текст, и n8n покажет подходящие результаты из вашего пространства Пачки.

Поиск вызывает API-эндпоинт GETПоиск чатов и работает только с валидным Access Token в Credentials.

SDK

Формы

n8n