> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.

# 🌷 Весна 2026

### 21 мая 2026

### CLI v2026.5.6

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

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

_20 мая 2026_

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

- [Список тредов](GET /threads)

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

### n8n Node v2.0.9

- Thread: новая операция `Get Many` — список тредов с фильтром по времени последнего сообщения (`Last Message At After` / `Last Message At Before`) и курсорной пагинацией

### SDK v1.0.19

- Метод `Список тредов` (`GET /threads`) с фильтром по времени последнего сообщения и курсорной пагинацией

### CLI v2026.5.4

- `pachca threads list` — список доступных тредов с фильтрами `--last-message-at-after` / `--last-message-at-before` и курсорной пагинацией

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

_17 мая 2026_

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

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

- [Создать сотрудника](POST /users)

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

Заодно документация CLI переработана и разбита на разделы с понятной прогрессией от терминала к агентам. Подробнее — [Команды](/guides/cli/commands), [Сценарии](/guides/cli/workflows) и [AI агенты](/guides/ai-agents).

### n8n Node v2.0.8

- Create User: параметр `chat_ids` (добавить сотрудника в чаты сразу при создании) и значение `guest` для `role` (для гостя `chat_ids` обязателен и содержит ровно один активный чат)

### SDK v1.0.17

- Метод создания сотрудника: новое поле `chat_ids` и значение `guest` для `role` (для гостя `chat_ids` обязателен и содержит ровно один активный чат)

### CLI v2026.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, тесты, агенты)

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

_06 мая 2026_

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

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

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

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

- [Список сотрудников](GET /users)
- [Список чатов](GET /chats)
- [Список участников чата](GET /chats/{id}/members)
- [Список сообщений чата](GET /messages)
- [Список реакций](GET /messages/{id}/reactions)
- [Список тегов сотрудников](GET /group_tags)
- [Список сотрудников тега](GET /group_tags/{id}/users)
- [Список напоминаний](GET /tasks)
- [Журнал аудита событий](GET /audit_events)
- [Список прочитавших сообщение](GET /messages/{id}/read_member_ids)
- [История событий](GET /webhooks/events)

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

### n8n Node v2.0.7

- Pachca Trigger: в `link_shared` payload каждый объект массива `links` теперь содержит `skip: boolean`. Если `true` — автор сообщения скрыл превью для этой ссылки, бот не должен её разворачивать
- Поддержка обновлённого формата курсорной пагинации в list-операциях

### CLI v2026.5.1

- Поддержка обновлённого формата курсорной пагинации в list-командах

### SDK v1.0.16

- Модель `WebhookLink` (payload вебхука `link_shared`) получила поле `skip: boolean` — индикатор того, что автор сообщения скрыл превью для конкретной ссылки
- Поддержка обновлённого формата курсорной пагинации в list-методах

### Generator v1.1.4

- Подтянута обновлённая OpenAPI-спецификация. Изменений в коде генератора нет — technical re-publish.

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

_05 мая 2026_

Расширение Пачки опубликовано в [витрине интеграций n8n](https://n8n.io/integrations/pachca/) со статусом **verified by n8n** — партнёрская интеграция, проверенная командой n8n. Доступны [Pachca](https://n8n.io/integrations/pachca/) (действия, 18 ресурсов) и [Pachca Trigger](https://n8n.io/integrations/pachca-trigger/) (16 типов событий через вебхуки).

Подробнее — в обновлённом разделе [Начало работы](/guides/n8n/setup).

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

_04 мая 2026_

В модель [Сотрудник](/api/models#sotrudnik) добавлено новое поле `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 /messages/{id}) для определения чата по событию. Подробнее о поведении `chat_id` для `view_submit` — в разделе [Заполнение формы](/guides/webhook#zapolnenie-formy).

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

- [Список сотрудников](GET /users)
- [Информация о сотруднике](GET /users/{id})
- [Создание сотрудника](POST /users)
- [Редактирование сотрудника](PUT /users/{id})

### n8n Node v2.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` для ботов без права просмотра персональных данных.

### CLI v2026.5.0

- В вывод сотрудника (`users list/get/create/update`, `profile get`) добавлено поле `inviter_id`
- Поля сотрудника `last_name`, `email`, `phone_number`, `department`, `title`, `time_zone`, `last_activity_at` корректно объявлены как nullable

### SDK v1.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

### SDK v1.0.14

- TypeScript SDK: dual-publish ESM/CJS — пакет теперь работает и в Node.js (CommonJS), и в современных бандлерах. `attw`-проверка в CI не пропускает регрессии.
- TypeScript SDK: фабрика `stub()` теперь принимает объект-форму параметров (`stub({ apiKey })`) вместо отдельных аргументов

### Generator v1.1.3

- TypeScript: корректный dual-publish ESM/CJS и stub в виде объекта

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

_13 апреля 2026_

Раздел [n8n](/guides/n8n/overview) дополнен новыми страницами и обновлениями:

- **[Тестирование](/guides/n8n/testing)** — новая страница: тестирование триггера и экшн-узлов, защита webhook-слота, локальная разработка через туннель
- **[Триггер](/guides/n8n/trigger)** — переработанная документация: ручной и автоматический режимы регистрации вебхука, диаграммы жизненного цикла, безопасность (подпись, IP-фильтр, защита от повторов)
- **[Устранение ошибок](/guides/n8n/troubleshooting)** — новые разделы: 403 при активации триггера, ограничения токенов ботов в автоматическом режиме

### n8n Node v2.0.5

- Исправлена ошибка 403 в Trigger при бот-токенах — добавлен параметр Webhook Setup с ручным и автоматическим режимами
- Исправлены файловые вложения v1: `fileType` → `file_type` для обоих форматов блоков
- Автоповтор при 429 и 5xx: до 3 попыток с exponential backoff и Retry-After
- Trigger: определение бот-токенов, блокировка тест-событий при активном workflow, автоочистка webhook URL

### 10 апреля 2026

### SDK v1.0.13

- Сервисы как интерфейсы для dependency injection
- HTTP-клиент с конструкторами для кастомной конфигурации

### Generator v1.1.2

- Сервисы как интерфейсы для dependency injection во всех языках

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

_08 апреля 2026_

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

### CLI v2026.4.1

- Поддержка упоминаний по ID: `<@user_id>` в тексте сообщения автоматически преобразуется в `@nickname`

### n8n Node v2.0.1–2.0.4

- Исправлена ошибка 403 при загрузке файлов
- Исправлен краш в JSON-режиме форм
- Исправлена ошибка визуального редактора форм
- Миграция v1→v2: авто-заполнение параметра type для форм

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

_07 апреля 2026_

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

- [Загрузка аватара](PUT /profile/avatar)
- [Удаление аватара](DELETE /profile/avatar)
- [Загрузка аватара сотрудника](PUT /users/{user_id}/avatar)
- [Удаление аватара сотрудника](DELETE /users/{user_id}/avatar)

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

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

### CLI v2026.4.0

- Загрузка и удаление аватара профиля и сотрудника
- Исправлена сортировка: `--order` без `--sort` теперь корректно работает
- `chat_id` можно передать первым аргументом: `pachca messages list 12345`

### SDK v1.0.12

- Автоповтор при 5xx с exponential backoff
- Обновление API: аватары, сортировка, упоминания

### Generator v1.1.1

- Генерация C# SDK для .NET 8+
- Автоповтор при 5xx с exponential backoff и jitter

### 03 апреля 2026

### n8n Node v2.0.0

- Полная версия 2.0: автогенерация из OpenAPI с обратной совместимостью v1
- 18 ресурсов и 60+ операций — полное покрытие API
- Pachca Trigger с авторегистрацией вебхука и 16 типами событий
- Курсорная автопагинация: Return All / Limit
- AI Tool Use — использование узлов как инструментов AI Agent
- Верификация подписи вебхука HMAC-SHA256, IP-фильтр, защита от повторов

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

_27 марта 2026_

Все примеры кода в документации API теперь доступны на [C#](/guides/sdk/csharp).

### SDK v1.0.9

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

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

_25 марта 2026_

На странице [Формы](/guides/forms/overview) появился интерактивный конструктор представлений. Добавляйте блоки из палитры, настраивайте все параметры через визуальный редактор и сразу видите результат — включая календарь, время, выпадающие списки, радиокнопки и чекбоксы.

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

_24 марта 2026_

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

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

_21 марта 2026_

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

В методах [Новый сотрудник](POST /users) и [Редактирование сотрудника](PUT /users/{id}) уточнены допустимые значения поля `role`: `admin`, `user` и `multi_guest`. Значение `guest` недоступно для установки через API — оно присутствует только в ответах.

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

Метод [Закрепление сообщения](POST /messages/{id}/pin) при попытке закрепить уже закреплённое сообщение возвращает `422 Unprocessable Entity`.

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

Уточнён тип поля `name` в модели [реакции](/api/models#reaktsiya-na-soobschenie): `string | null` вместо опционального.

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

- [Отправить сообщение](POST /messages)
- [Новый сотрудник](POST /users)
- [Редактирование сотрудника](PUT /users/{id})
- [Закрепление сообщения](POST /messages/{id}/pin)
- [Журнал аудита событий](GET /audit_events)

### CLI v2026.3.10

- `link_preview` перемещено на верхний уровень тела запроса
- Параметры `start-time` и `end-time` в security стали необязательными
- Сортировка через `--sort` и `--order` вместо `--sort-id`

### SDK v1.0.3

- Исправления по аудиту API: модели, параметры, примеры

### 20 марта 2026

### SDK v1.0.2

- Исправлена модель тредов, имя пакета Python, импорты Kotlin

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

_19 марта 2026_

Скоупы персональных токенов теперь можно изменять после создания — в настройках токена. Раньше для изменения набора разрешений токен нужно было пересоздавать. Подробнее в разделе [Авторизация](/api/authorization#skoupy).

Метод [Закрепление сообщения](POST /messages/{id}/pin) теперь возвращает `204 No Content` вместо `201 Created`.

Поле `thread` в модели [сообщения](/api/models#message) теперь содержит только `id` и `chat_id`. Полная модель треда (с `message_id`, `message_chat_id`, `updated_at`) возвращается в методах [Создание треда](POST /messages/{id}/thread) и [Информация о треде](GET /threads/{id}).

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

На странице Авторизация добавлена таблица [доступных скоупов](/api/authorization#dostupnye-skoupy) с указанием ролей для каждого скоупа.

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

- [Закрепление сообщения](POST /messages/{id}/pin)
- [Отправить сообщение](POST /messages)
- [Информация о сообщении](GET /messages/{id})
- [Список сообщений чата](GET /messages)

### CLI v2026.3.9

- Убрана клиентская валидация скоупов — проверка разрешений только на стороне API
- Удалена команда `auth refresh` — кеширование скоупов больше не используется

### 18 марта 2026

### Generator v1.0.0–1.1.0

- Первый релиз: генерация SDK из OpenAPI для TypeScript, Python, Go, Kotlin, Swift
- Загрузка спецификации по URL с дефолтным адресом Пачки

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

_17 марта 2026_

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

### CLI v2026.3.8

- Команда `pachca upgrade` — обновление CLI до последней версии
- Ошибки авторизации в JSON-формате, баннер обновления при ошибках

### 16 марта 2026

### CLI v2026.3.7

- Загрузка файла одной командой `pachca upload` (подпись + загрузка автоматически)
- Обязательный флаг `--direct-url` для прямых запросов без авторизации

### 15 марта 2026

### CLI v2026.3.6

- Топик `thread` переименован в `threads`

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

_14 марта 2026_

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

- [Боты](/guides/bots) — создание и настройка ботов
- [Кнопки](/guides/buttons) — интерактивные кнопки в сообщениях
- [Входящие вебхуки](/guides/incoming-webhooks) — отправка сообщений через URL
- [Разворачивание ссылок](/guides/link-previews) — unfurl-боты для предпросмотра ссылок
- [Albato](/guides/albato) и [n8n](/guides/n8n/overview) — интеграции с no-code платформами

Документация реструктурирована: [Быстрый старт](/guides/quickstart), [Пагинация](/api/pagination), [Загрузка файлов](/api/file-uploads), [Запросы и ответы](/api/requests-responses) вынесены в отдельные страницы, раздел форм разбит на три страницы.

В вебхук [Отправка ссылок](/guides/link-previews#vebhuk-o-ssylke) добавлено поле `user_id` — идентификатор отправителя сообщения со ссылкой.

### SDK v1.0.1

- Регенерация SDK после реструктуризации документации

### 07 марта 2026

### CLI v2026.3.5

- Сценарии переписаны на CLI-примеры с подсказками
- Пример «Форма заявки/запроса»

### Сценарии

_05 марта 2026_

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

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

### CLI v2026.3.4

- Переменная `PACHCA_API_URL` для кастомного base URL
- Исправлено выравнивание в уведомлении о доступном обновлении

### 04 марта 2026

### CLI v2026.3.1–2026.3.3

- Все флаги в kebab-case, boolean-флаги с `--no-` префиксом
- Структурированные ошибки валидации с hint-подсказками
- Команда `doctor` — диагностика окружения
- Команда `introspect` — метаинформация о командах для агентов
- Команда `api` — прямые HTTP-запросы с `-f/-F`, `--input`, `--query`
- Команда `guide` — поиск по сценариям использования API
- Описания команд и топиков переведены на русский язык

### SDK v1.0.0

- Первый релиз SDK: TypeScript, Python, Go, Kotlin, Swift
- Типизированные клиенты с автопагинацией для каждого языка

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

_03 марта 2026_

Появился раздел документации [CLI](/guides/cli) — все методы API доступны как команды в терминале.