未收到来自 DocuSign API 的事件通知

Question

我正在使用 DocuSign Rest API v2，并且在将复合模板发布到信封端点时没有收到事件通知。这是我的 json 请求的样子：

{ 
    'accountId': '[ommitted]',
    'status': 'sent', 
    'emailSubject': 'XYZ Corp_MSA_Singapore-OU_0.1_2014099.pdf', 
    'compositeTemplates': [
    { 
        'InlineTemplates': [
         { 
             'Sequence': '1', 
             'Recipients': 
             { 
                 'Signers': [ 
                 { 
                     'Email': 'jeff@mattnibecker.com', 
                     'Name': 'Jeff Dunham', 
                     'RecipientID': '1', 
                     'defaultRecipient': 'true', 
                     'ClientUserID': '1' 
                 } 
                 ] 
             } 
         } 
         ], 
         'Document': { 
             'Name': 'XYZ Corp_MSA_Singapore-OU_0.1_2014099.pdf',
             'DocumentId': '1', 
             'transformPdfFields': 'true', 
             'fileExtension': '.pdf' 
         } 
     } 
     ], 
     'EventNotification': { 
         'EnvelopeEvents': [ 
             { 'envelopeEventStatusCode': 'sent' }, 
             { 'envelopeEventStatusCode': 'completed' }, 
             { 'envelopeEventStatusCode': 'delivered' }, 
             { 'envelopeEventStatusCode': 'declined' }, 
             { 'envelopeEventStatusCode': 'voided' } 
         ], 
         'includeDocuments': 'true', 
         'requireAcknowledgement': 'true', 
         'loggingEnabled': 'true', 
         'url': 'http://netsureportalv2public.visusdev.com/DocusignEventListener.svc/EnvelopeEvent' 
    } 
}

api 成功创建了信封和一切。我只是没有收到事件通知。任何帮助将不胜感激。

编辑：忘记包含 accountId

Answer 1

首先，该帐户是否启用了 DocuSign Connect？登录 DocuSign Web 控制台，然后导航到 Preferences >> Features -- 确保 DocuSign Connect 复选框已启用。

验证启用该设置后，故障排除的下一步是确定 DocuSign 是否甚至尝试发送通知 - “连接日志”将提供此信息。要查看连接日志：登录 DocuSign Web 控制台，然后导航到 Preferences >> Connect >> Logs：

单击“日志”链接将显示 DocuSign 尝试发送的最近 100 条消息（通知）的日志条目。例如：

在日志条目列表中，您是否看到与 API 请求发送的信封相关的任何条目？

• 如果是，则表明 DocuSign 确实发送了通知（如您指定的 API 请求），但未从侦听器端点收到确认。这可能表明您的 API 请求很好，但您的侦听器端点存在问题（即，它没有接收和/或确认通知）。单击该日志条目的链接并阅读日志文本的结尾部分。该文本将指示通知尝试的结果（如果通知失败，则应包含某种类型的错误消息）。例如：

• 如果您没有看到任何与您通过 API 请求发送的信封相关的日志条目，那么这可能表明您的 API 请求存在问题 - 即，DocuSign 甚至从未尝试发送通知。

完成我上面描述的故障排除步骤至少应该让您知道在尝试解决此问题时应将注意力集中在哪里。