Руководства

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

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

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

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

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

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

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

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

Message

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

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

Ключевые параметры 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Разархивация чата
Request Export	POSTЭкспорт сообщений
Download Export	GETСкачать архив экспорта
Get Many Workspace Chats	GETСписок чатов пространства

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

Get Many Workspace Chats отдаёт беседы и каналы всего пространства, включая закрытые, где владелец токена не состоит. Фильтр Activity оставляет только активные или только архивные. Доступно владельцу пространства на тарифе «Корпорация».

Экспорт чата выполняется асинхронно: операция Request Export ставит задачу, Пачка присылает на webhookUrl вебхук с export_id, затем Download Export скачивает архив по id. Поле webhookUrl необязательно, но без него номер выгрузки в сценарий не придёт — заказавший узнает его только из письма и уведомления. Доступно владельцу на тарифе «Корпорация».

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Новый тред
Create Standalone	POSTНовый самостоятельный тред
Get	GETИнформация о треде
Get Many	GETСписок тредов

Reaction

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

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

Profile

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

Операция	API
Get	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).

OAuth

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

Операция	API
Get Info	GETИнформация о токене

Task

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

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

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

Draft

Черновики и отложенные сообщения: полный CRUD.

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

Отложенное сообщение создаётся полем Schedule у операции Create: в нём задаётся время первой отправки и правило повтора. Без Schedule получается обычный черновик, который никуда не уйдёт. Отменить отправку можно только операцией Delete.

Ресурс работает только с личным токеном. Скоупы drafts:read и drafts:write токенам ботов не выдаются, поэтому с учётными данными бота операции вернут 403.

Bot

Боты: создание, получение, список, редактирование, удаление, саморегистрация вебхука, ротация токена, история и удаление событий.

Операция	API
Create	POSTНовый бот
Get	GETИнформация о боте
Get Many	GETСписок ботов
Update	PUTРедактирование бота
Delete	DELETEУдаление бота
Update Webhook	PUTСаморегистрация вебхука бота
Recreate Token	POSTРотация токена бота
Recreate Token Self	POSTРотация собственного токена бота
Get Many Events	GETИстория событий
Remove Events	DELETEУдаление события
Get Many Workspace Bots	GETСписок ботов пространства

Get Many Workspace Bots отдаёт всех ботов пространства, включая недоступных владельцу токена для редактирования. У таких ботов заполнены только Name и Nickname, остальные настройки приходят пустыми. Доступно владельцу пространства на тарифе «Корпорация».

File

Загрузка файлов через двухшаговый S3 upload и скачивание вложений, у которых нет прямой ссылки.

Операция	API
Create	POSTПолучение подписи, ключа и других параметров
Get	GETСкачивание файла

Get нужен, только когда url вложения ведёт не в хранилище, а на адрес API: так отдаются зашифрованные и защищённые безопасным контуром файлы. Остальные вложения скачиваются по ссылке из url без этой операции.

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

Form

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

Операция	API
Create	POSTОткрытие представления
Submit Response	POSTОтвет на отправку формы

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

Custom Property

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

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

Read Member

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

Операция	API
Get Many Read Member IDs	GETСписок прочитавших сообщение

Search

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

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

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

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`

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

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

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

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

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

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