没有 webhook 调用已删除的草稿信封答案

【问题标题】：No webhook calls for deleted draft envelopes没有 webhook 调用已删除的草稿信封
【发布时间】：2017-12-06 21:52:53
【问题描述】：

我在Deleted Draft Envelopes have inaccurate status 看到了这个关于deleted drafts 的问题，但我想检查一下 webhook 是否也是如此。

如果我从我的应用程序在 DocuSign 中创建 Draft Envelope，然后用户在 DocuSign 中删除该 Envelope，是否会触发任何 webhook 事件？

这些是我在创建草稿信封或发送信封时指定的事件通知：

{
  "eventNotification": {
    "envelopeEvents": [
      { "envelopeEventStatusCode": "completed" },
      { "envelopeEventStatusCode": "declined"  },
      { "envelopeEventStatusCode": "voided"    }
    ]
  }
}

删除草稿后，我没有收到任何 webhook 调用。

但是当发送信封和

时，我确实收到了来自 Docusign 的 webhook 调用

已完成
拒绝
作废

【问题讨论】：

标签： docusignapi

【解决方案1】：

您链接到的其他 SO 帖子 (Deleted Draft Envelopes have inaccurate status) 中描述的行为是“设计使然”。也就是说，当创建/保存（但未发送）新信封时，它被视为草稿信封，其状态将为 created。如果草稿信封随后被删除而从未发送，则其状态仍将是created -- 没有明显的状态值指示已删除草稿信封。

由于 webhook 响应信封（或收件人）状态的变化而触发，并且在删除草稿信封时状态没有变化，因此在删除草稿信封时您将永远不会收到 webhook 通知。

您在帖子中描述的行为是“设计使然”（正如预期的那样），即您指定的事件通知和您为响应指定的 Envelope 事件而收到的 webhook 调用。

【讨论】：

感谢您的快速回复，我只是想仔细检查一下这是否是设计。我对此还有一个问题，但我不确定是否应该发布一个新问题...如果我单击删除 DocuSign 中的草稿，我将收到消息 已删除的信封仅保留在已删除的垃圾箱中很短的时间，之后它们将被永久删除。。当信封草稿被永久移除时会发生什么？
那么 webhook 会触发吗？
当草稿信封从 已删除的 bin 中自动清除（删除）时，信封状态不会发生任何变化（信封只是停止存在），因此不会触发任何 webhook。

【解决方案2】：

您能否描述一下您希望在删除草稿信封时通知您的软件应用程序的用例？

【讨论】：

感谢您对此进行调查！用户在我的应用程序中创建合同。然后他们可以创建多个信封并将其发送到 DocuSign（使用不同的签名者/收件人，稍微修改生成的 pdf）。所以我想从 DocuSign 跟踪这些信封的状态，并在我的应用程序中更新信封的状态。当从 DocuSign 发送信封时，webhook 可以正常工作并正确更新状态。但是，当 DocuSign 中的信封草稿状态发生更改时，我也想知道这一点并在我的应用程序中更新信封。所以我可以阻止他们对那些信封进行操作。
我应该创建一个新问题并描述我正在尝试做的事情吗？
我相信我理解：您希望在用户使用 DocuSign Web 工具删除草稿信封时收到通知。我们现在没有那个。我已将其添加到增强列表中。我们不会很快拥有它。有关您的用例和可能的解决方案的更多讨论，请提出另一个问题。谢谢。 @ljubadr
是的，这就是我的情况。通知会让事情变得更容易一些。但我想如果发生这种情况，我会处理 DocuSign api 错误并更新我的身边。谢谢你的信息！