# Пачка — руководства

> Индекс раздела «Руководства»: гайды по интеграции (боты, вебхуки, формы, SDK, CLI, n8n, MCP, AI-агенты). Каждая ссылка ведёт на `.md` (или добавь `Accept: text/markdown`).

[Родительский индекс](https://dev.pachca.com/llms.txt)

- [Быстрый старт](https://dev.pachca.com/guides/quickstart.md): Первое сообщение через API Пачки за 5 минут: токен бота или персональный токен, проверка авторизации, идентификатор чата и отправка сообщения через cURL, CLI или SDK
- [AI-агенты, Обзор](https://dev.pachca.com/guides/ai-agents/overview.md): AI-агенты и Пачка: доступ к Пачке через MCP-сервер или CLI, правила методов в описаниях инструментов MCP, скиллы как знание о том, как связать вызовы в задачу, что можно поручить агенту, как подключить сервер и поставить скиллы, API и SDK, бот в Пачке, n8n, токен и доступ агентов в пространстве, Пачка как среда для агентов (треды, черновики, оформленные ответы), документация для агента (llms.txt, Markdown-версии страниц, OpenAPI)
- [AI-агенты, Взаимодействие с агентом](https://dev.pachca.com/guides/ai-agents/interaction.md): Как устроен AI-агент в Пачке: агент — это бот, которого зовут по нику в чате или треде либо пишут ему в личные сообщения. Как агент собирает контекст треда, показывает, что работает, реакцией agent-thinking с таймером и отвечает
- [AI-агенты, Агент следит за тредом](https://dev.pachca.com/guides/ai-agents/watch-thread.md): Как попросить AI-агента в программе на своём компьютере следить за тредом Пачки и отвечать в нём: скилл pachca-watch-thread, какие ссылки подходят, вход в CLI, как агент узнаёт о новых сообщениях в Claude Code, Cursor, VS Code, GitHub Copilot CLI и Codex, правила для агента, ограничения и когда лучше сделать бота
- [AI-агенты, Черновик вместо отправки](https://dev.pachca.com/guides/ai-agents/drafts.md): Агент готовит сообщение черновиком, а отправляет сотрудник: зачем это нужно, почему работает только личным токеном, один черновик на чат и чем от черновика отличается отложенное сообщение
- [AI-агенты, Оформление ответов](https://dev.pachca.com/guides/ai-agents/markdown.md): Агент присылает отчёты, ревью и сводки в Markdown — Пачка рендерит .md оформленной карточкой: таблицы, чек-листы, подсветка кода, diff, диаграммы Mermaid. Файлы .html, .txt и .json открываются просмотром прямо в переписке, размеры файлов для просмотра
- [AI-агенты, Скиллы](https://dev.pachca.com/guides/ai-agents/skills.md): Девять скиллов Пачки подробно: подключение и права, сообщения и правила переписки, поиск, пересказ и разбор треда и напоминания, слежение за тредом, администрирование, боты и интеграции, AI-агент в Пачке, работа от имени сотрудника и API в скриптах. По каким просьбам агент берёт скилл и что из него знает, установка одной командой в Claude Code, Codex, Cursor и другие агенты, вручную, в Yandex AI Studio и GigaChat, вызов скилла и как устроены скиллы
- [AI-агенты, Плагин](https://dev.pachca.com/guides/ai-agents/plugin.md): Плагин «Пачка» — необязательный способ поставить MCP-сервер и скиллы одной установкой в Claude Code, приложение Claude, Codex, VS Code с GitHub Copilot и Cursor: что он даёт сверх обычного подключения (обновление скиллов, приложение Claude, установка для всей организации), установка, вход в Пачку и проверка в каждой программе
- [Треды](https://dev.pachca.com/guides/threads.md): Треды в Пачке для разработчиков: сквозные и самостоятельные треды как уникальная особенность, создание у сообщения (POST /messages/{id}/thread) и без привязки к сообщению (POST /threads), отправка комментариев, добавление и исключение участников, кто видит тред, права в треде через API и в интерфейсе, владелец самостоятельного треда, видимость родительского чата, нюансы API и поля Message.thread/root_chat_id
- [Теги](https://dev.pachca.com/guides/tags.md): Теги в Пачке: тег как состав беседы или канала с автоматической синхронизацией участников, упоминание тега в сообщении и в треде, поле list_tags у сотрудника, правила названий, права и события журнала аудита
- [MCP, Обзор](https://dev.pachca.com/guides/mcp/overview.md): MCP-сервер Пачки: что это и зачем, адрес https://mcp.pachca.com/mcp, что можно попросить агента, как подключить программу вместе со скиллами, как проходит вызов инструмента и почему права те же, что в API, какие токены принимает сервер, тарифы, подтверждение действий и безопасные режимы, какие данные уходят поставщику модели, защита от внедрённых инструкций, что видят коллеги и администратор, пределы
- [MCP, Подключение](https://dev.pachca.com/guides/mcp/connect.md): Как подключить MCP-сервер Пачки за четыре шага: сервер по адресу, вход, скиллы, проверка. Плагин «Пачка» как вариант одной установкой, кто может подключить, сравнение способов, вход через браузер с экраном согласия в Claude Code, Claude, VS Code, GitHub Copilot, Codex и приложении ChatGPT на компьютере, персональный токен в заголовке для Cursor, SourceCraft Code Assistant, Qwen Code, GigaCode CLI, OpenCode, Devin Desktop (бывший Windsurf), Cline, Kilo Code, Gemini CLI и программ с локальными серверами, переменная окружения в macOS, Linux и Windows, проверка подключения, запуск с токеном там, где входить некому, агент только для чтения, несколько пространств, токен бота для агентов в Yandex AI Studio и на GigaChat, список «Авторизации», отзыв доступа и разбор отказов
- [MCP, Инструменты](https://dev.pachca.com/guides/mcp/tools.md): Все инструменты MCP-сервера Пачки: инструмент на каждый метод публичного API, кроме служебных, какой метод вызывает каждый, кому он доступен, пометки чтения и изменения, как агент отправляет файл, набор по роли, тарифу и типу токена, манифест @pachca/mcp-manifest
- [Боты, Обзор](https://dev.pachca.com/guides/bots/overview.md): Боты в Пачке: сервисный участник пространства, на котором строятся интеграции. Что умеет бот, с чего начать под вашу задачу, где бот находится в интерфейсе, вкладка «Управление» и подмена имени отправителя
- [Боты, Первый бот](https://dev.pachca.com/guides/bots/first-bot.md): Первый бот в Пачке по шагам: создать бота и токен с нужными правами, добавить бота в чат, отправить сообщение через API на cURL, TypeScript или Python, включить исходящий вебхук и ответить сотруднику в тред из обработчика с проверкой подписи, а на своей машине получать события потоком
- [Боты, Общение с ботом](https://dev.pachca.com/guides/bots/conversations.md): Как бот в Пачке общается с сотрудниками в личных сообщениях, беседах, каналах и тредах: что настроить, как бот узнаёт о сообщениях, когда отвечать, как разбирать команды, куда отвечать и как прочитать контекст разговора
- [Боты, Интерактивный бот](https://dev.pachca.com/guides/bots/interactive.md): Пошаговое руководство с кодом на TypeScript и Python: бот принимает команду в чате, отвечает тредом с кнопкой, по нажатию открывает форму, принимает её отправку, пишет итог в чат и меняет кнопки в сообщении
- [Боты, Создание бота](https://dev.pachca.com/guides/bots/setup.md): Как создать бота в Пачке: в разделе «Интеграции» или методом API, что настроить сразу после создания и жизненный цикл бота через API
- [Боты, Настройки бота](https://dev.pachca.com/guides/bots/settings.md): Вкладка «Основное» в карточке бота: профиль, ограничение одним чатом, публичный бот, кто может добавлять бота в чаты и редактировать его настройки, бот в тегах, удаление бота и те же настройки через API
- [Боты, Токены бота](https://dev.pachca.com/guides/bots/tokens.md): Токены бота в Пачке: несколько токенов со своими правами, выпуск, перевыпуск и удаление на вкладке «API», права самоуправления бота, токены через API и что делать, если токен утёк
- [Боты, Доступы к чатам и сообщениям](https://dev.pachca.com/guides/bots/access.md): Где бот в Пачке видит сообщения: открытые беседы и каналы, чаты, куда его добавили, треды и личные сообщения. Как бота добавляют в чаты и зовут в тред, кто может написать ему в личные сообщения и где бота находят в поиске
- [Боты, Витрина](https://dev.pachca.com/guides/bots/showcase.md): Витрина ботов в Пачке: каталог пространства на вкладке «Обзор» — карточки опубликованных ботов с авторизацией и список публичных ботов. Как опубликовать бота, что на его странице и как сотрудник подключает бота сам
- [Боты, Готовые примеры реализации](https://dev.pachca.com/guides/bots/examples.md): Примеры ботов для Пачки: пошаговые руководства «Первый бот» и «Интерактивный бот», открытые Welcome Bot для приветствия новых сотрудников, Review Bot для интеграции с GitHub Pull Requests и Unfurl-бот для предпросмотра ссылок
- [Входящие вебхуки](https://dev.pachca.com/guides/incoming-webhooks.md): Входящие вебхуки в Пачке: сообщения от имени бота одним HTTP POST без токена, шаблоны Liquid и Mustache, готовые шаблоны для Alertmanager, Zabbix, Sentry, Uptime Kuma, GitHub, amoCRM и Битрикс24
- [Исходящие вебхуки, Обзор](https://dev.pachca.com/guides/webhook/overview.md): Исходящие вебхуки в Пачке: что это, как включить и какие настройки доступны на вкладке «Исходящий вебхук» в карточке бота
- [Исходящие вебхуки, Настройка и типы событий](https://dev.pachca.com/guides/webhook/events.md): Настройки исходящих вебхуков Пачки и список доступных типов событий: сообщения, реакции, нажатия кнопок, заполнение форм, изменение участников чатов и пространства, отправка ссылок
- [Исходящие вебхуки, Безопасность и обработчик](https://dev.pachca.com/guides/webhook/handler.md): Безопасность исходящих вебхуков Пачки: подпись HMAC-SHA256 и её сравнение за постоянное время, проверка timestamp, IP-адрес отправителя, сроки ответа на события, кнопки и формы, примеры обработчика на TypeScript и Python, идемпотентная обработка и доставка
- [Исходящие вебхуки, Разработка и запуск обработчика](https://dev.pachca.com/guides/webhook/deploy.md): Как разработать и запустить обработчик исходящих вебхуков Пачки: отдельный бот для разработки, поток событий без публичного адреса, туннель через ngrok и Cloudflare Tunnel, чек-лист перед запуском в работу, serverless и холодный старт при коротких сроках ответа
- [Исходящие вебхуки, Поллинг](https://dev.pachca.com/guides/webhook/polling.md): Поллинг исходящих вебхуков Пачки через SDK: получение новых событий без публичного webhook URL, поток событий в реальном времени по ссылке (Server-Sent Events) с примером подключения и сменой ссылки, дедупликация доставок и пример воркера для локальной разработки
- [Кнопки в сообщениях](https://dev.pachca.com/guides/buttons.md): Интерактивные кнопки в сообщениях ботов Пачки: ссылки и действия, обработка нажатий через исходящий вебхук, открытие форм и переходы на внешние ресурсы
- [Формы, Обзор](https://dev.pachca.com/guides/forms/overview.md): Модальные формы ботов в Пачке: поля ввода, списки, даты, время и файлы, жизненный цикл представления от нажатия кнопки до валидации и закрытия окна, что нужно боту и куда писать результат
- [Формы, Блоки представления](https://dev.pachca.com/guides/forms/blocks.md): 11 типов блоков представлений в формах ботов Пачки: заголовок, обычный и форматированный текст, разделитель, поле ввода, выпадающий список, радиокнопки, чекбоксы, дата, время и загрузка файлов. До 100 блоков в одном представлении
- [Формы, Обработка форм](https://dev.pachca.com/guides/forms/handling.md): Обработка форм в Пачке: открытие представлений по trigger_id (3 секунды), приём результатов через исходящий вебхук или журнал событий, валидация полей и отображение ошибок
- [Разворачивание ссылок](https://dev.pachca.com/guides/link-previews.md): Unfurl в Пачке: превью ссылок внутренних сервисов прямо в чатах — бот ловит URL, подтягивает заголовок, описание, изображение и отправляет обратно в чат
- [Авторизация от имени сотрудника, Обзор](https://dev.pachca.com/guides/oauth/overview.md): Авторизация от имени сотрудника: сотрудник выдаёт боту свои права, и бот делает автоматизации в Пачке и связывает её с другими сервисами от его имени. Как это выглядит для сотрудника, где настраивается у бота и какие ограничения действуют
- [Авторизация от имени сотрудника, Чек-лист запуска](https://dev.pachca.com/guides/oauth/checklist.md): Что должно быть включено у бота, чтобы авторизация от имени сотрудника заработала: сотрудник может написать боту, бот узнаёт о сообщении и отвечает кнопкой, вкладка «OAuth» настроена. Что видно, когда чего-то не хватает
- [Авторизация от имени сотрудника, Настройка авторизации](https://dev.pachca.com/guides/oauth/setup.md): Как включить у бота авторизацию от имени сотрудника: где хранится секрет, адреса возврата, client_id и client_secret, запрашиваемый доступ, страница на витрине, отключение и те же настройки через API
- [Авторизация от имени сотрудника, Получение токена](https://dev.pachca.com/guides/oauth/flow.md): Как бот получает токен сотрудника по шагам: ссылка авторизации с state и PKCE, кнопка в сообщении бота, возврат с кодом, обмен кода на токен, проверка сотрудника и обработка отказов. Пример на curl и TypeScript с SDK
- [Авторизация от имени сотрудника, Согласие и отзыв](https://dev.pachca.com/guides/oauth/consent.md): Экран согласия при авторизации бота: что видит сотрудник, кто не может выдать доступ, повторная авторизация, список «Авторизации» на странице «API», отзыв доступа и что после него происходит с ботом
- [Агенты и MCP в пространстве](https://dev.pachca.com/guides/agents-access.md): Для владельца и администраторов: почему у MCP нет отдельного выключателя и подключение агентов решают две настройки доступа к API, что агент видит с персональным токеном и токеном бота, где увидеть и отозвать подключения, как закрыть выданное, журнал аудита, данные для поставщика модели и пометка сообщений агента
- [Экспорт сообщений](https://dev.pachca.com/guides/export.md): Экспорт сообщений из чатов Пачки: запрос архива за период до 45 дней, скачивание JSON-файлов, структура архива и ограничения по чатам. Тариф «Корпорация»
- [DLP-система](https://dev.pachca.com/guides/dlp.md): DLP-система Пачки для защиты от утечек конфиденциальной информации: правила с условиями и действиями, приоритеты, контексты применения. Тариф «Корпорация»
- [Шифрование и безопасный контур](https://dev.pachca.com/guides/data-protection.md): Две настройки безопасности пространства Пачки и что они меняют для интеграции: безопасный контур по списку IP, продвинутое шифрование на своём ключе KMS, ссылки на вложения через API, отказы confidential_download_denied и decryption_failed. Тариф «Корпорация»
- [Журнал аудита событий](https://dev.pachca.com/guides/audit-events.md): Журнал аудита событий Пачки для команд безопасности: структура записи, типы событий и состав деталей, фильтры и пагинация, хранение. Тариф «Корпорация»
- [Права и роли](https://dev.pachca.com/guides/permissions.md): Как устроены права в API Пачки: роль в пространстве (Владелец, Администратор, Сотрудник, гости) и роль в чате (Создатель, Админ, Редактор, Участник, Подписчик), единственная точка их связи, перевод в гости и что он делает с токенами, права в тредах, видимость закрытых бесед и каналов, инвентаризация чатов и ботов пространства, управление чужими чатами, чаты уволенных сотрудников и готовые наборы прав под типовые задачи
- [Форматирование текста](https://dev.pachca.com/guides/markdown.md): Какой markdown понимает Пачка в тексте сообщений, входящих вебхуках и блоках форм: жирный, курсив, зачёркнутый, ссылки, строчный код и блоки кода. Строка с решёткой становится жирной, а списки, цитаты и таблицы остаются обычным текстом.
- [CLI, Обзор](https://dev.pachca.com/guides/cli/overview.md): Официальный CLI для Pachca API: все методы API как команды терминала с автодополнением, типизированными флагами и интерактивными подсказками, AI-агент с CLI и скиллы. Node.js 20+
- [CLI, Установка](https://dev.pachca.com/guides/cli/installation.md): Установка @pachca/cli: глобально через npm или без установки через npx (для агентов и CI). Автодополнение, настройки по умолчанию, диагностика и обновление.
- [CLI, Авторизация](https://dev.pachca.com/guides/cli/authentication.md): Авторизация Pachca CLI: вход через браузер и вход готовым токеном, список «Токены CLI» в Пачке, хранение токена, профили, выход, приоритет источников токена, headless-режим для CI и агентов.
- [CLI, Вывод](https://dev.pachca.com/guides/cli/output.md): Форматы вывода Pachca CLI (table, json, yaml, csv), выбор колонок, плоский TSV-режим, пайпы и перенаправление, курсорная пагинация.
- [CLI, Флаги и скрипты](https://dev.pachca.com/guides/cli/scripting.md): Глобальные флаги Pachca CLI, сортировка, kebab-case, boolean-флаги, dry-run, деструктивные операции, exit codes, таксономия ошибок, переменные окружения, неинтерактивный режим.
- [CLI, Файлы](https://dev.pachca.com/guides/cli/files.md): Файлы в Pachca CLI: pachca upload получает подпись и загружает на S3 одной командой, pachca files get забирает вложения, у которых нет прямой ссылки.
- [CLI, Прямые запросы](https://dev.pachca.com/guides/cli/api-requests.md): Команда pachca api: прямые HTTP-запросы к любому методу (поля -f/-F, инлайн JSON, stdin) и встроенный справочник по API (ls, --describe, --spec, --docs) прямо в терминале, без сайта документации.
- [CLI, Команды](https://dev.pachca.com/guides/cli/commands.md): Справочник всех команд Pachca CLI: каждый метод API как команда, паттерн pachca [секция] [действие] [--флаги]. Параметры каждой команды — по клику.
- [SDK, Обзор](https://dev.pachca.com/guides/sdk/overview.md): Типизированные SDK для Pachca API на TypeScript, Python, Go, Kotlin, Swift и C#: автодополнение, retry и пагинация. Или свой клиент через OpenAPI-генератор
- [SDK, TypeScript](https://dev.pachca.com/guides/sdk/typescript.md): Типизированный клиент для Pachca API на TypeScript: Node.js 18+ или любое окружение с fetch. Автодополнение, автопагинация и retry. npm-пакет @pachca/sdk
- [SDK, Python](https://dev.pachca.com/guides/sdk/python.md): Асинхронный типизированный клиент для Pachca API на Python: httpx, type hints, dataclass-модели, автопагинация и retry. PyPI-пакет, требуется Python 3.10+
- [SDK, Go](https://dev.pachca.com/guides/sdk/go.md): Типизированный клиент для Pachca API на Go: синхронный, с context.Context, автопагинацией и обработкой retry. Установка через go get, требуется Go 1.24+
- [SDK, Kotlin](https://dev.pachca.com/guides/sdk/kotlin.md): Типизированный клиент для Pachca API на Kotlin: Ktor с корутинами, kotlinx.serialization и встроенным retry. JitPack, требуется Kotlin 2.2+ и Java 11+
- [SDK, Swift](https://dev.pachca.com/guides/sdk/swift.md): Типизированный клиент для Pachca API на Swift: URLSession, async throws, Codable и встроенный retry. Swift Package, Swift 5.9+, macOS 13+ или iOS 16+
- [SDK, C#](https://dev.pachca.com/guides/sdk/csharp.md): Типизированный клиент для Pachca API на C#: .NET 8+ с async/await, CancellationToken, автопагинацией и обработкой retry. NuGet-пакет Pachca.Sdk
- [n8n, Обзор](https://dev.pachca.com/guides/n8n/overview.md): Расширение Пачки для n8n со статусом verified by n8n: 19 ресурсов, триггер событий и AI-агент. Визуальные workflow без кода для CRM, CI/CD и уведомлений
- [n8n, Начало работы](https://dev.pachca.com/guides/n8n/setup.md): Установка расширения Пачки для n8n из официальной витрины: верифицированная нода, установка через Nodes panel, n8n Cloud и self-hosted, настройка Credentials и первый workflow
- [n8n, Ресурсы и операции](https://dev.pachca.com/guides/n8n/resources.md): 19 ресурсов расширения Пачки для n8n и операции каждого из них: сообщения, важные сообщения, черновики, чаты, напоминания, сотрудники, боты, теги и вебхуки в модели Resource → Operation
- [n8n, Триггер](https://dev.pachca.com/guides/n8n/trigger.md): Узел Pachca Trigger для n8n: 19 событий Пачки и пункты вкладки «Исходящий вебхук», которые нужно отметить для каждого, автоматическая и ручная регистрация вебхука, проверка подписи и IP-фильтр
- [n8n, Тестирование](https://dev.pachca.com/guides/n8n/testing.md): Тестирование n8n-узлов Пачки: Listen for test event, Pin Data и Execute Step для экшн-узлов, защита webhook-слота бота и локальная разработка через туннель
- [n8n, Примеры workflow](https://dev.pachca.com/guides/n8n/workflows.md): Готовые сценарии автоматизации Пачки в n8n: уведомления из внешнего сервиса в нужный чат, приветствие сотрудника, пересылка сообщений, просроченные напоминания, согласование, мониторинг, заявка на отпуск и AI-ассистент
- [n8n, Продвинутые функции](https://dev.pachca.com/guides/n8n/advanced.md): Продвинутые функции n8n-расширения Пачки: загрузка файлов через S3, интерактивные кнопки, формы, AI-агент, разворачивание ссылок и журнал безопасности
- [n8n, Устранение ошибок](https://dev.pachca.com/guides/n8n/troubleshooting.md): Частые ошибки при работе с Пачкой в n8n: неверный Access Token, 401 Unauthorized, 403 Forbidden, 429 Too Many Requests и проблемы с доставкой вебхука
- [n8n, Миграция с v1](https://dev.pachca.com/guides/n8n/migration.md): Обновление расширения Пачки для n8n с v1 на v2: таблицы переименований, новые возможности и полная обратная совместимость для существующих workflow