Пачка API: GET /messages — Список сообщений чата

Сообщения приходят от новых к старым.

Параметр	Где	Тип	Обяз.	Описание
chat_id	query	integer	да	ID чата (беседа, канал, диалог или чат треда)
sort	query	string	нет	Поле сортировки
order	query	string	нет	Направление сортировки
limit	query	integer	нет	Количество записей за запрос
cursor	query	string	нет	Курсор из meta.paginate.next_page или meta.paginate.prev_page

Базовые URL

• Боевой: https://api.pachca.com/api/shared/v1

Авторизация

Тип: Bearer-токен

Токен передаётся в заголовке Authorization: Bearer <token>. Два типа токенов:

• Персональный — действует от имени пользователя и видит те же чаты, что он в интерфейсе. Выпускается в разделе «Автоматизации» > «API» (бессрочный, показывается один раз) или выдаётся при входе через CLI pachca auth login (живёт час и продлевается автоматически).
• Токен бота — действует от имени бота: все открытые каналы плюс закрытые чаты и треды, куда бот добавлен.

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

curl "https://api.pachca.com/api/shared/v1/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "message": {
    "entity_id": 334,
    "content": "Вчера мы продали 756 футболок (что на 10% больше, чем в прошлое воскресенье)"
  }
}'

Нюансы

• Ответы на создание оборачиваются в объект data; пагинация — курсорная, курсор в meta.paginate.next_page.
• Лимиты частоты возвращают 429 с текстом text/plain, а не JSON, и заголовком Retry-After — ждать нужно не меньше указанного.
• Превышение суточного предела сообщений в один чат приостанавливает отправку на час, и каждая попытка во время паузы удваивает её (до 24 часов).
• При частых 429 без паузы токен может быть заблокирован на час (порог около 22 000 отправок в час).
• 403 может прийти в двух видах: OAuthError с insufficient_scope (у токена нет скоупа) или ApiError (запрет бизнес-логики).
• Исходящие вебхуки подписываются HMAC-SHA256 от тела запроса в заголовке Pachca-Signature (ключ — Signing secret бота); поле webhook_timestamp стоит проверять на расхождение не больше минуты. IP Пачки: 37.200.70.177.
• Документация доступна для LLM: https://dev.pachca.com/llms.txt и llms-full.txt.

---

Если этого недостаточно — официальная документация: https://dev.pachca.com/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/pachca.md