Пачка API: Отправить уведомление в канал от бота

Сценарий из mcp-everything. Актуально на 2026-10-24.

Новые заказы, ошибки сервера, отчёты — в рабочий канал команды.

  1. Создай бота в разделе «Автоматизации» и возьми его токен; передавай в заголовке Authorization: Bearer . Добавь бота в нужный канал (или используй открытый канал).
  2. Узнай ID канала: GET /chats — у каждого чата есть id.
  3. Отправь сообщение: POST /messages с message.entity_id — ID канала и message.content — текстом. Можно добавить message.buttons (до 8 кнопок в строке) и подменить имя и аватар отправителя через display_name и display_avatar_url.
  4. Ответ приходит в объекте data с id сообщения. Чтобы обновить сообщение (например, статус процесса), вызови PUT /messages/{id}.
  5. Лимит — примерно 4 сообщения в секунду в один чат. При 429 ответ приходит текстом, а не JSON, с заголовком Retry-After — жди не меньше указанного.
curl -X POST https://api.pachca.com/api/shared/v1/messages \
  -H "Authorization: Bearer $PACHCA_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
        "message": {
          "entity_id": 334,
          "content": "Новый заказ №1042 на 15 000 ₽",
          "display_name": "Магазин",
          "buttons": [[{"text": "Открыть заказ", "url": "https://example.ru/admin/orders/1042"}]]
        }
      }'

Базовые URL

Авторизация

Тип: Bearer-токен

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

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

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% больше, чем в прошлое воскресенье)"
  }
}'

Методы сценария

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 нет Показывать предпросмотр первой ссылки

PUT /messages/{id} — Редактирование сообщения

Меняет текст, файлы и кнопки отправленного сообщения; в интерфейсе появится пометка о правке.

Параметр Где Тип Обяз. Описание
id path integer да ID сообщения
message.content body string нет Текст сообщения
message.files body array нет Файлы
message.buttons body array нет Кнопки

GET /chats — Список чатов

По умолчанию — беседы, каналы и личные переписки владельца токена; с availability=public — все открытые.

Параметр Где Тип Обяз. Описание
availability query string нет Выборка чатов по доступности
archived query boolean нет Добавить архивные чаты
personal query boolean нет Только личные или только групповые
last_message_at_after query string нет Последнее сообщение позже даты (ISO-8601)
last_message_at_before query string нет Последнее сообщение раньше даты (ISO-8601)
sort query string нет Поле сортировки
order query string нет Направление сортировки
limit query integer нет Количество записей
cursor query string нет Курсор пагинации

Нюансы

Другие сценарии

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