Продвинутые функции
Загрузка файлов
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. |
| URL | File URL | Узел сам скачает файл по ссылке |
В Additional Fields можно задать File Name и Content Type. Если их не указать, имя возьмётся из бинарных данных или ссылки, а тип — из бинарных данных или расширения файла.
Пример workflow: загрузка PDF и отправка в чат
- HTTP Request — скачать файл по URL
- Pachca (File > Create) — загрузить файл, в ответе придут
key,file_name,content_typeиsize - Pachca (Message > Create) — отправить сообщение с файлом: в Additional Fields > Files укажите Key, Name, File Type и Size из ответа предыдущего узла
Подробнее — в документации загрузки файлов.
Загрузка аватара
Операции Update Avatar и Delete Avatar есть у ресурсов Profile, User, Chat и Bot. Аватар загружается через multipart/form-data: подходят jpg, jpeg, png и gif.
Как использовать:
- HTTP Request или Read/Write Files from Disk — загрузите изображение в бинарное свойство (по умолчанию
data) - Pachca (например, Profile > Update Avatar или User > Update Avatar) — в поле Input Binary Field укажите имя бинарного свойства
Для удаления аватара используйте операцию Delete Avatar: для Profile она не требует параметров, для User, Chat и Bot нужен только ID.
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 на ваш вебхук:
Скачайте архив
В 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, одна строка из двух кнопок:
Число кнопок и длина их полей ограничены, подробнее — в разделе Ограничения. Чтобы убрать кнопки при обновлении сообщения, выберите Raw JSON и укажите пустой массив [].
Подробнее о кнопках, их внешнем виде в чате и обработке нажатий — в документации кнопок.
Формы
Ресурс Form открывает сотрудникам модальные формы (представления).
Как это работает:
- Сотрудник нажимает Data-кнопку в сообщении бота
- Бот получает вебхук с
trigger_id - Бот вызывает POSTОткрытие представления с
trigger_idи описанием формы - Сотрудник видит модальное окно с полями
Поля Form > Create:
| Поле | Описание |
|---|---|
| Title | Заголовок модального окна |
| Type | Тип представления, единственное значение — Modal |
| Trigger ID | trigger_id из события о нажатии кнопки. Форму нужно открыть в первые 3 секунды после нажатия, подробнее — в разделе Сроки ответа. |
| Builder Mode | Visual Builder (по умолчанию) — блоки формы собираются в конструкторе Form Blocks. JSON — массив блоков вставляется в поле Blocks (JSON). |
| Additional Fields | Callback ID, по которому форму узнают при отправке, Private Metadata, Submit Text и Close Text |
Пример workflow: у бота один адрес вебхука, поэтому нажатие кнопки и отправку формы принимает один узел Pachca Trigger с событием All Events.
- Pachca Trigger — событие
All Events - Switch — разводит события по полю
type:buttonдля нажатия,viewдля отправки формы - Pachca (Form > Create) — на ветке нажатия открывает форму с
trigger_idиз события и Callback ID - На ветке отправки — обработка данных формы из поля
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 самостоятельно выбирает подходящий инструмент на основе запроса сотрудника — ищет информацию, создаёт напоминания или отправляет сообщения.
Разворачивание ссылок
Ресурс 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 ID | ID сотрудника или бота, совершившего действие |
| Actor Type | Тип инициатора. У сотрудников и ботов это User, значение сравнивается точно, с учётом регистра. |
| Entity ID | ID объекта, над которым совершено действие |
| Entity Type | Тип объекта, например User, Chat или Message |
| Start Time | Начало периода |
| End Time | Конец периода |
Подробнее — в документации журнала аудита.