简体   繁体   English

没有从DocuSign API接收事件通知

[英]Not receiving event notifications from DocuSign API

I'm using the the DocuSign Rest API v2 and am not receiving event notifications when posting a Composite Template to the envelope endpoint. 我正在使用DocuSign Rest API v2,并且在将复合模板发布到信封端点时没有收到事件通知。 Here's what my json request looks like: 这是我的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' 
    } 
}

The api is successfully create the envelope and everything. api已成功创建信封和所有内容。 I'm just not getting event notifications. 我只是没有收到事件通知。 Any help would be greatly appreciated. 任何帮助将不胜感激。

EDIT: Forgot to include accountId 编辑:忘记包括accountId

First, is DocuSign Connect enabled for the account? 首先,是否为该帐户启用了DocuSign Connect? Log into the DocuSign web console, then navigate to Preferences >> Features -- ensure that the DocuSign Connect checkbox is enabled. 登录到DocuSign Web控制台,然后导航到“首选项” >>“功能” -确保已启用“ DocuSign Connect”复选框。

DS Connect

Once that setting is verified enabled, next step in troubleshooting is to determine whether or not DocuSign even attempted to send the notification -- the "Connect Logs" will provide this information. 一旦确认启用该设置,故障排除的下一步就是确定DocuSign是否甚至尝试发送通知-“连接日志”将提供此信息。 To view the Connect Logs: log into the DocuSign web console, then navigate to Preferences >> Connect >> Logs : 要查看“连接日志”:登录DocuSign Web控制台,然后导航至“首选项” >>“连接” >>“日志” 日志

Clicking the "Logs" link will show you the log entries for the most recent 100 messages (notifications) that DocuSign attempted to send. 单击“日志”链接将为您显示DocuSign尝试发送的最近100条消息(通知)的日志条目。 For example: 例如:

连接日志

In the list of log entries, do you see any entries that are related to the Envelope that the API request sent? 在日志条目列表中,您是否看到与API请求发送的信封相关的任何条目?

  • If yes, that indicates that DocuSign did send the notification (as your API request specified), but no acknowledgement was received back from the listener endpoint. 如果是,则表明DocuSign确实发送了通知(按照您的API请求指定),但是没有从侦听器端点收到回确认。 This likely indicates that your API request is fine, but there's a problem with your listener endpoint (ie, it didn't receive and/or acknowledge the notification). 这可能表明您的API请求很好,但是侦听器端点存在问题(即,它没有收到和/或确认通知)。 Click on the link for that log entry and read the ending portion of the log text. 单击该日志条目的链接,然后阅读日志文本的结尾部分。 That text will indicate the outcome of the notification attempt (and should include some type of error message if the notification failed). 该文本将指示通知尝试的结果(如果通知失败,则应包括某种类型的错误消息)。 For example: 例如: 错误讯息

  • If you don't see any log entries related to the Envelope you sent via the API request, then this likely indicates a problem with your API request -- ie, DocuSign never even attempted to send the notification. 如果您没有看到与通过API请求发送的信封相关的任何日志条目,则可能表明您的API请求存在问题-即DocuSign从未尝试过发送通知。

Going through the troubleshooting steps that I've described above should at least let you know where to focus your attention as you attempt to resolve this issue. 通过上面介绍的故障排除步骤,至少应让您知道尝试解决此问题时应集中精力在哪里。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM