跳到内容
免费开始使用
← All articles
Setup

电子签名(DocuSign)

使用你自己的 DocuSign 账户(BYO 模式),将报价单发送出去进行电子签名。

电子签名集成使用的是你自己的 DocuSign 账户(BYO 模式:自带账户)。信封(envelope)在你的 DocuSign 账户中创建并计费:我们这边不产生任何费用、加价或中间环节。我们只负责打通相关字段以及发送报价单进行签署的按钮。

该集成默认处于未启用状态:在你填写相关字段并激活之前,不会有任何操作。访问令牌以加密方式存储在 CRM 中,不会再次显示。

前提条件

  • 拥有一个 DocuSign 账户(演示/测试环境或生产环境),并具有发送信封的权限。
  • 可以访问 DocuSign 控制台,查看 Apps and Keys(Account ID 和 Base URI)、生成 OAuth 访问令牌,并配置 DocuSign Connect(Admin → Connect)。
  • 在 Sellio 中拥有管理员权限,以便在“设置 → 集成”中保存凭证并激活该集成。

你需要填写的内容

  • Account ID(API Account ID):你的 DocuSign 账户标识,位于 DocuSign 控制台的“设置 → Apps and Keys”中。
  • Account Base URI:你账户的基础地址,测试环境为 https://demo.docusign.net,生产环境类似 https://na3.docusign.net(子域名因账户而异,可在同一 Apps and Keys 页面查看)。
  • Access token(OAuth 访问令牌):你在 DocuSign 中生成的访问令牌,用于授权相关调用。它以加密方式存储在 CRM 中。
  • Connect HMAC key(接收 webhook 所需):DocuSign 用于对每个 webhook 进行签名的密钥。请在 Admin → Connect 中启用 HMAC 并复制生成的密钥。若未设置该密钥,webhook 将被拒绝(签名状态将不会自动推进)。

如何配置

  1. 打开“设置 → 集成”,找到“电子签名(DocuSign)”卡片。
  2. 粘贴 Account ID、Base URI、Access token 和 Connect HMAC key,点击“保存凭证”。
  3. 复制出现的“Webhook URL(DocuSign Connect)”,然后在 DocuSign 的 Admin → Connect 中创建一个自定义配置,指向该 URL,并勾选信封相关事件(sent、delivered、completed、declined、voided)。
  4. 在同一个 Connect 配置中,使用你粘贴到 CRM 中的同一个密钥启用 HMAC(勾选 Include HMAC signature)。此后,DocuSign 会在 X-DocuSign-Signature-1 请求头中对每个事件进行签名,CRM 会对其进行校验。
  5. 返回 CRM,点击“激活”。

如何发送报价单进行签署

  1. 打开一个商机,进入“报价单”部分。
  2. 在所需的版本上点击“签名”,输入签署人的邮箱(可选填姓名)并确认。
  3. CRM 会在 DocuSign 中创建一个包含报价单文档的信封,并向签署人发送签名邮件。
  4. 随着签署人推进流程,状态会显示在报价单的“签名”列表中(已发送 → 已送达 → 已签署)。
💡 当签名完成且该签署请求与某个报价单关联时,该报价单会自动被标记为“已接受”。如果在未配置 DocuSign 的情况下尝试发送,CRM 会明确提示你,该功能在凭证配置完成之前始终处于未启用状态。

目前的认证方式是粘贴一个访问令牌(最简便的方式)。未来的演进方向是采用 JWT grant(集成密钥 + 私钥),可自动续期令牌,无需手动粘贴。

如何测试

  1. 使用演示环境(Base URI 为 https://demo.docusign.net)以及测试用的访问令牌。
  2. 在某个报价单上点击“签名”,将你自己的邮箱作为签署人输入并确认。
  3. 检查你是否收到了 DocuSign 邮件,以及该报价单的“签名”列表是否显示“已发送”。
  4. 签署该文档;确认状态推进(已送达 → 已签署),且该报价单被标记为“已接受”,这表明 DocuSign Connect 已成功到达 CRM。

故障排查

  • 发送时返回 401:访问令牌已过期(DocuSign 的 OAuth 令牌有效期较短)或有误。请生成一个新令牌并重新粘贴。Account ID 和 Base URI 必须来自同一个账户。
  • 账户/URL 错误:请确认 Base URI 是否正确(测试环境为 demo.docusign.net;生产环境为 naX.docusign.net,子域名可在 Apps and Keys 中查看)以及 API Account ID 是否正确。
  • 报价单上的状态不更新:DocuSign Connect 未能到达,或 HMAC 签名不匹配。请在 Admin → Connect 中确认配置是否指向“Webhook URL(DocuSign Connect)”,是否勾选了信封相关事件,以及是否使用与 CRM 中相同的密钥启用了 HMAC。
  • Webhook 被拒绝(签名无效 / 无 HMAC 密钥):出于安全考虑,CRM 只接受已签名的 webhook。如果 CRM 中未填写 Connect HMAC key,或与 DocuSign 使用的密钥不一致,事件将被拒绝。请在两侧使用相同的密钥,并在 Connect 中重新启用 HMAC。
  • 按钮未出现 / 点击后没有任何反应:该集成因缺少凭证而处于未启用状态,或尚未激活。请填写相关字段并点击“激活”。
  • Connect URL 返回 404:该集成已被停用,或 URL 令牌已更改。请重新激活,并在 DocuSign 中重新配置该 URL。

Open this article inside the system →

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

免费创建账户
电子签名(DocuSign) · Sellio