在目标c中创建DocuSign事件通知Web挂钩

Question

我正在尝试实现Web钩子方式来了解DocuSign信封的状态，但找不到任何Objective-c代码。请帮忙。我也读了Using a webhook to track envelope status。如何创建Web挂钩网址以便docusign将该网址调用？

Answer 1

您提出了两个问题：

• 如何在我的信封中包含eventNotification对象：使用Objective-C SDK时创建请求？

• 如何创建DocuSign将调用的Web挂钩URL？

我可以帮助解决第二个问题。

您需要创建 webhook侦听器。它可以是DocuSign Signature平台可以调用的Web应用程序。您可以用任何语言编写webhook监听器应用程序，它可以在任何软件堆栈上运行。

对于任何webhook都是如此，不寻常的问题是DocuSign会调用您的监听应用程序。调用它时，您的应用程序无论如何都可以处理传入的信息。

您的应用程序的监听网址必须在公共互联网上提供，因此可以通过DocuSign平台访问。对于测试和开发，您可以使用ngrok或类似服务为开发服务器/计算机提供公共Internet地址。

为iOS开发？

请记住，iPhone / iPad在公共互联网上没有地址。因此，您的webhook地址无法在这些计算机上运行。但是你的webhook监听器可以在移动应用程序轮询的其他服务器上。

如果您需要更多帮助，请提出其他问题。

在回复评论时添加

  

因此，当状态发生变化时，DocuSign将调用我的Web挂钩并提供XML响应，然后我的应用程序将必须轮询Web挂钩以获取响应。所以我将轮询网络钩子，而不是DocuSign。我对吗？

右：如果您的应用程序位于不允许传入请求的设备/堆栈上（例如移动应用程序），那么您可以设置服务器作为网关：当信封或收件人状态发生变化时，DocuSign调用在您的网关上运行的webhook侦听器。

然后您的应用可以根据需要随时轮询您的网关。你也有其他选择：

1. 您的应用程序本身可以每15分钟（或更少的时间）轮询一次DocuSign。
2. 设置网关，但您的应用可以使用Firebase messaging或专为移动应用设计的替代推送服务，而不是您的应用轮询网关。您的网关将从DocuSign接收传入的webhook消息，然后使用推送服务分发它们。

  

此外，我尝试使用部署到git hub上的Heroku链接在php中设置我的Web挂钩，但我如何根据我的需要自定义它？这是DocuSign在这种情况下调用的Web钩子URL吗？

您可以通过克隆（或只是下载）配方软件来自定义配方示例。然后根据需要修改它。如果您想在Heroku上运行您的应用程序，请参阅Heroku文档。或者您可以在自己的计算机上运行该软件，并使用ngrok获取公共URL。

配方示例包括作为信封：创建呼叫的一部分提供给DocuSign的地址。我在新的配方框架中使webhook地址更加明显。见github repo。使用导航栏中的选项链接查看详细信息。