如何基于DocuSign模板创建面对面签署（In Person Signing）会话？

你遇到的问题核心是：使用TemplateRole配置时未显式指定收件人类型为inPersonSigner，导致DocuSign将该角色识别为普通远程签署人，因此没有触发面对面签署特有的主机身份提示流程。

修正后的信封配置代码 #

return new EnvelopeDefinition()
{
    TemplateId = templateId,
    EmailSubject = subject,
    Status = "Sent",

    TemplateRoles = new List<TemplateRole>
    {
        new TemplateRole()
        {
            Name = inPersonSignerHostName,
            Email = inPersonSignerHostEmail,
            InPersonSignerName = recipientName,
            // 必须添加：显式声明此角色为面对面签署人
            RecipientType = "inPersonSigner",
            ClientUserId = _authSettings.UserId,
            RoleName = "Customer",
            Tabs = SetTabValues(
                textTabs: recipientTextTabs
            )
        }
    }
};

关键修改说明 #

• 添加RecipientType = "inPersonSigner"：这是触发面对面签署流程的核心配置。默认情况下TemplateRole的收件人类型为普通signer，必须显式指定为inPersonSigner，DocuSign才会识别为面对面签署场景。
• 保持Name、Email、ClientUserId与RecipientViewRequest中的参数完全一致，确保签署会话能正确关联到主机账户。

验证步骤 #

1. 用修正后的代码创建并发送信封
2. 调用CreateRecipientView接口获取签署URL
3. 访问URL后，系统会弹出主机身份验证提示，进入正常的面对面签署流程

额外注意事项 #

• 确认模板中的目标角色（此处为Customer）没有设置远程签署专属限制
• 你的RecipientViewRequest配置无需修改，保持原有参数即可

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