Salesforce沙箱中DocuSign信封模板Document writeback功能失效

1. 检查DocuSign Connect核心配置 #

• 确认已启用DocuSign Connect，且配置的触发事件包含「Envelope Completed」——这是文档回写的基础依赖
• 验证Connect中的Salesforce对象映射是否匹配源记录类型（比如源记录是Opportunity，需对应到Opportunity对象）
• 查看Connect日志，排查是否存在回写请求失败的记录（如权限不足、字段映射错误等）

2. 验证权限与字段映射 #

• 确认DocuSign集成用户拥有创建Attachment/Note记录的权限，同时具备目标Salesforce记录的读写权限
• 检查源记录的页面布局，确认「Notes and Attachments」相关列表已添加（避免回写成功但未显示）
• 验证信封发送时关联的Salesforce记录ID正确，未被错误覆盖

3. 核对模板回写设置 #

• 重新确认模板中「Document writeback to salesforce record」选项已保存生效，部分场景下编辑后可能未正确保存
• 检查模板是否设置了回写过滤条件（如仅回写特定文档），或指定了错误的回写类型（Attachment/Note）
• 确认发送信封时未取消「关联到Salesforce记录」选项，该操作会覆盖模板设置

4. 排查Salesforce端自动化规则 #

• 检查目标对象是否有触发器、流程或验证规则阻止Attachment/Note创建（如必填字段未填充、触发器抛出异常）
• 查看Salesforce的「审计跟踪」或「调试日志」，过滤DocuSign集成用户的操作，定位记录创建失败的具体原因

5. 基础连通性测试 #

• 发送最简测试信封：单个文档+测试Salesforce记录，关闭自定义自动化规则后重试
• 重新授权DocuSign与Salesforce的集成，排除认证令牌过期导致的连通问题

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