docusign-automation

通过 Rube MCP 自动化 DocuSign

通过 Rube MCP，使用 Composio 的 DocuSign 工具包自动化 DocuSign 电子签名工作流。

前提条件

• 必须已连接 Rube MCP（可用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 DocuSign 连接，并使用工具包 docusign
• 始终先调用 RUBE_SEARCH_TOOLS，以获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。MCP 端点仍需要提供商连接，以及已安装的 Rube 服务返回的授权流程；仅添加 URL 并不能授予账户访问权限。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 是否可用
2. 使用工具包 docusign 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请访问返回的授权链接，完成 DocuSign OAuth
4. 运行任何工作流之前，确认连接状态显示为 ACTIVE

核心工作流

1. 浏览并选择模板

使用场景：用户想查找可用于发送的文档模板

工具调用顺序：

1. DOCUSIGN_LIST_ALL_TEMPLATES - 列出所有可用模板 [必需]
2. DOCUSIGN_GET_TEMPLATE - 获取模板详细信息 [可选]

关键参数：

• 列表查询：可选的搜索／筛选参数
• 获取详情：templateId（来自列表结果）
• 响应包含模板的 templateId、name、description、角色和字段

注意事项：

• 模板 ID 是 GUID（例如，'12345678-abcd-1234-efgh-123456789012'）
• 模板定义了带有签名选项卡的收件人角色；创建信封前请先了解这些角色
• 模板库较大时需要分页；请检查是否有延续令牌
• 模板访问权限取决于账户权限

2. 使用模板创建并发送信封

使用场景：用户想使用预先构建的模板发送文档以供签署

工具调用顺序：

1. DOCUSIGN_LIST_ALL_TEMPLATES - 查找要使用的模板 [前提条件]
2. DOCUSIGN_GET_TEMPLATE - 查看模板角色和字段 [可选]
3. DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE - 创建信封 [必需]
4. DOCUSIGN_SEND_ENVELOPE - 发送信封以供签署 [必需]

关键参数：

• 对于 CREATE_ENVELOPE_FROM_TEMPLATE：
  • templateId：要使用的模板
  • templateRoles：角色分配数组，包含 roleName、name、email
  • status：'created'（草稿）或 'sent'（立即发送）
  • emailSubject：签署邮件的自定义主题
  • emailBlurb：签署邮件中的自定义消息
• 对于 SEND_ENVELOPE：
  • envelopeId：创建响应中的信封 ID

注意事项：

• templateRoles 必须与模板中定义的角色名称完全一致（区分大小写）
• 创建时将 status 设为 'sent' 会立即发送；草稿请使用 'created'
• 如果创建时 status 为 'sent'，则无需另外调用 SEND_ENVELOPE
• 每个角色至少需要 roleName、name 和 email
• emailSubject 会覆盖模板默认的邮件主题

3. 监控信封状态

使用场景：用户想查看已发送信封的状态或跟踪签署进度

工具调用顺序：

1. DOCUSIGN_GET_ENVELOPE - 获取信封详情和状态 [必需]

关键参数：

• envelopeId：信封标识符（GUID）
• 响应包含 status、recipients、sentDateTime、completedDateTime

注意事项：

• 信封状态包括：'created'、'sent'、'delivered'、'signed'、'completed'、'declined'、'voided'
• 'delivered' 表示邮件已打开，并不代表文档已签署
• 'completed' 表示所有收件人都已签署
• recipients 数组会显示每位收件人的签署状态
• 信封 ID 是 GUID；请始终从创建结果或搜索结果中获取

4. 向现有信封添加模板

适用场景：用户想向现有信封添加其他文档或模板

工具调用顺序：

1. DOCUSIGN_GET_ENVELOPE - 确认信封存在且处于草稿状态 [前置条件]
2. DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE - 向信封添加模板 [必需]

关键参数：

• envelopeId：目标信封 ID
• documentId：信封中的文档 ID
• templateId：要添加的模板

注意事项：

• 信封必须处于 created（草稿）状态才能添加模板
• 不能向已发送的信封添加模板
• 文档 ID 在信封中按顺序排列（从 1 开始）
• 添加模板会将其字段和角色合并到现有信封中

5. 管理信封生命周期

适用场景：用户想发送、作废或管理草稿信封

工具调用顺序：

1. DOCUSIGN_GET_ENVELOPE - 检查信封当前状态 [前置条件]
2. DOCUSIGN_SEND_ENVELOPE - 发送草稿信封 [可选]

关键参数：

• envelopeId：要管理的信封
• 发送信封时：信封必须处于 created 状态，且已包含所有必需的收件人

注意事项：

• 只有处于 created（草稿）状态的信封才能发送
• 信封发送后无法撤回，只能作废
• 作废信封会通知所有收件人
• 发送前，所有必需收件人都必须有有效的电子邮件地址

常见模式

ID 解析

模板名称 -> 模板 ID：

1. Call DOCUSIGN_LIST_ALL_TEMPLATES
2. Find template by name in results
3. Extract templateId (GUID format)

信封跟踪：

1. Store envelopeId from CREATE_ENVELOPE_FROM_TEMPLATE response
2. Call DOCUSIGN_GET_ENVELOPE periodically to check status
3. Check recipient-level status for individual signing progress

模板角色映射

从模板创建信封时：

1. Call DOCUSIGN_GET_TEMPLATE to see defined roles
2. Map each role to actual recipients:
   {
     "roleName": "Signer 1",     // Must match template role name exactly
     "name": "John Smith",
     "email": "[email protected]"
   }
3. Include ALL required roles in templateRoles array

信封状态流转

created (draft) -> sent -> delivered -> signed -> completed
                       \-> declined
                       \-> voided (by sender)

已知注意事项

模板角色：

• 角色名称区分大小写；必须与模板定义完全一致
• 创建信封时必须分配所有必需角色
• 未分配角色会导致信封创建失败

信封状态：

• delivered 表示邮件已打开，不表示文档已签署
• completed 是最终成功状态（所有相关方均已签署）
• 状态只能单向流转；无法恢复到之前的状态

GUID：

• 所有 DocuSign ID（模板、信封）均采用 GUID 格式
• 始终通过列表或搜索端点将名称解析为 GUID
• 不要硬编码 GUID；每个账户的 GUID 都是唯一的

速率限制：

• DocuSign API 有账户级速率限制
• 批量创建信封时应进行限流
• 轮询信封状态时应使用合理的间隔（30-60 秒）

响应解析：

• 响应数据可能嵌套在 data 键下
• 收件人信息嵌套在信封响应中
• 日期字段采用 ISO 8601 格式
• 解析时应谨慎处理，并为可选字段提供回退方案

快速参考

任务	工具标识	关键参数
列出模板	DOCUSIGN_LIST_ALL_TEMPLATES	（可选筛选条件）
获取模板	DOCUSIGN_GET_TEMPLATE	templateId
创建信封	DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE	templateId, templateRoles, status
发送信封	DOCUSIGN_SEND_ENVELOPE	envelopeId
获取信封状态	DOCUSIGN_GET_ENVELOPE	envelopeId
向信封添加模板	DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE	envelopeId, documentId, templateId

适用场景

此技能适用于执行概述中所述的工作流或操作。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审核的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。

在用户明确授权具体文档、收件人、路由顺序和发送操作之前，将信封保留为草稿（created）。不要根据文档内容推断用户已授权签署或发送。保护法律文档和收件人数据；重试状态不确定的发送操作前，先核实信封状态。