0

我正在尝试在我的应用程序中管理身份验证失败的案例。我已成功建立 DocuSign Connect 通信并在信封完成或作废时收到来自 DocuSign 的通知。但是现在我有一个身份验证失败的情况(例如在 SMS 身份验证中输入了 3 次错误代码)。在这种情况下,信封为签名者锁定。发生这种情况时,我希望能够向客户服务发送通知。

根据这个答案,可以在 DocuSign Connect 通知中获取此信息,但我没有收到。

在我的情况下,我通过 API(不是全局帐户配置)为每个信封配置通知,如下所示(C#):

envelope.EventNotification = new EventNotification()
{
    Url = _webhookUrl,
    RequireAcknowledgment = "true",
    LoggingEnabled = "true",
    IncludeEnvelopeVoidReason = "true",
    IncludeDocuments = "false",
    IncludeCertificateOfCompletion = "false",
    IncludeCertificateWithSoap = "false",
    IncludeDocumentFields = "false",
    IncludeHMAC = "true",
    IncludeSenderAccountAsCustomField = "false",
    IncludeTimeZone = "true",
    UseSoapInterface = "false",
    EnvelopeEvents = new List<EnvelopeEvent>() {
        new EnvelopeEvent("Draft"),
        new EnvelopeEvent("Sent"),
        new EnvelopeEvent("Delivered"),
        new EnvelopeEvent("Completed"),
        new EnvelopeEvent("Declined"),
        new EnvelopeEvent("Voided") 
    },
    RecipientEvents = new List<RecipientEvent>() {
        new RecipientEvent(null, "Draft" ),
        new RecipientEvent(null, "Sent" ),
        new RecipientEvent(null, "Delivered" ),
        new RecipientEvent(null, "Completed" ),
        new RecipientEvent(null, "Voided" )
    }
};

编辑:我发现在管理员界面中创建全局配置时,有一个额外的可能事件选项“身份验证失败”似乎正是我所需要的!

在此处输入图像描述

但是提供 API 的价值是什么???

此选项甚至没有记录在支持中心https://support.docusign.com/guides/dfs-admin-guide-envelope-recipient-events-ref

有任何想法吗?

4

2 回答 2

0

早在 6 月就创建了错误案例 (CONNECT-1845),我们的工程师目前正在努力解决该问题

于 2020-10-30T14:34:26.123 回答
0

好的,所以我“几乎”在招摇规范(可在此处获得)中找到了存在 AuthenticationFailed 和 AutoResponded 收件人事件的答案。是的,通过添加 AuthenticationFailed 我在 SMS 身份验证失败时收到一个 webhook 调用。所以我的最终事件通知配置如下所示:

envelope.EventNotification = new EventNotification()
{
    Url = _webhookUrl,
    RequireAcknowledgment = "true",
    LoggingEnabled = "true",
    IncludeEnvelopeVoidReason = "true",
    IncludeDocuments = "false",
    IncludeCertificateOfCompletion = "false",
    IncludeCertificateWithSoap = "false",
    IncludeDocumentFields = "false",
    IncludeHMAC = "true",
    IncludeSenderAccountAsCustomField = "false",
    IncludeTimeZone = "true",
    UseSoapInterface = "false",
    EnvelopeEvents = new List<EnvelopeEvent>() { 
        new EnvelopeEvent("Completed"), 
        new EnvelopeEvent("Declined"), 
        new EnvelopeEvent("Voided") 
    },
    RecipientEvents = new List<RecipientEvent>() { 
        new RecipientEvent(null, "AuthenticationFailed"), 
        new RecipientEvent(null, "Completed"), 
        new RecipientEvent(null, "Declined")
    }
};

不幸的是,与 Connect 相关的文档部分非常简单!很多参数没有解释。

经过更多的测试,它仍然无法正常工作。实际上我收到了通知,但是信封状态是“已发送”并且<RecipientAuthenticationStatus />是空的。而且我无法确定发生了身份验证错误。

于 2020-10-28T16:32:26.597 回答