pachca-tasks

Quick start

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

Run commands with npx @pachca/cli and --token flag:

npx @pachca/cli <command> --token $PACHCA_TOKEN

Or set PACHCA_TOKEN for multiple commands:

export PACHCA_TOKEN=<token>
npx @pachca/cli <command>

Help: npx @pachca/cli --help | Scenarios: npx @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 user has a saved profile — check status:

   npx @pachca/cli auth status
   

   If OK — use commands without --token.

2. If profile is not configured — ask for token and use --token flag:

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

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

Step-by-step scenarios

Create reminder

1. Create task:

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

   chat_id to link to chat, custom_properties for additional fields

custom_properties[].value type is always string. Additional fields: GET /custom_properties?entity_type=Task.

Get list of upcoming tasks

1. Get all tasks, filter by status on client side:

   pachca tasks list --all
   

   status: "undone" — not completed, "done" — completed. API-side filtering not supported

Get task by ID

1. Get task info:

   pachca tasks get <ID>
   

Mark task as completed

1. Update task status:

   pachca tasks update <ID> --status=done
   

Update task (reschedule, change assignees)

1. Update task fields:

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

   performer_ids replaces entire list. priority: 1 (normal), 2 (important), 3 (very important)

Delete task

1. Delete task:

   pachca tasks delete <ID> --force
   

Deletion is irreversible. To just close — use PUT with "status": "done".

Create series of reminders

1. Prepare list of dates (daily, weekly, etc.)

2. For each date: create task:

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

Constraints and gotchas

• 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 you don't know how to complete a task — read the corresponding file from references/ for step-by-step instructions.