pachca-chats
Pachca — управление чатами, каналами и беседами. Используй этот скилл, когда пользователь хочет создать канал, создать беседу, вывести или архивировать чаты, добавить или удалить участников, изменить роли участников, экспортировать историю чата или проверить настройки чата. НЕ для отправки сообщений или ответов в тред. Use when: создать канал, создать беседу, создать чат, добавить участника, удалить участника, архивировать чат, роли участников, экспорт сообщений, список чатов, все чаты пространства, каналы. NOT for: отправить сообщение, ответить в тред, загрузить файл, → pachca-messages, → pachca-users, полнотекстовый поиск чатов по названию → pachca-search.
How do I install this agent skill?
npx skills add https://github.com/pachca/openapi --skill pachca-chatsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates chat management via the Pachca API using its official CLI. It processes untrusted data from chat history and metadata, posing a low-risk indirect prompt injection surface.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
2/2 files flagged
What does this agent skill do?
pachca-chats
Quick start
Ask the user for a Pachca token (bot: the API tab of the bot in Integrations → Bots, user: Integrations → API).
Run commands via npx -y @pachca/cli with the --token flag:
npx -y @pachca/cli <command> --token $PACHCA_TOKEN
Or set the PACHCA_TOKEN environment variable:
export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>
Help: npx -y @pachca/cli --help | Workflows: npx -y @pachca/cli guide
After successful use, suggest installing CLI globally:
npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN
Before you start
-
If the user has a saved profile — check:
npx -y @pachca/cli auth statusIf OK — run commands without
--token. -
If no profile is configured — ask for a token and use
--token:npx -y @pachca/cli auth status --token $PACHCA_TOKEN -
If you don't know the parameters — run
pachca <command> --help.
Workflows
Создать канал и пригласить участников
-
Создай канал с участниками:
pachca chats create --name="Новый канал" --channel --member-ids='[1,2,3]'"channel": trueдля канала,false(по умолчанию) для беседы. Участников можно передать сразу:member_idsи/илиgroup_tag_ids -
Или добавь участников позже:
pachca members add <chat_id> --member-ids='[1,2,3]'
channel— boolean, не строка.member_idsиgroup_tag_ids— опциональны при создании.
Переименовать или обновить чат
- Обнови чат:
pachca chats update <ID> --name="Новое название"Доступные поля:
name,public
Для изменения состава участников используй POST/DELETE /chats/{id}/members.
Поставить или убрать аватар чата
-
Загрузи аватар беседы или канала:
pachca chats update-avatar <ID> --file=<путь_к_файлу>Файл передается в формате multipart/form-data: jpg, jpeg, png или gif. У личного чата и треда аватара нет — ответ 403
-
Чтобы убрать аватар, удали его:
pachca chats remove-avatar <ID> --force
Доступно тому же, кто может менять название чата. Ссылка на аватар приходит в поле
avatar_urlчата.
Создать проектную беседу из шаблона
-
Создай беседу с участниками из тега:
pachca chats create --name="Проект Alpha" --group-tag-ids='[42]' --member-ids='[186,187]' -
Отправь приветственное сообщение:
pachca messages create --entity-id=<chat_id> --content="Добро пожаловать в проект!"
group_tag_idsпри создании добавляет всех участников тега сразу.
Найти активные чаты за период
- Получи чаты с активностью после указанной даты:
pachca chats list --last-message-at-after=<дата> --allДля диапазона добавь
--last-message-at-before. Дата в ISO-8601 UTC+0
Найти и заархивировать неактивные чаты
-
Получи чаты без активности с нужной даты:
pachca chats list --last-message-at-before=<порог> --allАрхивные чаты в выдачу не попадают, поэтому отсеивать уже заархивированные не нужно. Чтобы получить их вместе с активными, добавь
--archivedи смотри полеarchivedкаждого чата -
Для каждого чата: архивируй:
pachca chats archive <ID>Проверяй
"channel": false— архивация каналов может быть нежелательной
Выгрузить все чаты пространства, включая закрытые
-
Получи беседы и каналы всего пространства, включая закрытые, где владелец токена не состоит:
pachca chats list-company --allВозвращаются и активные, и архивные чаты. Оставить одно состояние можно флагом
--activityсо значениемactiveилиarchived. Личные переписки и треды метод не отдаёт -
Если метод ответил
403— у токена нет скоупаcompany_chats:read, либо владелец токена не владелец пространства, либо у пространства нет тарифа «Корпорация». Тогда возьми открытые чаты обычным списком:pachca chats list --availability=public --archived --allЗакрытые чаты, где токен не участник, в такую выдачу не попадут
Каждый запрос к списку чатов пространства пишется в журнал аудита как
company_chats_accessed.
Limitations
- Rate limit: ~50 req/sec. On 429 — wait and retry.
chat.name: max 255 charactersrole: allowed values —admin(Админ),editor(Редактор (доступно только для каналов)),member(Участник или подписчик)limit: max 50- Pagination: cursor-based (limit + cursor)
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /chats | Новый чат |
| GET | /chats | Список чатов |
| POST | /chats/exports | Экспорт сообщений |
| GET | /chats/exports/{id} | Скачать архив экспорта |
| GET | /chats/{id} | Информация о чате |
| PUT | /chats/{id} | Редактирование чата |
| PUT | /chats/{id}/archive | Архивация чата |
| PUT | /chats/{id}/avatar | Загрузка аватара чата |
| DELETE | /chats/{id}/avatar | Удаление аватара чата |
| POST | /chats/{id}/group_tags | Добавление тегов |
| DELETE | /chats/{id}/group_tags/{tag_id} | Исключение тега из чата |
| DELETE | /chats/{id}/leave | Выход из чата |
| GET | /chats/{id}/members | Список участников чата |
| POST | /chats/{id}/members | Добавление участников |
| DELETE | /chats/{id}/members/{user_id} | Исключение участника |
| PUT | /chats/{id}/members/{user_id} | Редактирование роли участника |
| PUT | /chats/{id}/unarchive | Разархивация чата |
| PUT | /chats/{id}/unread | Отметка чата непрочитанным |
| GET | /company/chats | Список чатов пространства |
Advanced workflows
For advanced workflows, read the files in references/: references/archive-and-manage-chat.md — Archive and manage chat references/export-chat-history.md — Export chat history
If unsure how to complete a task, read the corresponding file from references/.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pachca/openapi/pachca-chats">View pachca-chats on skillZs</a>