如何通过Demo DocuSign API在Slack中对接DocuSign eSignature？

对接步骤 #

• 步骤1：创建并配置DocuSign集成密钥
  在DocuSign开发者平台创建集成密钥，启用JWT授权或OAuth授权码流，确保权限包含eSignature相关范围（如signature、impersonation），同时记录集成密钥、客户端ID等核心信息。

• 步骤2：配置Slack应用的权限与事件
  在Slack开发者平台打开目标DocuSign应用，添加必要Bot权限（如chat:write用于发送消息、files:write用于上传文档），并订阅触发签署请求等相关事件，确保应用能接收并响应Slack端的用户操作。

• 步骤3：通过DocuSign API实现核心对接逻辑
  编写代码完成以下核心功能：

  • 接收Slash命令或Bot交互等Slack端的用户请求
  • 调用DocuSign eSignature API创建签署信封、添加签署人、上传待签文档
  • 将签署状态回调（如签署完成、拒绝）同步回Slack，通知发起用户

  示例Python代码片段：

  from docusign_esign import ApiClient, EnvelopesApi
  import base64
  
  # 初始化DocuSign客户端
  api_client = ApiClient()
  api_client.set_base_path("https://demo.docusign.net/restapi")  # 可切换为生产环境地址
  api_client.set_default_header("Authorization", "Bearer {access_token}")
  
  # 读取并编码待签文档
  with open("test.pdf", "rb") as f:
      base64_content = base64.b64encode(f.read()).decode("utf-8")
  
  # 创建签署信封
  envelope_definition = {
      "emailSubject": "请签署指定文档",
      "documents": [{"documentId": "1", "name": "test.pdf", "documentBase64": base64_content}],
      "recipients": {"signers": [{"email": "signer@example.com", "name": "签署人姓名", "recipientId": "1"}]},
      "status": "sent"
  }
  
  envelopes_api = EnvelopesApi(api_client)
  envelopes_api.create_envelope("{account_id}", envelope_definition=envelope_definition)
  

• 步骤4：测试与上线
  在Demo环境完成全流程联调测试后，切换生产环境API基础路径（https://www.docusign.net/restapi），替换生产环境的集成密钥与授权信息，即可正式上线使用。

API环境支持说明 #

• Demo API（Sandbox）完全支持：所有对接开发、测试操作都可在DocuSign Demo环境完成，包括集成密钥创建、eSignature API调用、Slack应用联调，Demo环境逻辑与生产环境一致，适合前期验证开发。
• Production API：测试完成后，只需切换API地址、替换生产环境的授权配置，即可无缝迁移到生产环境运行。

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