Документация ботов под раздел «Интеграции» и публичный API ботов

[lookinway]

Что изменилось

• Боты — обзор стал точкой входа с таблицей «задача → что включить». Создание бота вынесено отдельно, добавлены страницы «Настройки бота», «Токены бота», «Первый диалог с ботом» и «Витрина». Правило «Кто может добавлять бота в чаты» описано для всех способов добавления, включая API.
• Авторизация от имени сотрудника — новый раздел: обзор, чек-лист запуска (что должно быть включено у бота на каждом шаге), настройка авторизации на вкладке «OAuth» и её отключение, те же настройки через API, получение токена с PKCE и примером на TypeScript, согласие и отзыв доступа.
• Сверка с продуктом — страницы ботов и авторизации сверены с кодом бэкенда и веба: доступ к API по умолчанию, адреса возврата, набор прав при включении, событие «Нажатие кнопок» для кнопок и форм, доступ к новому боту, поля API.
• Публичный API ботов — пустой бот (empty), авторизация от имени сотрудника (oauth_client, выключение через null) и страница в витрине (promo) при создании и редактировании, полный объект бота в ответах вместе с правами на управление ботом (permissions). Новые методы: токены бота (список, выпуск, изменение, перевыпуск, удаление), каталог прав бота и ротация секрета клиента. Методы самого бота (/bot/webhook, /bot/recreate_token) отвечают своей моделью. single_chat меняется и при редактировании.
• Прочее в API — отметка чата непрочитанным и скоуп chats:mark_unread, пять событий аудита про токены и авторизацию бота с моделями деталей.
• Ответ в треде — описания parent_message_id и идентификаторов треда переписаны. Ответ с цитатой работает в любом чате, в том числе в треде. id треда нужен, чтобы написать в тред, а chat_id — чтобы прочитать его сообщения. Прежний текст агенты понимали как запрет отвечать в треде.
• Права и роли — мульти-гость в API: какие права у него есть и что он видит через методы сотрудников, чатов, тегов, напоминаний и упоминаний. Кто управляет токенами, авторизацией и удалением бота. Настройка «Кто может создавать персональные токены», прежде «Кто может работать с API», описана как выдача нового доступа: выданные токены продолжают работать. Скриншот настройки снят с новой карточки из pachca/web#3927.
• Остальные гайды — пути в интерфейсе, токены и скриншоты под раздел «Интеграции»: вебхуки, разворачивание ссылок, кнопки, формы, CLI, n8n, SDK, быстрый старт, авторизация, сценарии для агентов. Во входящих вебхуках описаны допустимые форматы тела запроса.
• CLI — вход через браузер передаёт имя устройства, чтобы вход узнавался в списке токенов CLI. После ответа 401 CLI подсказывает войти заново или сохранить новый токен, с именем профиля в команде. Новые команды для токенов, каталога прав и секрета бота, chats mark-unread. bots update принимает обновление одними --oauth-client или --promo.
• Swift SDK — манифест пакета собирается без предупреждений.

Выпуски

CLI 2026.10.0, n8n 2.1.4, SDK 1.5.0 и запись в «Обновлениях» от 1 октября.

Перед влитием

• Вливать после тестов на бете, перед снятием флага раздела «Интеграции».
• Права на управление ботом в ответе (permissions) сверены с бэкендом, поле обязательное.
• Проверка ника бота в методах сотрудника сверена с бэкендом.
• Прогнать аудит бэкенда от 28.09 до дня влития. По 01.10 пройден, расхождений нет.
• Название и подписи настройки «Кто может создавать персональные токены» и скриншот сверены с вебом после влития.
• Описание задач веба, сделанных до выхода из беты, сверено с влитым кодом: свои токены при закрытом доступе, витрина для мульти-гостей, выбор прав при включении авторизации, пустой обзор ботов.
• Подписи вкладки «OAuth» и удаление OAuth-клиента сверены с интерфейсом.
• Даты выпусков выставлены на 01.10, запись в «Обновлениях» переименована, CLI — 2026.10.0. Если влитие сдвинется на другой день, даты нужно поменять.

Локально проходят npx turbo build, npx turbo check и bun run sdk:build.