Все обновления

Весна 2026

21 мая 2026
CLIv2026.5.6
~
В выводе pachca api <МЕТОД> <путь> --describe у полей запроса и ответа появились примеры значений
20 мая 2026

Список тредов

Был добавлен новый метод:

С помощью этого метода вы можете получить доступные треды и собирать по ним сводки и дайджесты за период.

n8nv2.0.9
+
Thread: новая операция Get Many — список тредов с фильтром по времени последнего сообщения (Last Message At After / Last Message At Before) и курсорной пагинацией
CLIv2026.5.4
+
pachca threads list — список доступных тредов с фильтрами --last-message-at-after / --last-message-at-before и курсорной пагинацией
SDKv1.0.19
+
Метод Список тредов (GET /threads) с фильтром по времени последнего сообщения и курсорной пагинацией
17 мая 2026

Гостевая роль и чаты при создании сотрудника, справка по API в CLI

В метод создания сотрудника добавлен параметр chat_ids — идентификаторы чатов, в которые сотрудник будет добавлен сразу при создании. Параметр role теперь принимает значение guest: для роли guest параметр chat_ids обязателен и должен содержать ровно один активный чат.

Был обновлен следующий метод:

В CLI добавлены команды для просмотра списка всех эндпоинтов и справки по каждому — не нужно знать эндпоинт заранее или искать его в документации. Данные генерируются из той же OpenAPI-спецификации, из которой собран сам CLI, поэтому всегда совпадают с актуальным API. Для AI-агентов это ключевое: не нужно загружать документацию в контекст — агент запрашивает у CLI нужный метод и сразу его вызывает.

Заодно документация CLI переработана и разбита на разделы с понятной прогрессией от терминала к агентам. Подробнее — Команды, Сценарии и AI агенты.

n8nv2.0.8
+
Create User: параметр chat_ids (добавить сотрудника в чаты сразу при создании) и значение guest для role (для гостя chat_ids обязателен и содержит ровно один активный чат)
CLIv2026.5.2
+
pachca users create: параметр --chat-ids (добавить сотрудника в чаты сразу при создании) и поддержка --role guest (для гостя нужен --chat-ids ровно с одним активным чатом)
+
Список эндпоинтов и справка по API прямо в CLI: pachca api ls (список всех эндпоинтов), pachca api <МЕТОД> <путь> --describe / --spec / --docs (параметры, тело, схема, пример) — данные из той же OpenAPI-спецификации, из которой собран CLI
+
pachca api --data '{json}' — тело запроса инлайн JSON-строкой
+
Флаг --plain — плоский TSV-вывод для скриптов (без заголовка, id первым)
+
Переменная окружения PACHCA_HOME — переопределение каталога конфига (CI, тесты, агенты)
SDKv1.0.17
+
Метод создания сотрудника: новое поле chat_ids и значение guest для role (для гостя chat_ids обязателен и содержит ровно один активный чат)
06 мая 2026

Курсорная пагинация и параметр skip в unfurl-вебхуке

В объект meta.paginate всех методов с курсорной пагинацией добавлены три новых поля:

  • prev_page — курсор на предыдущую страницу (для polling новых записей «сверху» списка)
  • has_next — есть ли ещё данные на следующей странице
  • has_prev — есть ли ещё данные на предыдущей странице

Признак конца данных теперь — has_next: false, а не пустой data. Курсоры next_page и prev_page всегда присутствуют в ответе и никогда не равны null. Изменение обратно совместимо: интеграции, использующие только next_page, продолжат работать без изменений. Подробнее — на странице Пагинация.

Затронутые методы:

В вебхуке Разворачивание ссылок каждый объект массива links теперь содержит поле skip: boolean. Если значение true — автор сообщения скрыл превью для этой ссылки, и бот не должен её разворачивать. Это позволяет уважать выбор пользователя и не генерировать нежелательные превью.

n8nv2.0.7
+
Pachca Trigger: в link_shared payload каждый объект массива links теперь содержит skip: boolean. Если true — автор сообщения скрыл превью для этой ссылки, бот не должен её разворачивать
~
Поддержка обновлённого формата курсорной пагинации в list-операциях
CLIv2026.5.1
~
Поддержка обновлённого формата курсорной пагинации в list-командах
SDKv1.0.16
+
Модель WebhookLink (payload вебхука link_shared) получила поле skip: boolean — индикатор того, что автор сообщения скрыл превью для конкретной ссылки
~
Поддержка обновлённого формата курсорной пагинации в list-методах
Generatorv1.1.4
~
Подтянута обновлённая OpenAPI-спецификация. Изменений в коде генератора нет — technical re-publish.
05 мая 2026

Расширение n8n опубликовано в официальной витрине

Расширение Пачки опубликовано в витрине интеграций n8n со статусом verified by n8n — партнёрская интеграция, проверенная командой n8n. Доступны Pachca (действия, 18 ресурсов) и Pachca Trigger (16 типов событий через вебхуки).

Подробнее — в обновлённом разделе Начало работы.

04 мая 2026

Поле inviter_id, nullable-уточнения и chat_id в вебхуках

В модель Сотрудник добавлено новое поле inviter_id — идентификатор того, кто пригласил сотрудника в компанию. Возвращает null, если сотрудник зарегистрировался самостоятельно или если пригласивший был удалён.

Уточнены типы полей модели User: поля last_name, email, phone_number, department, title, time_zone и last_activity_at теперь корректно объявлены как nullable. Поля email и phone_number возвращают null для ботов без права просмотра персональных данных.

В payload трёх исходящих вебхуков (reaction_new, reaction_delete, view_submit) добавлено поле chat_id — идентификатор чата, в котором произошло событие. Поле всегда присутствует в payload, в редких случаях может прийти как null. Это убирает необходимость в дополнительном запросе GETИнформация о сообщении для определения чата по событию. Подробнее о поведении chat_id для view_submit — в разделе Заполнение формы.

Были обновлены следующие методы:

n8nv2.0.6
+
Trigger: в payload трёх вебхуков (reaction_new, reaction_delete, view_submit) добавлено поле chat_id — id чата, в котором произошло событие. Всегда присутствует, в редких случаях может быть null. Для view_submit отражает чат на момент открытия формы, а не сабмита.
+
Модель User: новое поле inviter_id (кто пригласил сотрудника); null для самостоятельной регистрации или удалённого пригласившего
~
Модель User: поля last_name, email, phone_number, department, title, time_zone, last_activity_at корректно объявлены как nullable. email и phone_number возвращают null для ботов без права просмотра персональных данных.
CLIv2026.5.0
~
В вывод сотрудника (users list/get/create/update, profile get) добавлено поле inviter_id
~
Поля сотрудника last_name, email, phone_number, department, title, time_zone, last_activity_at корректно объявлены как nullable
SDKv1.0.15
+
Модель User: новое поле inviter_id — идентификатор сотрудника, который пригласил данного пользователя
~
Модель User: поля last_name, email, phone_number, department, title, time_zone, last_activity_at корректно объявлены как nullable
+
Webhook payload reaction_new, reaction_delete, view_submit: добавлено поле chat_id (id чата, в котором произошло событие; в редких случаях может быть null)
28 апреля 2026
SDKv1.0.14
+
TypeScript SDK: dual-publish ESM/CJS — пакет теперь работает и в Node.js (CommonJS), и в современных бандлерах. attw-проверка в CI не пропускает регрессии.
~
TypeScript SDK: фабрика stub() теперь принимает объект-форму параметров (stub({ apiKey })) вместо отдельных аргументов
Generatorv1.1.3
~
TypeScript: корректный dual-publish ESM/CJS и stub в виде объекта
13 апреля 2026

Документация n8n и обновление Trigger

Раздел n8n дополнен новыми страницами и обновлениями:

  • Тестирование — новая страница: тестирование триггера и экшн-узлов, защита webhook-слота, локальная разработка через туннель
  • Триггер — переработанная документация: ручной и автоматический режимы регистрации вебхука, диаграммы жизненного цикла, безопасность (подпись, IP-фильтр, защита от повторов)
  • Устранение ошибок — новые разделы: 403 при активации триггера, ограничения токенов ботов в автоматическом режиме
n8nv2.0.5
Исправлена ошибка 403 в Trigger при бот-токенах — добавлен параметр Webhook Setup с ручным и автоматическим режимами
Исправлены файловые вложения v1: fileTypefile_type для обоих форматов блоков
+
Автоповтор при 429 и 5xx: до 3 попыток с exponential backoff и Retry-After
~
Trigger: определение бот-токенов, блокировка тест-событий при активном workflow, автоочистка webhook URL
10 апреля 2026
SDKv1.0.13
~
Сервисы как интерфейсы для dependency injection
~
HTTP-клиент с конструкторами для кастомной конфигурации
Generatorv1.1.2
+
Сервисы как интерфейсы для dependency injection во всех языках
08 апреля 2026

Упоминания пользователей по ID

При POSTОтправке сообщений и PUTРедактировании сообщений теперь можно упоминать пользователей по идентификатору: просто вставьте <@user_id> в текст сообщения (например, <@3876>) и это автоматически преобразуется это в @nickname. Это удобно для интеграций, когда идентификатор пользователя уже известен и не нужно дополнительно искать его никнейм.

n8nv2.0.1–2.0.4
Исправлена ошибка 403 при загрузке файлов
Исправлен краш в JSON-режиме форм
Исправлена ошибка визуального редактора форм
~
Миграция v1→v2: авто-заполнение параметра type для форм
CLIv2026.4.1
~
Поддержка упоминаний по ID: <@user_id> в тексте сообщения автоматически преобразуется в @nickname
07 апреля 2026

Аватары и сортировка

Были добавлены новые методы для управления аватарами:

С помощью этих методов вы можете загружать и удалять аватары для своего профиля и для сотрудников вашей компании.

В методах GETСписок чатов и GETСписок сообщений чата добавлен новый формат параметров сортировки: sort (поле сортировки) и order (направление: asc или desc).

CLIv2026.4.0
+
Загрузка и удаление аватара профиля и сотрудника
Исправлена сортировка: --order без --sort теперь корректно работает
~
chat_id можно передать первым аргументом: pachca messages list 12345
SDKv1.0.12
+
Автоповтор при 5xx с exponential backoff
~
Обновление API: аватары, сортировка, упоминания
Generatorv1.1.1
+
Генерация C# SDK для .NET 8+
+
Автоповтор при 5xx с exponential backoff и jitter
03 апреля 2026
n8nv2.0.0
+
Полная версия 2.0: автогенерация из OpenAPI с обратной совместимостью v1
+
18 ресурсов и 60+ операций — полное покрытие API
+
Pachca Trigger с авторегистрацией вебхука и 16 типами событий
+
Курсорная автопагинация: Return All / Limit
+
AI Tool Use — использование узлов как инструментов AI Agent
+
Верификация подписи вебхука HMAC-SHA256, IP-фильтр, защита от повторов
27 марта 2026

Примеры кода на C#

Все примеры кода в документации API теперь доступны на C#.

SDKv1.0.9
+
Добавлен C# SDK для .NET 8+
~
Регенерация SDK, улучшения примеров C#
25 марта 2026

Конструктор форм

На странице Формы появился интерактивный конструктор представлений. Добавляйте блоки из палитры, настраивайте все параметры через визуальный редактор и сразу видите результат — включая календарь, время, выпадающие списки, радиокнопки и чекбоксы.

24 марта 2026

Интерактивный playground сообщений и вебхуков

На страницах Кнопки в сообщениях и Входящие вебхуки появились интерактивные playground — редактируйте JSON слева и сразу видите результат справа. Превью сообщения отображает все поля: текст с markdown-разметкой, кнопки, файлы, превью ссылок, кастомные аватар и имя бота.

21 марта 2026

Ошибки оплаты, роли сотрудников, закрепление сообщений

Во все методы, требующие оплаченного тарифа, добавлен ответ 402 Payment Required.

В методах POSTНовый сотрудник и PUTРедактирование сотрудника уточнены допустимые значения поля role: admin, user и multi_guest. Значение guest недоступно для установки через API — оно присутствует только в ответах.

Поле link_preview в запросе POSTОтправить сообщение перенесено на верхний уровень тела запроса — отдельно от объекта message.

Метод POSTЗакрепление сообщения при попытке закрепить уже закреплённое сообщение возвращает 422 Unprocessable Entity.

Параметры start_time и end_time в методе GETЖурнал аудита событий стали необязательными — без них возвращаются все события.

Уточнён тип поля name в модели реакции: string | null вместо опционального.

Были обновлены следующие методы:

CLIv2026.3.10
~
link_preview перемещено на верхний уровень тела запроса
~
Параметры start-time и end-time в security стали необязательными
~
Сортировка через --sort и --order вместо --sort-id
SDKv1.0.3
Исправления по аудиту API: модели, параметры, примеры
20 марта 2026
SDKv1.0.2
Исправлена модель тредов, имя пакета Python, импорты Kotlin
19 марта 2026

Редактирование скоупов, исправления в моделях

Скоупы персональных токенов теперь можно изменять после создания — в настройках токена. Раньше для изменения набора разрешений токен нужно было пересоздавать. Подробнее в разделе Авторизация.

Метод POSTЗакрепление сообщения теперь возвращает 204 No Content вместо 201 Created.

Поле thread в модели сообщения теперь содержит только id и chat_id. Полная модель треда (с message_id, message_chat_id, updated_at) возвращается в методах POSTСоздание треда и GETИнформация о треде.

Поле payload в модели ошибки валидации теперь имеет тип object | null вместо string | null и содержит структурированные данные — идентификатор кастомного свойства при ошибке поля или параметры авторизации.

На странице Авторизация добавлена таблица доступных скоупов с указанием ролей для каждого скоупа.

Были обновлены следующие методы:

CLIv2026.3.9
~
Убрана клиентская валидация скоупов — проверка разрешений только на стороне API
Удалена команда auth refresh — кеширование скоупов больше не используется
18 марта 2026
Generatorv1.0.0–1.1.0
+
Первый релиз: генерация SDK из OpenAPI для TypeScript, Python, Go, Kotlin, Swift
+
Загрузка спецификации по URL с дефолтным адресом Пачки
17 марта 2026

Справочник моделей данных

Появилась новая страница Модели — справочник всех моделей данных API. На одной странице собраны 14 моделей с таблицами свойств и ссылками на связанные методы: сотрудник, чат, тред, сообщение, реакция, напоминание, бот, тег и другие.

CLIv2026.3.8
+
Команда pachca upgrade — обновление CLI до последней версии
Ошибки авторизации в JSON-формате, баннер обновления при ошибках
16 марта 2026
CLIv2026.3.7
+
Загрузка файла одной командой pachca upload (подпись + загрузка автоматически)
~
Обязательный флаг --direct-url для прямых запросов без авторизации
15 марта 2026
CLIv2026.3.6
~
Топик thread переименован в threads
14 марта 2026

Новые руководства и реструктуризация документации

Появились новые руководства с пошаговыми инструкциями и скриншотами:

Документация реструктурирована: Быстрый старт, Пагинация, Загрузка файлов, Запросы и ответы вынесены в отдельные страницы, раздел форм разбит на три страницы.

В вебхук Отправка ссылок добавлено поле user_id — идентификатор отправителя сообщения со ссылкой.

SDKv1.0.1
~
Регенерация SDK после реструктуризации документации
07 марта 2026
CLIv2026.3.5
~
Сценарии переписаны на CLI-примеры с подсказками
+
Пример «Форма заявки/запроса»
05 марта 2026

Сценарии

Появился новый раздел Сценарии — пошаговые инструкции для типичных задач с API. Каждый сценарий описывает, какие методы вызывать и в каком порядке, с учётом неочевидных ограничений.

Доступны в виде справочника с поиском, входят в Agent Skills для AI-агентов и встроены в CLI.

CLIv2026.3.4
+
Переменная PACHCA_API_URL для кастомного base URL
Исправлено выравнивание в уведомлении о доступном обновлении
04 марта 2026
CLIv2026.3.1–2026.3.3
+
Все флаги в kebab-case, boolean-флаги с --no- префиксом
+
Структурированные ошибки валидации с hint-подсказками
+
Команда doctor — диагностика окружения
+
Команда introspect — метаинформация о командах для агентов
+
Команда api — прямые HTTP-запросы с -f/-F, --input, --query
+
Команда guide — поиск по сценариям использования API
~
Описания команд и топиков переведены на русский язык
SDKv1.0.0
+
Первый релиз SDK: TypeScript, Python, Go, Kotlin, Swift
+
Типизированные клиенты с автопагинацией для каждого языка
03 марта 2026

CLI для работы с API

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