# Пачка

Отвечайте в беседах Пачки от имени своего бота

Корпоративный мессенджер Пачка — агент отвечает в беседах и тредах от имени вашего бота, читает присланные файлы и отправляет свои

## Как агент работает с Пачка

Агент работает через Bot API Пачки на api.pachca.com, а токен бота передаёт в заголовке Authorization как Bearer. Первым запросом он вызывает GET /profile: так проверяется, что токен живой, и видно, от чьего имени будут уходить сообщения. Дальше в работе только те беседы, куда бот добавлен, — их переписка, вложения и нажатия кнопок.

Бот в Пачке — участник беседы, а не наблюдатель со стороны: пока его не добавили в разговор, ни одного сообщения оттуда агент не получит, и никакие права это не обойдут. Входящие приходят не опросом, а исходящим вебхуком: адрес регистрируется при подключении, Пачка присылает новые сообщения и нажатия кнопок сама, а каждый запрос подписывает HMAC-подписью в заголовке Pachca-Signature.

На запись это основной режим коннектора. Агент отвечает в переписке, загружает файлы, задаёт уточняющие вопросы кнопками и обрабатывает нажатие по trigger_id. Пока он думает, на исходном сообщении висит реакция — в Пачке нет индикатора набора, и она честно показывает, что запрос взят в работу. Редактировать и удалять он может только собственные сообщения.

Токен даёт права ровно этого бота и ничего сверх: личная переписка владельца профиля через него недоступна. Вложения агент забирает, дочитывая сообщение по его идентификатору, а частоту запросов выдерживает сам — на чтение у Пачки свой лимит, и лишний запрос на каждое сообщение агент не делает. Файл он отправляет загрузкой в Пачку, а не ссылкой на сторонний диск, и называет, в какую беседу его положил.

## Сценарии интеграции

### Ответы в рабочей беседе
Агент получит сообщение из беседы Пачки через исходящий вебхук, разберёт вопрос и ответит от имени бота, не дожидаясь, пока вы освободитесь.

### Разбор присланных файлов
Агент дочитает вложения сообщения по его идентификатору — накладную, выгрузку, скриншот отчёта — и ответит по их содержимому прямо в переписке.

### Сводка по расписанию
Агент отправит утреннюю сводку в нужную беседу Пачки в согласованное время, чтобы цифры приходили сами, без напоминаний.

### Кнопки и уточнения
Агент задаст вопрос кнопками, обработает нажатие по trigger_id и отредактирует своё сообщение, когда ответ уже не актуален.

### Видно, что бот работает
Пока агент готовит ответ, он ставит реакцию на исходное сообщение и снимает её по завершении — в Пачке нет индикатора набора, и реакция заменяет его.

### Файл прямо в беседу
Агент загрузит готовый отчёт или выгрузку в Пачку и назовёт, в какую беседу положил файл, — вместо ссылки на сторонний диск.

## Как подключить

**Перед подключением**

- Рабочее пространство Пачки с правами администратора
- Чат-бот, созданный в разделе интеграций, и его токен доступа
- Бот добавлен в те беседы, где он должен отвечать

### Откройте настройки рабочего пространства
Нужны права администратора: чат-бота заводит только администратор пространства. У обычного участника раздела с интеграциями в настройках не будет.

### Создайте бота в разделе «Чат-боты»
В настройках откройте «Интеграции» → «Чат-боты» и создайте бота: имя и аватар, под которыми он будет отвечать в беседах.

### Скопируйте токен доступа бота
Токен появляется в карточке бота сразу после создания — скопируйте строку целиком. Именно он даёт право писать в беседы от имени этого бота.

### Настройте исходящий webhook бота
Во вкладке «Исходящий webhook» включите срабатывание на все сообщения, а не только на команды, поставьте «Игнорировать сообщения бота» и скопируйте Signing Secret.

## Частые вопросы

### Как подключить Пачку?
Токеном бота. В настройках рабочего пространства откройте раздел интеграций, создайте чат-бота и скопируйте его токен доступа целиком. Подпись исходящих вебхуков включается там же — её секрет можно указать вторым полем.

### Что агент видит в Пачке?
Сообщения и вложения тех бесед, куда добавлен бот, и данные самого бота. Переписку, в которой бота нет, он не читает.

### Пишет ли агент в Пачку?
Да, это основной сценарий: отправляет и редактирует сообщения, удаляет свои, загружает файлы, ставит реакции и отвечает на нажатия кнопок.

### Почему бот ставит реакцию вместо «печатает…»?
В Пачке нет индикатора набора для ботов. Реакция на исходном сообщении — ближайший честный эквивалент: она появляется, когда запрос взят в работу, и снимается, когда ответ отправлен.

[Открыть Пачка](https://app.pachca.com)