Pachca Chats

pachca-chats

Quick start

Ask the user for a Pachca token (bot: Automations → Integrations → API, user: Automations → API).

Run commands via npx -y @pachca/cli with the --token flag:

npx -y @pachca/cli --token $PACHCA_TOKEN

Or set the PACHCA_TOKEN environment variable:

export PACHCA_TOKEN= npx -y @pachca/cli

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

1. If the user has a saved profile — check:

npx -y @pachca/cli auth status

If OK — run commands without --token.

1. If no profile is configured — ask for a token and use --token:

npx -y @pachca/cli auth status --token $PACHCA_TOKEN

1. If you don't know the parameters — run pachca --help.

Workflows

Создать канал и пригласить участников

1. Создай канал с участниками:

``bash pachca chats create --name="Новый канал" --channel --member-ids='[1,2,3]' ` > "channel": true для канала, false (по умолчанию) для беседы. Участников можно передать сразу: memberids и/или grouptag_ids`

1. Или добавь участников позже:

``bash pachca members add --member-ids='[1,2,3]' ``

> channel — boolean, не строка. member_ids и group_tag_ids — опциональны при создании.

Переименовать или обновить чат

1. Обнови чат:

``bash pachca chats update --name="Новое название" ` > Доступные поля: name, public`

> Для изменения состава участников используй POST/DELETE /chats/{id}/members.

Создать проектную беседу из шаблона

1. Создай беседу с участниками из тега:

``bash pachca chats create --name="Проект Alpha" --group-tag-ids='[42]' --member-ids='[186,187]' ``

1. Отправь приветственное сообщение:

``bash pachca messages create --entity-id= --content="Добро пожаловать в проект!" ``

> group_tag_ids при создании добавляет всех участников тега сразу.

Найти активные чаты за период

1. Получи чаты с активностью после указанной даты:

``bash pachca chats list --last-message-at-after= --all ` > Для диапазона добавь --last-message-at-before`. Дата в ISO-8601 UTC+0

Найти и заархивировать неактивные чаты

1. Получи чаты без активности с нужной даты:

``bash pachca chats list --last-message-at-before= --all ``

1. Для каждого чата: архивируй:

``bash pachca chats archive ` > Проверяй "channel": false` — архивация каналов может быть нежелательной

Limitations

• Rate limit: ~50 req/sec. On 429 — wait and retry.
• role: 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 | Архивация чата | | POST | /chats/{id}/grouptags | Добавление тегов | | DELETE | /chats/{id}/grouptags/{tagid} | Исключение тега | | DELETE | /chats/{id}/leave | Выход из беседы или канала | | GET | /chats/{id}/members | Список участников чата | | POST | /chats/{id}/members | Добавление пользователей | | DELETE | /chats/{id}/members/{userid} | Исключение пользователя | | PUT | /chats/{id}/members/{user_id} | Редактирование роли | | PUT | /chats/{id}/unarchive | Разархивация чата |

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/.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: pachca
• Source: pachca/openapi
• License: MIT
• Homepage: https://dev.pachca.com

Install and usage instructions live in the source repository linked above.