ComposioHQ/PandaDoc-Automation

PandaDoc 自動化

PandaDoc のドキュメントワークフローを Claude Code から直接管理できます。アップロードしたファイルからドキュメントを作成し、受信者や連絡先を管理し、フォルダで整理し、イベントの Webhook を設定し、テンプレートを作成し、ターミナルから離れずにドキュメントステータスを追跡できます。

ツールキットドキュメント: composio.dev/toolkits/pandadoc

---

セットアップ

1. Composio MCP サーバーを設定に追加します：

   https://rube.app/mcp
   

2. プロンプトに従って PandaDoc アカウントを接続します。エージェントが OAuth リンクを提供して認証します。
3. 必要な機能（例：電子署名、テンプレート、Webhook）に対応した適切なプランが PandaDoc ワークスペースに設定されていることを確認してください。

---

コアワークフロー

1. ファイルからドキュメントを作成

PDF、DOCX、RTF ファイルをアップロードし、署名や追跡用の指定された受信者とともに新しい PandaDoc ドキュメントを作成します。

ツール: PANDADOC_CREATE_DOCUMENT_FROM_FILE

主なパラメータ：

• name（必須）-- ドキュメント名
• recipients（必須）-- 受信者オブジェクトの配列。各オブジェクトに以下を含む：
  • email（必須）-- 受信者のメールアドレス
  • first_name、last_name -- 受信者の名前
  • role -- signer（デフォルト）、approver、または cc（受信者ごとに一意である必要があります）
  • signing_order -- 数値順序（1つに設定する場合は、すべてに設定する必要があります）
• file -- アップロードされたファイルオブジェクト（name、mimetype、s3key を含む）
• url -- 代わりに、ファイルへの公開 HTTPS URL
• parse_form_fields（デフォルト false）-- PDF フォームフィールドを解析するかどうか
• tags -- 分類用の文字列配列
• owner -- ドキュメント所有者（メールアドレスまたはメンバーシップID）

例プロンプト：「contract.pdf から、[email protected] を署名者、[email protected] を承認者として PandaDoc ドキュメントを作成して」

---

2. ドキュメント詳細を取得

受信者、フィールド、トークン、価格、タグ、コンテンツブロック参照を含む、ドキュメントの詳細メタデータを取得します。

ツール: PANDADOC_GET_DOCUMENT_DETAILS

主なパラメータ：

• id（必須）-- 一意のドキュメント識別子（例：BhVzRcxH9Z2LgfPPGXFUqa）

これを使用して、ドキュメントステータスの確認、受信者の完了状況の検査、フィールド値の確認、またはレポート用のメタデータ収集を行います。

例プロンプト：「PandaDoc ドキュメント BhVzRcxH9Z2LgfPPGXFUqa の完全な詳細とステータスを取得して」

---

3. 連絡先を管理

PandaDoc で新しい連絡先を作成するか、既存の連絡先を更新します。連絡先はメールアドレスで照合されます。指定されたメールアドレスの連絡先が存在する場合は更新され、存在しない場合は新規作成されます。

ツール: PANDADOC_CREATE_OR_UPDATE_CONTACT

主なパラメータ：

• email（必須）-- 連絡先のメールアドレス
• first_name、last_name -- 連絡先の名前
• company -- 会社名
• job_title -- 役職/肩書き
• phone -- 電話番号
• street_address、city、state、postal_code、country -- 住所フィールド

例プロンプト：「[email protected] の PandaDoc 連絡先を、Acme Corp、ソフトウェアエンジニアとして作成して」

---

4. フォルダで整理

フォルダを作成し、ドキュメントを移動して PandaDoc ワークスペースを整理します。

ツール: PANDADOC_CREATE_FOLDER、PANDADOC_LIST_DOCUMENT_FOLDERS、PANDADOC_MOVE_DOCUMENT_TO_FOLDER

フォルダ作成の場合：

• name（必須）-- フォルダ名
• parent_uuid -- ネスト構造用の親フォルダ UUID

例プロンプト：「PandaDoc に 'Q1 2026 契約書' フォルダを作成し、ドキュメント BhVzRcxH9Z をそこに移動して」

---

5. Webhook を設定

ドキュメントイベント発生時にリアルタイム通知を受け取る Webhook サブスクリプションを作成します。

ツール: PANDADOC_CREATE_WEBHOOK

主なパラメータ：

• name（必須）-- Webhook の説明的な名前
• url（必須）-- 通知のエンドポイント URL
• triggers（必須）-- イベントタイプ：document_state_changed、recipient_completed、document_updated など
• active（デフォルト true）-- Webhook の有効/無効
• payload -- 追加で含めるデータ：fields、products、metadata、tokens、pricing

例プロンプト：「ドキュメントの状態が変更されたり、受信者が完了したときに https://api.example.com/hooks に通知する PandaDoc Webhook を設定して」

---

6. テンプレートを作成

PDF ファイルから、または構造化されたコンテンツブロックを使用して一から再利用可能なテンプレートを作成します。

ツール: PANDADOC_CREATE_TEMPLATE

主なパラメータ：

• name（必須）-- テンプレート名
• file_path -- テンプレート作成用の PDF ファイルへのパス
• content -- 一から作成するための title と blocks 配列を含む構造化コンテンツオブジェクト
• description -- テンプレートの説明
• tags -- 分類タグ

例プロンプト：「nda-template.pdf ファイルから '標準 NDA' という PandaDoc テンプレートを作成して」

---

既知の落とし穴

• 一意な受信者ロール： PandaDoc API は単一ドキュメント内でのロールの重複を許可しません。各受信者は一意の role 値（例：signer、signer_2、approver、cc）を持つ必要があります。
• 署名順序の一貫性： いずれかの受信者に signing_order を指定する場合は、ドキュメント内のすべての受信者に指定する必要があります。部分的な順序付けはエラーの原因になります。
• ファイルアップロード要件： ドキュメント作成には file（s3key 付き）または url のどちらか一方を指定する必要があり、両方は指定できません。URL は公開アクセス可能な HTTPS である必要があります。
• 連絡先の upsert 動作： PANDADOC_CREATE_OR_UPDATE_CONTACT はメールアドレスで照合します。連絡先のメールアドレス自体を更新する必要がある場合は、新しい連絡先を作成し、古いものを別途処理する必要があります。
• ドキュメント ID 形式： ドキュメント ID は英数字の文字列です（例：BhVzRcxH9Z2LgfPPGXFUqa）。ドキュメント作成時に返され、PandaDoc ダッシュボードでも確認できます。
• Webhook イベント名： トリガーイベント名は正確に一致する必要があります（例：document_state_changed、stateChanged や state_changed ではありません）。完全なリストは PandaDoc API ドキュメントを確認してください。
• フォルダ操作には UUID が必要： ドキュメントの移動には、ドキュメント ID と移動先フォルダの UUID の両方が必要です。最初にフォルダ一覧を取得して正しい UUID を確認してください。
• テンプレートコンテンツブロック： 一からテンプレートを作成する場合、blocks 配列は PandaDoc のスキーマに従った有効なコンテンツブロックオブジェクトを含む必要があります。サポートされているブロックタイプについては、PandaDoc API ドキュメントを確認してください。

---

クイックリファレンス

ツールスラッグ	説明
PANDADOC_CREATE_DOCUMENT_FROM_FILE	PDF/DOCX/RTF から受信者付きでドキュメントを作成
PANDADOC_GET_DOCUMENT_DETAILS	ドキュメントの完全なメタデータ、ステータス、フィールドを取得
PANDADOC_CREATE_OR_UPDATE_CONTACT	メールアドレスで連絡先を作成または更新
PANDADOC_CREATE_FOLDER	ドキュメント整理用のフォルダを作成
PANDADOC_LIST_DOCUMENT_FOLDERS	すべてのドキュメントフォルダを一覧表示
PANDADOC_MOVE_DOCUMENT_TO_FOLDER	ドキュメントを特定のフォルダに移動
PANDADOC_CREATE_WEBHOOK	イベント通知 Webhook を設定
PANDADOC_CREATE_TEMPLATE	再利用可能なドキュメントテンプレートを作成

---

Powered by Composio