如何通过DocuSign API代同事账户发送信封？

核心结论 #

SOBO（代表他人发送）完全适用于你的场景，之前请求未生效是因为权限配置或请求参数缺失，按以下步骤修正：

1. 确认SOBO权限配置 #

首先确保你的账户具备代表John/Jane发送的权限：

• 登录你的DocuSign账户，进入设置 → 用户
• 找到John Doe和Jane Doe的用户条目，点击编辑
• 勾选允许代表该用户发送信封（具体名称可能因账户版本略有差异）
• 确认你的DS Admin权限组已包含「代表其他用户发送」的权限（可在设置 → 权限组 → 编辑你的权限组查看）

2. 修正API请求参数 #

你的请求返回201但发件人未变更，需补充请求体的发件人配置，并验证请求头的正确性：

• 请求头：确保X-DocuSign-Act-As-User的值是John/Jane的账户内用户ID（可通过GET /accounts/{accountId}/users API获取，返回结果中的userId字段）
• 请求体：在envelopeDefinition中明确指定发件人信息，覆盖模板或默认设置，示例如下：

  {
    "envelopeDefinition": {
      "templateId": "你的模板ID",
      "templateRoles": [
        {
          "roleName": "客户",
          "email": "customer@example.com",
          "name": "客户姓名"
        }
      ],
      "status": "sent",
      "sender": {
        "userName": "John Doe",
        "email": "john.doe@company.com"
      }
    }
  }
  

3. 验证OAuth令牌权限 #

获取accessToken时，必须包含impersonation和signature权限 scope，请求授权时的scope参数应为：

signature%20impersonation

如果之前的令牌未包含impersonation，需重新生成令牌。

4. 排查模板预设问题 #

如果模板中固定了发件人信息，需在模板设置中改为「动态」，或确保API请求的sender字段优先级高于模板配置（上述请求体配置已覆盖模板发件人）。

内容的提问来源于stack exchange，提问作者Ry2254