【发布时间】:2021-08-15 01:08:52
【问题描述】:
DocuSign webhook 每条消息发送 1 个信封。它还可以返回已配置的相应子实体(例如文档、收件人)。
我还想在消息中接收信封的审核事件(当有人打开或查看时)。
有可能吗?还是只能通过轮询?推荐的策略是什么?
【问题讨论】:
-
感谢您的提问!请接受(检查)您问题的最佳答案。谢谢!
标签: node.js docusignapi digital-signature
DocuSign webhook 每条消息发送 1 个信封。它还可以返回已配置的相应子实体(例如文档、收件人)。
我还想在消息中接收信封的审核事件(当有人打开或查看时)。
有可能吗?还是只能通过轮询?推荐的策略是什么?
【问题讨论】:
标签: node.js docusignapi digital-signature
DocuSign webhook 通知消息按webhook event 发送。在信封级别(草稿、已发送、已交付、已完成、已拒绝或已作废)和每个收件人(已发送、已交付、已完成、已拒绝、AuthenticationFailed 和 AutoResponded)都有事件。
recipient viewing 信封的审计事件可作为Delivered recipient 事件使用。
还有其他审计事件不能作为 webhook 事件使用。要跟踪那些你需要投票的人。请记住每个信封每 15 分钟轮询一次的 DocuSign 限制。 (以及每小时 1000 次调用的整体 API 限制。)
如果您订阅了 recipient.Delivered 事件,那么当收件人查看信封时,您将收到一条 webhook 消息。查看收件人的Delivered 日期戳和Delivered 状态。
但是如果您将 webhook 系统设置为聚合通知消息(默认设置),那么单个通知可能会聚合在一起。例如,如果您同时订阅收件人已交付和已完成的事件,并且收件人打开(已交付)然后立即签署(已完成)信封,您可能只会收到一个通知,用于稍后(已完成)的事件。
但是您的代码可以查找已交付的日期戳以查看信封是否已交付。
【讨论】:
Delivered 日期戳是否为后续视图更新。请测试一下并告诉我们!