电子签名（Clicksign）

使用您自己的 Clicksign 账户（BYO 模式）发送报价单以进行电子签名。

电子签名集成与 Clicksign 使用的是您自己的 Clicksign 账户（BYO 模式：您自带账户）。文档在您的 Clicksign 账户中创建并计费：我们这边不产生任何费用、加价或中间环节。我们只负责接通字段和发送报价单以进行签名的按钮。

该集成一开始处于未启用状态：在您填写字段并激活之前不会发生任何操作。access token 和 webhook secret 会在 CRM 中加密存储，且永远不会再显示出来。

前提条件

• 拥有具备 API 权限的 Clicksign 账户（用于测试的 Sandbox，或 Production 正式环境）。
• 可访问 Clicksign 控制台以生成 access token（Settings → API），并创建带有 HMAC secret 的 webhook。
• 在 Sellio 中拥有管理员权限，以便在 Settings → Integrations 中保存凭据并激活该集成。

需要填写的内容

• 环境（Environment）：Sandbox（用于测试，地址为 sandbox.clicksign.com）或 Production（正式环境，地址为 app.clicksign.com）。每个环境都有各自独立的 access token。
• Access token：在 Clicksign 控制台的 Settings → API 下生成的 API access token，用于验证调用身份（通过 ?access_token=）。它会在 CRM 中加密存储。
• Webhook secret（HMAC）：您在 Clicksign 中创建 webhook 时自行设定的密钥，用于验证 Clicksign 发给我们的事件的 HMAC-SHA256 签名。它会在 CRM 中加密存储。

如何配置

1. 打开 Settings → Integrations，找到“电子签名（Clicksign）”卡片。
2. 选择环境，粘贴 Access token 和 Webhook secret，然后点击“保存凭据”。
3. 复制页面上出现的“Webhook URL（Clicksign）”，并在 Clicksign 的 Settings → API/Webhooks 中创建一个指向该 URL 的 webhook，使用完全相同的 secret。
4. 返回 CRM，点击“激活”。

如何发送报价单以进行签名

1. 打开一个商机，进入“报价单”部分。
2. 在所需版本上，点击“签名”，输入签署人的邮箱（姓名可选填）。
3. 如果您同时启用了 DocuSign 和 Clicksign，会出现两个按钮（“通过 DocuSign 发送”和“通过 Clicksign 发送”），请选择 Clicksign。如果只启用了 Clicksign，单个按钮就会直接使用它。
4. CRM 会在 Clicksign 中创建文档、添加签署人并发起签名请求；Clicksign 会向签署人发送签名邮件。
5. 随着签署人操作的推进，状态会显示在报价单的“签名”列表中（已发送 → 已送达 → 已签署）。

如何测试

1. 使用 Sandbox 环境和 sandbox 的 access token。
2. 在某个报价单上点击“签名”，将签署人填写为您自己的邮箱并确认。
3. 确认您收到了 Clicksign 的邮件，且“签名”列表显示“已发送”。
4. 签署该文档，检查状态是否推进为“已签署”，并且报价单被标记为已接受，这表明（带有效 HMAC 的）webhook 已经到达。

故障排查

• 发送时出现 401：access token 错误，或来自另一个环境（在生产环境中使用了 sandbox 的 token，反之亦然）。请确认环境设置，并为该环境重新粘贴正确的 token。
• 报价单状态没有更新：webhook 没有送达，或签名验证失败。请确认 Clicksign 中的 webhook 指向的是“Webhook URL（Clicksign）”，并且使用的 secret 与 CRM 中保存的完全一致（Content-Hmac 请求头，HMAC-SHA256）。
• 事件被拒绝（签名无效）：Clicksign 与 CRM 两端的 webhook secret 不一致。请在两边保存相同的值。
• 发送时没有任何反应：该集成由于缺少凭据或未被激活而处于未启用状态。请填写环境 + token + secret，并点击“激活”。

Open this article inside the system →