Последние обновления

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

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

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

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

• PUTЗагрузка аватара
• DELETEУдаление аватара
• PUTЗагрузка аватара сотрудника
• DELETEУдаление аватара сотрудника

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

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

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

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

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

Во все методы, требующие оплаченного тарифа, добавлен ответ 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 вместо опционального.

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

• POSTОтправить сообщение
• POSTНовый сотрудник
• PUTРедактирование сотрудника
• POSTЗакрепление сообщения
• GETЖурнал аудита событий

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

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

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

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

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

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

• POSTЗакрепление сообщения
• POSTОтправить сообщение
• GETИнформация о сообщении
• GETСписок сообщений чата

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

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

• Боты — создание и настройка ботов
• Кнопки — интерактивные кнопки в сообщениях
• Входящие вебхуки — отправка сообщений через URL
• Разворачивание ссылок — unfurl-боты для предпросмотра ссылок
• Albato и n8n — интеграции с no-code платформами

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

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

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

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

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

Были добавлены новые методы для полнотекстового поиска по сотрудникам, чатам и сообщениям:

• GETПоиск сотрудников
• GETПоиск чатов
• GETПоиск сообщений

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

В модель статуса добавлено новое поле away_message — сообщение при режиме «Нет на месте», которое отображается в профиле пользователя и при отправке ему личного сообщения или упоминании в чате.

В модель сообщения добавлены поля root_chat_id (идентификатор корневого чата для сообщений в тредах), changed_at (дата редактирования) и deleted_at (дата удаления).

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

• PUTНовый статус
• PUTНовый статус сотрудника
• POSTОтправить сообщение
• GETИнформация о сообщении
• PUTРедактирование сообщения
• GETСписок сообщений чата

В модель статуса добавлено новое поле is_away — режим «Нет на месте». Также добавлены новые методы для администраторов и владельцев, позволяющие просматривать, устанавливать и удалять статус любого сотрудника.

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

• GETСтатус сотрудника
• PUTНовый статус сотрудника
• DELETEУдаление статуса сотрудника

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

• GETТекущий статус
• PUTНовый статус

Напоминания теперь можно привязывать к чатам, в которых вы состоите — при создании напоминания укажите chat_id. В ответе всех методов напоминаний добавлено новое поле chat_id.

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

• POSTНовое напоминание
• GETСписок напоминаний
• GETИнформация о напоминании
• PUTРедактирование напоминания

Добавлена поддержка OAuth 2.0 скоупов — теперь каждый метод API указывает, какой скоуп токена необходим для его вызова. Скоупы отображаются на странице каждого метода в виде бейджа.

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

• GETИнформация о токене — получение информации о текущем OAuth токене, включая список скоупов, дату создания и последнего использования

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

Добавлен онлайн-клиент Scalar — тестирование всех методов API прямо в браузере без установки. Также доступна готовая коллекция запросов для Postman и Bruno с примерами и настроенной авторизацией.

Подробнее в разделе Тестирование API.

Появился новый раздел документации — AI агенты. В нём описано, как Пачка работает с AI-агентами, и собраны все ресурсы для интеграции.

Что нового:

• Agent Skills — описание API в формате skill-файлов для подключения к 40+ AI-агентам (Claude Code, Cursor, Codex, Windsurf и др.)
• Context7 MCP — документация Пачки доступна через MCP-сервер Context7 для агентов с поддержкой MCP
• OpenAPI-спецификация — спецификация для кодогенерации и автоматического создания клиентов

В журнал аудита событий добавлены новые типы событий для отслеживания создания сообщений, тредов и работы с реакциями:

• message_created — сообщение создано
• thread_created — тред создан
• reaction_created — реакция добавлена
• reaction_deleted — реакция удалена

Полный список типов событий доступен на странице Журнал аудита событий.

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

• GETЖурнал аудита событий

В журнал аудита событий были добавлены новые типы событий:

• user_2fa_fail — неудачная попытка двухфакторной аутентификации
• user_2fa_success — успешная двухфакторная аутентификация
• access_token_created — создан новый токен доступа
• access_token_updated — токен доступа обновлен
• access_token_destroy — токен доступа удален
• kms_encrypt — данные зашифрованы
• kms_decrypt — данные расшифрованы

Полный список типов событий доступен на странице Журнал аудита событий.

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

• GETЖурнал аудита событий

Во все методы получения списков была добавлена поддержка курсорной пагинации. Теперь вы можете использовать параметры cursor и limit для постраничного получения данных. Прежние параметры page и per продолжают работать для обратной совместимости.

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

• GETСписок тегов сотрудников
• GETСписок сотрудников тега
• GETСписок сообщений
• GETСписок прочитавших сообщение
• GETСписок реакций на сообщение
• GETСписок напоминаний

Метод POSTДобавление пользователей теперь поддерживает работу с тредами. Вы можете передать chat_id треда в качестве идентификатора чата, чтобы добавить участников в тред.

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

• GETСписок напоминаний
• GETИнформация о напоминании
• PUTРедактирование напоминания
• DELETEУдаление напоминания

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

В запрос списка тегов было добавлено новое поле:

• names

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

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

• GETСписок тегов сотрудников

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

• GETИстория событий
• DELETEУдаление события

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

В запрос списка сотрудников были добавлены новые поля:

• limit
• cursor

Теперь этот запрос поддерживает курсорную пагинацию. Если вы использовали этот метод раньше — вам необходимо перейти на новый тип пагинации (постраничная пагинация будет поддерживаться ещё некоторое время).

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

• GETСписок сотрудников

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

• PUTРедактирование бота

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

Мы следим за стабильностью API, поэтому есть лимиты на запросы и мы вынуждены их менять, при этом оставляя их комфортными, чтобы вам хватало для любых задач.

С обновленными лимитами на запросы и входящие вебхуки вы можете ознакомиться на странице Ошибки и лимиты.

В запрос списка чатов были добавлены новые поля:

• limit
• cursor

Теперь этот запрос поддерживает курсорную пагинацию. Если вы использовали этот метод раньше — вам необходимо перейти на новый тип пагинации (постраничная пагинация будет поддерживаться ещё некоторое время).

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

• GETСписок чатов

Был добавлен новый раздел, посвященный работе с формами. Вы можете ознакомиться со следующими страницами:

• Формы
• POSTОткрытие представления
• Получение результатов

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

В объект user было добавлено новое поле:

• sso

Это поле позволяет узнать, используется ли для авторизации пользователя Single Sign-On.

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

• POSTНовый сотрудник
• GETИнформация о сотруднике
• GETСписок сотрудников
• PUTРедактирование сотрудника
• GETСписок сотрудников тега
• GETСписок участников чата

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

• GETСписок участников чата

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

В исходящий вебхук о добавлении и удалении реакций было добавлено новое поле:

• name

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

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

• GETСписок событий аудита

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

Мы добавили новые возможности для работы с документацией API, которые значительно упростят взаимодействие с AI-ассистентами:

• Markdown-версия документации — теперь вы можете получить markdown-версию любой страницы документации, добавив .md к URL или нажав на кнопку «Скопировать как .md» в правом верхнем углу страницы.
• Полная документация в удобных форматах — на главной странице документации вы найдете прямые ссылки для скачивания полной документации:
  • llms.txt — краткая версия в формате markdown с сохранением ссылок
  • llms-full.txt — полная версия в едином файле с оглавлением

В запрос списка сообщений было добавлено новое поле:

• sort[{field}]

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

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

• GETСписок сообщений чата (/chats/{id}/messages)

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

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

С помощью этого метода Владелец пространства на тарифе «Корпорация» может запросить экспорт сообщений пространства в формате JSON файлов, упакованных в zip архив.

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

• GETИнформация о профиле

С помощью этого метода вы можете получить всю информацию о пользователе, access_token которого используется.

В поле sort[{field}] была добавлена поддержка нового значения:

• last_message_at

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

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

• GETСписок чатов

В объект message были добавлены новые поля:

• display_avatar_url
• display_name

Эти поля позволяют указать специальную аватарку и имя отправителя для сообщения. Доступно только при отправке и редактировании сообщения с использованием access_token бота.

В объекты файлов поля message.files были добавлены новые поля:

• width
• height

Эти поля позволяют указать ширину и высоту прикладываемого к сообщению изображения для корректного отображения предпросмотра.

В объект message было добавлено новое поле:

• url

Это поле позволяет получить прямую ссылку на сообщение.

В объект user было добавлено новое поле:

• last_activity_at

Это поле позволяет получить дату последней активности пользователя.