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

Продвинутые функции

Загрузка файлов

File > Create с загрузкой файла по ссылке

Операция File > Create загружает файл через двухшаговый S3 upload. n8n выполняет оба этапа сам: запрашивает параметры загрузки через API и загружает файл в хранилище.

Откуда взять файл, задаёт поле File Source:

File SourceПолеОписание
Binary Data (по умолчанию)Input Binary FieldФайл из бинарного свойства предыдущего узла, например HTTP Request или Read/Write Files from Disk. По умолчанию свойство называется data.
URLFile URLУзел сам скачает файл по ссылке

В Additional Fields можно задать File Name и Content Type. Если их не указать, имя возьмётся из бинарных данных или ссылки, а тип — из бинарных данных или расширения файла.

Пример workflow: загрузка PDF и отправка в чат

  1. HTTP Request — скачать файл по URL
  2. Pachca (File > Create) — загрузить файл, в ответе придут key, file_name, content_type и size
  3. Pachca (Message > Create) — отправить сообщение с файлом: в Additional Fields > Files укажите Key, Name, File Type и Size из ответа предыдущего узла
Загруженный файл привязывается к сообщению полем Files при создании или обновлении сообщения. Файл, который никуда не привязали, в чате не появится.

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


Загрузка аватара

Операции Update Avatar и Delete Avatar есть у ресурсов Profile, User, Chat и Bot. Аватар загружается через multipart/form-data: подходят jpg, jpeg, png и gif.

Как использовать:

  1. HTTP Request или Read/Write Files from Disk — загрузите изображение в бинарное свойство (по умолчанию data)
  2. Pachca (например, Profile > Update Avatar или User > Update Avatar) — в поле Input Binary Field укажите имя бинарного свойства

Для удаления аватара используйте операцию Delete Avatar: для Profile она не требует параметров, для User, Chat и Bot нужен только ID.

Операции с аватарами сотрудников (User > Update/Delete Avatar) требуют прав администратора. Аватар чата меняет тот, кто может редактировать чат (скоуп chats:update), и только у беседы или канала: у личного чата и треда своего аватара нет. Аватар бота меняет тот, кто может редактировать бота, токену нужен скоуп bots:write.

Экспорт сообщений

Ресурс Chat (операции Request Export и Download Export) позволяет выгружать сообщения из чатов. Экспорт выполняется асинхронно: вы запрашиваете экспорт, а Пачка присылает уведомление на вебхук, когда архив готов.

Экспорт доступен владельцу пространства на тарифе «Корпорация»: токену нужны скоупы chat_exports:write и chat_exports:read.

Пример workflow:

Настройте приём вебхука

Создайте отдельный workflow с узлом Webhook (встроенный в n8n). Он создаст URL, на который Пачка отправит уведомление о готовности экспорта. Скопируйте этот URL — он понадобится на следующем шаге. Адрес должен быть доступен из интернета: на адрес в локальной сети, например localhost, Пачка ответит 422, подробнее — в разделе Локальная разработка.

Запросите экспорт

В основном workflow добавьте узел Pachca с ресурсом Chat и операцией Request Export. Укажите период в полях Start At и End At, а в Additional Fields → Webhook URL вставьте URL вебхука из первого шага.

Обработайте уведомление

Когда экспорт будет готов, Пачка отправит JSON на ваш вебхук:

{  "type": "export",  "event": "ready",  "export_id": 22322,  "created_at": "2025-03-20T12:33:58Z"}

Скачайте архив

В workflow с Webhook-узлом добавьте узел Pachca с ресурсом Chat и операцией Download Export. Передайте export_id из данных вебхука в поле ID. Архив будет скачан автоматически.

Ограничения:

  • Максимальный период одной выгрузки: 45 дней (366 дней при указании конкретных чатов)
  • Максимум 50 чатов в поле Chat IDs
  • Следующую выгрузку пространство может заказать через 90 секунд после предыдущей, даже если та ещё собирается. Более ранний запрос получит 422 с кодом rate_limit.

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


Кнопки в сообщениях

Две кнопки в одной строке, Button Layout = Single Row

Кнопки к сообщению задаются в операциях Message > Create и Update полем Button Layout. По умолчанию в нём стоит None, и кнопки не отправляются.

Button LayoutКак задать кнопки
NoneКнопок нет. При обновлении кнопки сообщения не меняются.
Single RowВ конструкторе Buttons, все кнопки в одной строке
Multiple RowsВ конструкторе Buttons, каждая кнопка в своей строке
Raw JSONВ поле Buttons (JSON): массив строк, каждая строка — массив кнопок

В конструкторе у каждой кнопки задаются Text, Type и, в зависимости от типа, Data или URL:

TypeЧто делает кнопка
Data (Webhook)Отправляет боту событие о нажатии, его принимает Pachca Trigger с событием Button Pressed
URL (Link)Открывает ссылку в браузере

Пример для Raw JSON, одна строка из двух кнопок:

[  [    { "text": "Подтвердить", "data": "confirm_action" },    { "text": "Открыть сайт", "url": "https://example.com" }  ]]

Число кнопок и длина их полей ограничены, подробнее — в разделе Ограничения. Чтобы убрать кнопки при обновлении сообщения, выберите Raw JSON и укажите пустой массив [].

Подробнее о кнопках, их внешнем виде в чате и обработке нажатий — в документации кнопок.


Формы

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

Как это работает:

  1. Сотрудник нажимает Data-кнопку в сообщении бота
  2. Бот получает вебхук с trigger_id
  3. Бот вызывает POSTОткрытие представления с trigger_id и описанием формы
  4. Сотрудник видит модальное окно с полями

Поля Form > Create:

ПолеОписание
TitleЗаголовок модального окна
TypeТип представления, единственное значение — Modal
Trigger IDtrigger_id из события о нажатии кнопки. Форму нужно открыть в первые 3 секунды после нажатия, подробнее — в разделе Сроки ответа.
Builder ModeVisual Builder (по умолчанию) — блоки формы собираются в конструкторе Form Blocks. JSON — массив блоков вставляется в поле Blocks (JSON).
Additional FieldsCallback ID, по которому форму узнают при отправке, Private Metadata, Submit Text и Close Text

Пример workflow: у бота один адрес вебхука, поэтому нажатие кнопки и отправку формы принимает один узел Pachca Trigger с событием All Events.

  1. Pachca Trigger — событие All Events
  2. Switch — разводит события по полю type: button для нажатия, view для отправки формы
  3. Pachca (Form > Create) — на ветке нажатия открывает форму с trigger_id из события и Callback ID
  4. На ветке отправки — обработка данных формы из поля data события, callback_id подскажет, какая это форма

Готовый сценарий — в примере Заявка на отпуск.

Подробнее о формах, типах полей и внешнем виде модального окна в интерфейсе Пачки — в документации форм.


AI-агент

Узлы Pachca Tool на входе Tool узла AI Agent

Узел Pachca поддерживает usableAsTool: true, поэтому AI Agent в n8n может вызывать его как инструмент. В панели инструментов он называется Pachca Tool. Pachca Trigger запускает сценарий и инструментом быть не может.

Что это значит:

  • AI Agent может вызывать операции Pachca для выполнения задач
  • Примеры: поиск сообщений, отправка ответов, создание напоминаний
  • Agent автоматически выбирает подходящую операцию на основе запроса

Пример: AI-помощник для команды

Настройте триггер

Создайте новый workflow и нажмите Add first step…. В панели What triggers this workflow? найдите Pachca и в списке Triggers выберите On new message: на холсте появится Pachca Trigger с событием New Message.

Добавьте AI Agent

Нажмите + на выходе Pachca Trigger и добавьте узел AI Agent. Без чат-триггера агент не найдёт текст запроса, поэтому в Source for Prompt (User Message) выберите Define below, а в Prompt (User Message) укажите {{ $json.content }}. Затем нажмите + на входе Chat Model и выберите модель в панели Language Models, например Anthropic Chat Model или OpenAI Chat Model, с Credentials провайдера.

Подключите инструменты Pachca

Нажмите + на входе Tool узла AI Agent, найдите в панели Tools узел Pachca Tool и выберите операцию, например Search > Get Many Messages для поиска по сообщениям. Добавьте ещё один Pachca Tool с операцией Message > Create, чтобы агент отправлял ответы.

AI Agent самостоятельно выбирает подходящий инструмент на основе запроса сотрудника — ищет информацию, создаёт напоминания или отправляет сообщения.

Без модели на входе Chat Model узел AI Agent не запустится. Это обязательный вход, на холсте он отмечен звёздочкой.

Разворачивание ссылок

Ресурс Message с операцией Unfurl ставит к ссылкам в сообщениях превью с заголовком, описанием и изображением — например, к ссылкам на задачи во внутреннем трекере.

Сценарий начинается с события Link Shared в узле Pachca Trigger: бот получает его, когда в любом чате пространства появляется ссылка на один из его доменов. Домены и само событие задаются на вкладке Исходящий вебхук в карточке бота, и включить их может только администратор или владелец пространства. Адрес вебхука такого бота тоже прописывают только они: в Pachca Trigger выберите ручной режим или автоматический с персональным токеном администратора. Дальше workflow собирает данные по ссылке и отвечает операцией Unfurl — методом POSTUnfurl (разворачивание ссылок) по message_id из события.

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


Журнал безопасности

Ресурс Security предоставляет доступ к журналу аудита — списку событий безопасности в пространстве. Журнал доступен владельцу пространства на тарифе «Корпорация», токену нужен скоуп audit_events:read.

Фильтры в Additional Fields операции Get Many:

ФильтрОписание
Event KeyТип события из списка, например User Login (user_login), Message Created (message_created) или User Deleted (user_deleted)
Actor IDID сотрудника или бота, совершившего действие
Actor TypeТип инициатора. У сотрудников и ботов это User, значение сравнивается точно, с учётом регистра.
Entity IDID объекта, над которым совершено действие
Entity TypeТип объекта, например User, Chat или Message
Start TimeНачало периода
End TimeКонец периода

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