Пачка API: Создать канал и добавить участников

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

Под новый проект, клиента или инцидент — отдельный канал с нужными людьми.

1. Создай чат: POST /chats с chat.name и chat.member_ids. Для канала передай chat.channel = true, для открытого доступа — chat.public = true. Владельцем станет владелец токена.
2. Добавь участников позже: POST /chats/{id}/members с member_ids. Чтобы не появлялось системное сообщение о добавлении, передай silent = true.
3. ID сотрудников бери из GET /users.

curl -X POST https://api.pachca.com/api/shared/v1/chats \
  -H "Authorization: Bearer $PACHCA_TOKEN" -H 'Content-Type: application/json' \
  -d '{"chat": {"name": "Инцидент 24.10: оплата не проходит", "member_ids": [12345, 12346], "channel": false}}'

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

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

POST /chats — Новый чат

Создаёт беседу или канал; владелец токена становится владельцем чата.

Параметр	Где	Тип	Обяз.	Описание
chat.name	body	string	да	Название
chat.member_ids	body	array	нет	ID пользователей-участников
chat.group_tag_ids	body	array	нет	ID тегов-участников
chat.channel	body	boolean	нет	Создать канал
chat.public	body	boolean	нет	Открытый доступ

POST /chats/{id}/members — Добавить участников

Добавляет сотрудников и ботов в беседу, канал или тред.

Параметр	Где	Тип	Обяз.	Описание
id	path	integer	да	ID чата
member_ids	body	array	да	ID пользователей
silent	body	boolean	нет	Не создавать системное сообщение о добавлении

GET /users — Список сотрудников

Все сотрудники пространства, кроме удалённых; приостановленные отмечены полем suspended.

Параметр	Где	Тип	Обяз.	Описание
query	query	string	нет	Поиск по имени, фамилии, email и др.
limit	query	integer	нет	Количество записей
cursor	query	string	нет	Курсор пагинации

Нюансы

• Ответы на создание оборачиваются в объект 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