Пачка API: POST /messages — Новое сообщение

Отправляет сообщение в беседу или канал, личное сообщение сотруднику или комментарий в тред.

Параметр	Где	Тип	Обяз.	Описание
`message.entity_type`	body	string	нет	discussion (беседа или канал, по умолчанию), thread (тред), user (пользователь)
`message.entity_id`	body	integer	да	ID беседы/канала, треда или сотрудника
`message.content`	body	string	да	Текст; упоминания @nickname или <@user_id>
`message.files`	body	array	нет	Прикрепляемые файлы
`message.buttons`	body	array	нет	Строки кнопок: до 100 кнопок, до 8 в строке
`message.parent_message_id`	body	integer	нет	Ответ на сообщение в ленте чата (не в треде)
`message.display_avatar_url`	body	string	нет	Аватар отправителя для этого сообщения (только токен бота)
`message.display_name`	body	string	нет	Имя отправителя для этого сообщения (только токен бота)
`message.skip_invite_mentions`	body	boolean	нет	Не добавлять упомянутых в тред
`link_preview`	body	boolean	нет	Показывать предпросмотр первой ссылки

Базовые 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