PandaDoc自动化Skill PandaDocAutomation

PandaDoc自动化技能通过集成PandaDoc API,允许用户在Claude Code中自动化文档创建、管理联系人、组织文件夹、设置Webhook、创建模板和跟踪文档状态,提升文档工作流效率。关键词:文档自动化,PandaDoc集成,工作流管理,Claude Code,API集成,SaaS工具。

DevOps 0 次安装 0 次浏览 更新于 3/12/2026

name: PandaDoc 自动化 description: “通过 Composio PandaDoc 集成,自动化文档工作流 – 从文件创建文档、管理联系人、组织文件夹、设置 Webhook、创建模板以及跟踪文档状态。” requires: mcp: - rube

PandaDoc 自动化

直接在 Claude Code 中管理 PandaDoc 文档工作流。从上传的文件创建文档、管理收件人和联系人、使用文件夹进行组织、设置事件 Webhook、创建模板并跟踪文档状态,无需离开终端。

工具包文档: composio.dev/toolkits/pandadoc


设置

  1. 将 Composio MCP 服务器添加到您的配置中:
    https://rube.app/mcp
    
  2. 当提示时连接您的 PandaDoc 账户。代理将提供一个 OAuth 链接进行身份验证。
  3. 确保您的 PandaDoc 工作区有适合所需功能的计划(例如,电子签名、模板、Webhook)。

核心工作流

1. 从文件创建文档

上传 PDF、DOCX 或 RTF 文件,创建新的 PandaDoc 文档,指定收件人进行签名和跟踪。

工具: PANDADOC_CREATE_DOCUMENT_FROM_FILE

关键参数:

  • name(必需)-- 文档名称
  • recipients(必需)-- 收件人对象数组,每个对象包含:
    • email(必需)-- 收件人邮箱
    • first_name, last_name – 收件人姓名
    • rolesigner(默认)、approvercc(每个收件人必须唯一)
    • signing_order – 数字顺序(如果为某个收件人设置,则必须为所有收件人设置)
  • file – 上传的文件对象,包含 namemimetypes3key
  • url – 替代方案,文件的公共 HTTPS URL
  • parse_form_fields(默认 false)-- 解析 PDF 表单字段
  • tags – 分类字符串数组
  • owner – 文档所有者(邮箱或 membership_id)

示例提示: “从 contract.pdf 创建一个 PandaDoc 文档,john@example.com 作为签署者,jane@example.com 作为批准者”


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 – 地址字段

示例提示: “为 john.doe@example.com 在 Acme Corp 创建 PandaDoc 联系人,职位为软件工程师”


4. 使用文件夹进行组织

创建文件夹并移动文档,以组织您的 PandaDoc 工作区。

工具: PANDADOC_CREATE_FOLDER, PANDADOC_LIST_DOCUMENT_FOLDERS, PANDADOC_MOVE_DOCUMENT_TO_FOLDER

用于创建文件夹:

  • name(必需)-- 文件夹名称
  • parent_uuid – 父文件夹 UUID,用于嵌套结构

示例提示: “在 PandaDoc 中创建 ‘2026 年第一季度合同’ 文件夹,并将文档 BhVzRcxH9Z2LgfPPGXFUqa 移动到其中”


5. 设置 Webhook

创建 Webhook 订阅,以在文档事件发生时接收实时通知。

工具: PANDADOC_CREATE_WEBHOOK

关键参数:

  • name(必需)-- Webhook 的描述性名称
  • url(必需)-- 通知端点 URL
  • triggers(必需)-- 事件类型: document_state_changedrecipient_completeddocument_updated
  • active(默认 true)-- 启用/禁用 Webhook
  • payload – 包含的额外数据: fieldsproductsmetadatatokenspricing

示例提示: “设置 PandaDoc Webhook,当文档状态更改或收件人完成时通知 https://api.example.com/hooks


6. 创建模板

从 PDF 文件或从头开始创建可重用模板,使用结构化内容块。

工具: PANDADOC_CREATE_TEMPLATE

关键参数:

  • name(必需)-- 模板名称
  • file_path – PDF 文件路径,用于模板创建
  • content – 结构化内容对象,包含 titleblocks 数组,用于从头构建
  • description – 模板描述
  • tags – 分类标签

示例提示: “从 nda-template.pdf 文件创建名为 ‘标准 NDA’ 的 PandaDoc 模板”


已知陷阱

  • 收件人角色唯一性: PandaDoc API 不允许在单个文档中存在重复角色。每个收件人必须有唯一的 role 值(例如,signersigner_2approvercc)。
  • 签署顺序一致性: 如果为任何收件人指定 signing_order,则必须为文档中所有收件人指定。部分排序将导致错误。
  • 文件上传要求: 必须提供 file(带 s3key)或 url 进行文档创建,不能两者都提供。URL 必须是可公开访问的 HTTPS。
  • 联系人更新行为: PANDADOC_CREATE_OR_UPDATE_CONTACT 通过邮箱匹配。如果需要更新联系人的邮箱本身,必须创建新联系人并单独处理旧联系人。
  • 文档 ID 格式: 文档 ID 是字母数字字符串(例如,BhVzRcxH9Z2LgfPPGXFUqa)。创建文档时返回,可以通过 PandaDoc 仪表板找到。
  • Webhook 事件命名: 触发事件名称必须完全匹配(例如,document_state_changed,而不是 stateChangedstate_changed)。查看 PandaDoc API 文档获取完整列表。
  • 文件夹操作需要 UUID: 移动文档需要文档 ID 和目标文件夹 UUID。首先列出文件夹以获取正确的 UUID。
  • 模板内容块: 从头创建模板时,blocks 数组必须包含根据 PandaDoc 模式的有效内容块对象。查看其 API 文档获取支持的块类型。

快速参考

工具 Slug 描述
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 创建可重用文档模板

Composio 提供支持