> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


# Взаимодействие с агентом

Как агент получает запрос, собирает контекст, действует и отвечает. Страница для разработчиков, которые строят интеграцию.

## Как это работает


  ### Шаг 1. Получение события

Агент получает события через [исходящий вебхук](/guides/webhook) — упоминание по имени, ответ в тред или личное сообщение боту.


  ### Шаг 2. Сбор контекста

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

- [Список сообщений чата](GET /messages) — история сообщений треда или чата
- [Информация о сообщении](GET /messages/{id}) — родительское сообщение треда
- [Информация о чате](GET /chats/{id}) — участники и тема чата


  ### Шаг 3. Выполнение действий

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

- [Новое сообщение](POST /messages) — отправить сообщение в канал или беседу
- [Новый тред](POST /messages/{id}/thread) — создать тред и ответить
- [Новое напоминание](POST /tasks) — создать задачу из контекста разговора
- [Новая реакция](POST /messages/{id}/reactions) — поставить реакцию-индикатор


  ### Шаг 4. Ответ

Результат агент отправляет обратно в тред или в личные сообщения и снимает реакцию-индикатор.

- [Новое сообщение](POST /messages) — отправить результат
- [Удаление реакции](DELETE /messages/{id}/reactions) — снять реакцию-индикатор


Полный формат событий и payload — в [гайде по исходящим вебхукам](/guides/webhook).

## Практические советы

- **Реакции как индикатор** — агент ставит реакцию при получении запроса и снимает по завершении. Пользователь сразу видит, что агент работает
- **Один бот — один агент** — создайте отдельного бота для каждого агента, чтобы разделить права и логику
- **Контекст из треда** — читайте историю треда перед ответом, а не только последнее сообщение. Так агент учитывает весь контекст разговора
- **Обработка ошибок** — если агент не может выполнить задачу, пусть он ответит в тред с пояснением, а не молчит. Прозрачность действий важнее идеального результата

## Реакция agent-thinking

Создайте [кастомную реакцию](https://pachca.com/help-center/features/kastomnye-reakcii) с именем `agent-thinking` и загрузите анимированную иконку. Когда агент ставит эту реакцию на сообщение, интерфейс Пачки автоматически показывает живой таймер вместо счётчика — пользователь видит, сколько секунд агент уже работает. Таймер отображается до 5 минут. При [добавлении реакции](POST /messages/{id}/reactions) передайте параметр `name` со значением `agent-thinking`.

![Реакция agent-thinking с таймером](/images/agent-thinking.gif)

*Таймер реакции agent-thinking*