CreateEnvelope 调用中的 DocuSign Connect 与 EventNotification 属性

Question

我们正在与 DocuSign 集成，用户可以将存储在我们系统中的文档提交给 DocuSign 以获得文档签名。我们的模拟账户中有 DocuSign Connect 功能。我们可以成功处理来自 DocuSign 的消息。

我们担心让用户自己添加连接配置对某些人来说可能太具有挑战性，而且容易出错。

我现在在文档中看到，当我们调用 createEnvelope 时，可以通过在 EventNotification 属性中传递信息来自动让 DocuSign 推送通知。这是从 DocuSign 获取推送通知的可接受方式吗？这会导致集成认证出现问题吗？

是否有任何其他方法可以在客户帐户中轻松配置 Connect？

Answer 1

这是一个老问题，但我希望记录有答案，因为它对可能正在阅读本文的任何人都很重要。

We see now in the documentation that it is possible to automatically get DocuSign to push notifications by passing the information in the EventNotification attribute when we call createEnvelope. Is this an acceptable way to get push notifications from DocuSign?

是的，是的。事实上，这是一个非常好的方法，可以减少轮询并使您的应用程序更好。我们强烈建议您使用 EvenNotification 并注册通过 webhook 到您的应用程序的事件，这样您就可以仅在它们发生时在您的代码中处理它们，而不是重复轮询 DocuSign API。

Will this cause issues with getting the integration certified?

反之亦然。如果您使用轮询，您可能会遇到认证问题。将连接事件与 webhook 结合使用是避免过度轮询的一种方法，因为过度轮询可能会导致认证问题。

Is there any other way to get Connect configured easily in customer accounts?

您可以按照建议在信封级别使用 EventNotification 配置连接。这种方法适用于 ISV，因为您不需要您的客户对其帐户具有管理员访问权限。 另一个选项是帐户级别的连接配置，它确实需要管理员级别的访问权限，并且还有一些其他限制。此方法为帐户中的所有信封添加连接 webhook。因此，它可能会更好，也可能不会更好，具体取决于您的情况。