Отвечайте в беседах Пачки от имени своего бота
Подключите Пачку к ИИ-агенту токеном бота: беседы, вложения, файлы и кнопки. Агент ответит в переписке от имени бота и пришлёт сводку по расписанию.
Как агент работает с Пачка
Агент работает через Bot API Пачки на api.pachca.com, а токен бота передаёт в заголовке Authorization как Bearer. Первым запросом он вызывает GET /profile: так проверяется, что токен живой, и видно, от чьего имени будут уходить сообщения. Дальше в работе только те беседы, куда бот добавлен: их переписка, вложения и нажатия кнопок.
Бот в Пачке является участником беседы, а не наблюдатель со стороны: пока его не добавили в разговор, ни одного сообщения оттуда агент не получит, и никакие права это не обойдут. Входящие приходят не опросом, а исходящим вебхуком: адрес регистрируется при подключении, Пачка присылает новые сообщения и нажатия кнопок сама, а каждый запрос подписывает HMAC-подписью в заголовке Pachca-Signature.
На запись это основной режим коннектора. Агент отвечает в переписке, загружает файлы, задаёт уточняющие вопросы кнопками и обрабатывает нажатие по trigger_id. Пока он думает, на исходном сообщении висит реакция: в Пачке нет индикатора набора, и она честно показывает, что запрос взят в работу. Редактировать и удалять он может только собственные сообщения.
Токен даёт права ровно этого бота и ничего сверх: личная переписка владельца профиля через него недоступна. Вложения и признак пересылки агент получает, дочитывая сообщение по его идентификатору: вебхук их не несёт. Частоту запросов он выдерживает сам: на чтение у Пачки свой лимит, поэтому болтовня беседы, не обращённая к боту, запроса не тратит. Файл он отправляет загрузкой в Пачку, а не ссылкой на сторонний диск, и называет, в какую беседу его положил.
Сценарии интеграции
Ответы в рабочей беседе
Агент получит сообщение из беседы Пачки через исходящий вебхук, разберёт вопрос и ответит от имени бота, не дожидаясь, пока вы освободитесь.
Разбор присланных файлов
Агент дочитает вложения сообщения по его идентификатору (накладную, выгрузку, скриншот отчёта) и ответит по их содержимому прямо в переписке.
Сводка по расписанию
Агент отправит утреннюю сводку в нужную беседу Пачки в согласованное время, чтобы цифры приходили сами, без напоминаний.
Кнопки и уточнения
Агент задаст вопрос кнопками, обработает нажатие по trigger_id и отредактирует своё сообщение, когда ответ уже не актуален.
Видно, что бот работает
Пока агент готовит ответ, он ставит реакцию на исходное сообщение и снимает её по завершении: в Пачке нет индикатора набора, и реакция заменяет его.
Файл прямо в беседу
Агент загрузит готовый отчёт или выгрузку в Пачку и назовёт, в какую беседу положил файл, вместо ссылки на сторонний диск.
Примеры: Пачка
Токен живой, GET /profile отвечает, беседа «Заявки» в списке доступных.
- Входящие идут исходящим вебхуком, подпись Pachca-Signature проверяю на каждом запросе
- Пока готовлю ответ, вешаю реакцию на исходное сообщение: индикатора набора в Пачке нет
- Отвечу только там, куда бота добавили: личная переписка через токен недоступна
Как подключить
Перед подключением
- Рабочее пространство Пачки с правами администратора
- Чат-бот, созданный в разделе интеграций, и его токен доступа
- Бот добавлен в те беседы, где он должен отвечать
- 1
Войдите администратором пространства
Нужны права администратора: чат-бота заводит только администратор пространства. У обычного участника раздела с интеграциями в настройках не будет.
- 2
Создайте бота в разделе «Чат-боты»
В настройках откройте «Интеграции» → «Чат-боты» и создайте бота: имя и аватар, под которыми он будет отвечать в беседах.
- 3
Скопируйте токен из карточки бота
Токен появляется в карточке бота сразу после создания, скопируйте строку целиком. Именно он даёт право писать в беседы от имени этого бота.
- 4
В «Исходящем webhook» скопируйте секрет
Во вкладке «Исходящий webhook» включите срабатывание на все сообщения, а не только на команды, поставьте «Игнорировать сообщения бота» и скопируйте Signing Secret.
Частые вопросы
Токеном бота. В настройках рабочего пространства откройте раздел интеграций, создайте чат-бота и скопируйте его токен доступа целиком. Подпись исходящих вебхуков включается там же, а её секрет можно указать вторым полем.
Сообщения и вложения тех бесед, куда добавлен бот, и данные самого бота. Переписку, в которой бота нет, он не читает.
Да, это основной сценарий: отправляет и редактирует сообщения, удаляет свои, загружает файлы, ставит реакции и отвечает на нажатия кнопок.
В Пачке нет индикатора набора для ботов. Реакция на исходном сообщении служит ближайшим честным эквивалентом: она появляется, когда запрос взят в работу, и снимается, когда ответ отправлен.