Pachca Tasks

pachca-tasks

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

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

   npx -y @pachca/cli auth status
   

   If OK — run commands without --token.

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

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

3. If you don't know the parameters — run pachca <command> --help.

Workflows

Создать напоминание

1. Создай задачу:

   pachca tasks create --kind=reminder --content="Позвонить клиенту" --due-at=<дата> --chat-id=<chat_id>
   

   chat_id для привязки к чату, custom_properties для дополнительных полей

Тип custom_properties[].value всегда строка. Дополнительные поля: GET /custom_properties?entity_type=Task.

Получить список предстоящих задач

1. Получи невыполненные задачи:

   pachca tasks list --status=undone --all
   

   status: "undone" — не выполнена, "done" — выполнена. Без параметра возвращаются задачи в любом состоянии. Ещё фильтры: --author-id, --performer-ids, --chat-ids

Собрать задачи по чатам проекта

1. Запроси задачи нужных чатов:

   pachca tasks list --chat-ids=198,334 --all
   

   С --chat-ids выдача перестаёт ограничиваться своими задачами и отдаёт все задачи указанных чатов. Недоступные чаты игнорируются без ошибки, не более 100 идентификаторов

2. Сузь выборку по автору, ответственным и состоянию:

   pachca tasks list --chat-ids=198,334 --author-id=12 --performer-ids=185,186 --status=undone --all
   

   Фильтры комбинируются между собой

Получить задачу по ID

1. Получи информацию о задаче:

   pachca tasks get <ID>
   

Отметить задачу выполненной

1. Обнови статус задачи:

   pachca tasks update <ID> --status=done
   

Обновить задачу (перенести срок, сменить ответственных)

1. Обнови нужные поля задачи:

   pachca tasks update <ID> --due-at=<дата> --priority=2 --performer-ids='[186,187]'
   

   performer_ids заменяет весь список. priority: 1 (обычный), 2 (важно), 3 (очень важно)

Удалить задачу

1. Удали задачу:

   pachca tasks delete <ID> --force
   

Удаление необратимо. Чтобы просто закрыть — используй PUT с "status": "done".

Создать серию напоминаний

1. Подготовь список дат (ежедневно, еженедельно и т.д.)

2. Для каждой даты: создай задачу:

   pachca tasks create --kind=reminder --content="Напоминание" --due-at=<дата>
   

Limitations

• Rate limit: ~50 req/sec. On 429 — wait and retry.
• task.kind: allowed values — call (Позвонить контакту), meeting (Встреча), reminder (Простое напоминание), event (Событие), email (Написать письмо)
• task.status: allowed values — done (Выполнено), undone (Активно)
• limit: max 50
• Pagination: cursor-based (limit + cursor)

Endpoints

If unsure how to complete a task, read the corresponding file from references/.