mcpField
P
pachca-forms

pachca-forms

github.com/pachca開発1188 回インストール今日更新
リポジトリ

pachca-forms について

pachca-formsは、Pachca CLIでインタラクティブフォームを開き、送信を処理するスキルです。Botトークンが必要で、フォームブロックと応答期限が記載されています。

主な機能

  1. 01モーダルフォームの表示
  2. 0211種類のフォームブロックの利用
  3. 03フォーム送信の処理
  4. 04送信応答の期限への対応

活用シーン

  1. 01ユーザーにインタラクティブフォームを提示
  2. 02社員アンケートの実施
  3. 03申請フォームで依頼を収集

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pachca/openapi --skill pachca-forms

インストール後、Claude Code で/pachca-formsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
employee-survey-via-form.md
handle-form-submission-viewsubmission.md
requestapplication-form.md
show-interactive-form-to-user.md

詳細

pachca-forms

クイックスタート

ユーザーに 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 を実行します。

フォームブロック

ブロックの種類は 11 個です：header、plain_text、markdown、divider、input、select、radio、checkbox、date、time、file_input。各ブロックのパラメーター、制限、デフォルト値を含むフィールドレベルのリファレンスは、https://dev.pachca.com/guides/forms/blocks.md にあり、ここでのみ管理されています。

file_input からアップロードされたファイルは、2 時間のあいだ data.<field>[].url の URL からアクセスでき、ファイル自体は 1 日間保存されます。送信が届いたら、後回しにせずダウンロードしてください。

制限事項

  • レート制限：約 50 リクエスト/秒。429 が返された場合は、待ってから再試行します。
  • 410：trigger_id が期限切れか、見つかりません。trigger_id の有効期間は 3 秒です。ボタンのクリック（webhook）から新しいものを取得してください。
  • 410：POST /views/{view_id}/submit_response で submit_expired。フォーム送信からの応答時間は 5 秒で、応答は 1 回のみ受け付けられます。時間内に応答できるよう、イベント履歴を十分な頻度で読み取ってください。
  • 404：POST /views/{view_id}/submit_response で view_not_found。view_submit イベントのペイロードから view_id を取得し、ビューを開いたときと同じボットトークンで応答してください。
  • type：使用可能な値 — modal（モーダルウィンドウ）
  • private_metadata：最大 3000 文字
  • callback_id：最大 255 文字
  • view.title：最大 24 文字
  • view.close_text：最大 24 文字
  • view.submit_text：最大 24 文字

エンドポイント

メソッドパス説明
POST/views/openビューを開く
POST/views/{view_id}/submit_responseフォーム送信への応答

高度なワークフロー

高度なワークフローについては、references/ 内のファイルを読んでください。 references/show-interactive-form-to-user.md — ユーザーにインタラクティブフォームを表示する references/handle-form-submission-viewsubmission.md — フォーム送信を処理する（view_submission） references/employee-survey-via-form.md — フォームを使った従業員アンケート references/requestapplication-form.md — 申請／応募フォーム

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

コメント

Markdown 対応