pachca-search

pachca-search

クイックスタート

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 search list-messages --query="текст"
   

   limit（最大 200）、cursor。フィルター：chat_ids[]、user_ids[]、active、created_from/created_to

アクセス可能なすべてのチャットを検索します。応答の root_chat_id は、スレッドのルートチャットです。

チャットを名前で検索する

1. チャットを全文検索します。

   pachca search list-chats --query="название"
   

   limit（最大 100）、cursor。フィルター：active、chat_subtype、personal、created_from/created_to

従業員を名前で検索する

1. 従業員を全文検索します。

   pachca search list-users --query="имя"
   

   アルファベット順に並べ替えるには sort=alphabetical を、スコア順（デフォルト）にするには sort=by_score を指定します。フィルター：company_roles[]、created_from/created_to

名前、メールアドレス、役職、その他のフィールドで検索します。関連度による並べ替えに対応しています。

制限事項

• レート制限：約 50 req/sec。429 が返された場合は、待機して再試行します。
• limit：最大値は 100（GET /search/chats）、200（GET /search/messages）、200（GET /search/users）です。
• ページネーション：カーソルベース（limit + cursor）

エンドポイント

メソッド	パス	説明
GET	/search/chats	チャットの検索
GET	/search/messages	メッセージの検索
GET	/search/users	従業員の検索

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