有没有一种方法可以实时了解echoSign文档何时成功签署

Question

我还是echoSign API的新手，仍处于学习阶段。我遇到了一些障碍，所以我正在寻求帮助。

所以我有一张表格，里面有一份回声信号文件。它实际上是一个回声信号小部件。将脚本（如下）附加到表单文档主体。

<script type='text/javascript' language='JavaScript' src='https://secure.echosign.com/public/embeddedWidget?wid={widgetID}'></script>

如果他们成功地（使用当前用户会话）签署了小部件，这个特定的小部件是否可以引发事件。我不确定这是否可能。

我知道它可以使用GET /widgets/{widgetId}/agreements从API检索信息。但是，有没有一种方法可以让表单实时了解事件？

感谢您提前提供的帮助。展望未来。

Answer 1

我认为您所要求的是一种回调机制，每当通过小部件创建协议时，该机制都会提醒您的系统。在通过API创建小部件的过程中，您可以指定callBackInfo，这基本上是一个URl，其中echosign将ping您的系统将是最终签名的副本。

以下是此请求参数的详细描述-

callbackInfo（字符串，可选）：一个可公开访问的url，每当出现新的协议事件时，Adobe Sign都会对其执行HTTP GET操作。HTTP身份验证支持使用标准嵌入语法，即。http://username:[e-mail]/path/to/file.Adobe Sign还可以使用HTTP PUT和最终签名的PDF来ping您的系统。请联系

希望这能解决你的问题。

Answer 2

我使用AdobeSign，并使用callbackInfo来获取实时事件。

回调返回小部件Id、与其绑定的协议Id以及小部件的状态。以下是我目前的状态：WIDGET_WAITING_FOR_VERIFICATION、OUT_FOR_SIGNATURE和SIGNED。

希望这能有所帮助。

Answer 3

我意识到这是一个古老的问题。但我遇到了同样的问题，我比正确的文档更早地发现了这个问题：https://www.adobe.io/apis/documentcloud/sign/docs/events.html

如果你有一个带有小部件的iframe，你会在父窗口的MessageEvent中添加一个事件监听器：

function eventHandler(e) {
    if (e.origin == "https://secure.echosign.com") {
        console.log("Event from Adobe Sign!", JSON.parse(e.data)); 
    }else {
        console.log("Do not process this!");
    }
}
window.addEventListener('message', eventHandler);