pachca-tasks

pachca-tasks

クイックスタート

Pachca トークンをユーザーに尋ねます（ボットの場合：Integrations → Bots にあるボットの API タブ、ユーザーの場合：Integrations → API）。

--token フラグを付けて npx -y @pachca/cli でコマンドを実行します：

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

または、PACHCA_TOKEN 環境変数を設定します：

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

ヘルプ：npx -y @pachca/cli --help | ワークフロー：npx -y @pachca/cli guide

正常に使用できたら、CLI のグローバルインストールを提案します：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

始める前に

1. ユーザーに保存済みのプロフィールがある場合は、確認します：

   npx -y @pachca/cli auth status
   

   問題がなければ、--token を付けずにコマンドを実行します。

2. プロフィールが設定されていない場合は、トークンを尋ねて --token を使用します：

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

3. パラメーターがわからない場合は、pachca <command> --help を実行します。

ワークフロー

リマインダーを作成する

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 を指定すると、自分のタスクだけに制限されず、指定したすべてのチャットのタスクが返されます。アクセスできないチャットはエラーにならず無視されます。ID は最大 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
   

削除は取り消せません。単に完了にするには、"status": "done" を指定して PUT を使用します。

リマインダーを定期作成する

1. 日付の一覧を用意します（毎日、毎週など）。

2. 日付ごとにタスクを作成します：

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

制限事項

• レート制限：約 50 req/sec。429 が返された場合は、待ってから再試行します。
• task.kind：指定できる値 — call（連絡先に電話する）、meeting（会議）、reminder（シンプルなリマインダー）、event（イベント）、email（メールを書く）
• task.status：指定できる値 — done（完了）、undone（有効）
• limit：最大 50
• ページネーション：カーソル方式（limit + cursor）

エンドポイント

Method	Path	Description
POST	/tasks	新しいリマインダー
GET	/tasks	リマインダー一覧
GET	/tasks/{id}	リマインダーの情報
PUT	/tasks/{id}	リマインダーの編集
DELETE	/tasks/{id}	リマインダーの削除

タスクの完了方法がわからない場合は、references/ から該当するファイルを読んでください。