如何在Bubble中集成DocuSign API？OAuth连接问题求助

一、准备DocuSign OAuth凭证 #

• 登录DocuSign开发者控制台，创建集成密钥（Integrator Key）
• 配置重定向URI：必须是你的Bubble应用回调地址，格式为 https://[你的Bubble域名]/oauth_redirect
• 记录好集成密钥、客户端密钥（Client Secret）和重定向URI

二、在Bubble中配置API Connector的OAuth认证 #

• 打开Bubble编辑器，进入「Plugins > API Connector」，点击「Add API」
• 命名API（比如「DocuSign API」），认证类型选择「OAuth2.0」
• 填写以下参数：
  • Authorization URL：沙箱环境用 https://account-d.docusign.com/oauth/auth，生产环境换 https://account.docusign.com/oauth/auth
  • Token URL：沙箱用 https://account-d.docusign.com/oauth/token，生产换对应地址
  • Client ID：填入DocuSign的集成密钥
  • Client Secret：填入DocuSign的客户端密钥
  • Redirect URI：填入之前在DocuSign配置的回调地址
  • Scope：填写 signature%20impersonation（这两个权限是发起签署和代用户操作的核心权限）
• 点击「Initialize OAuth」完成授权，确认Bubble能正常获取访问令牌

三、创建发起签署信封的API调用 #

• 在已配置的DocuSign API下，点击「Add Call」，命名为「创建签署信封」
• 请求方法选POST，URL填沙箱地址：https://demo.docusign.net/restapi/v2.1/accounts/[你的DocuSign账户ID]/envelopes（生产环境替换域名）
• 认证方式选择「Use OAuth2.0」
• 请求体选JSON格式，示例内容如下（按需替换占位符）：

{
  "emailSubject": "请签署这份文档",
  "status": "sent",
  "recipients": {
    "signers": [
      {
        "email": "{{当前用户邮箱}}",
        "name": "{{当前用户姓名}}",
        "recipientId": "1",
        "clientUserId": "{{Bubble用户ID}}",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "100",
              "yPosition": "100"
            }
          ]
        }
      }
    ]
  },
  "documents": [
    {
      "documentId": "1",
      "name": "待签署文档.pdf",
      "documentBase64": "{{PDF文件Base64编码}}"
    }
  ]
}

• 替换占位符后，测试调用，确保能成功返回信封ID

四、添加用户跳转签署的逻辑 #

• 在Bubble页面添加按钮，点击事件设置为「调用API」（选择刚才创建的「创建签署信封」）
• 调用成功后，提取返回的envelopeId，构造DocuSign签署链接：沙箱环境用 https://demo.docusign.net/auth/login?returnUrl=/templaterouter?envelopeId=[envelopeId]&clientUserId=[Bubble用户ID]
• 用Bubble的「打开外部网站」动作，跳转到该链接，用户即可进入DocuSign完成签署

五、可选：处理签署后的回调 #

• 在DocuSign开发者控制台的应用设置里，配置「事件通知」，设置回调URL为你的Bubble API端点
• 在Bubble中创建API工作流，接收DocuSign的回调数据，更新用户的签署状态

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