2016-05-16 7 views
1

Ich habe den Code geschrieben, die Umschläge verwendet wie in diesem Tutorial eine Signatur vom Client anzufordern:Wie kann ich einen Web-Hook einrichten, um den DocuSign Envelope-Status zu überprüfen?

https://www.docusign.com/developer-center/recipes/request-a-signature-via-email-using-a-template

Meine Frage ist, wie kann ich eine Web-Haken URL definieren, die verwendet werden können, aktualisieren der Status des Umschlags? Ich möchte benachrichtigt werden und in der Lage sein, den Umschlagstatus in meiner Datenbank zu aktualisieren, sobald der Kunde die Dokumente unterschreibt. Ist das möglich?

Stellt die EnvelopeDefinition-Klasse eine Eigenschaft zur Verfügung, mit der ich die URL des Web Hooks definieren kann?

Antwort

5

Die webhook recipe zeigt, wie das EventNotification Objekt innerhalb der Hülle Erzeugungsanforderung aufzunehmen.

Added

Die format of the webhook XML messages is documented.

Hinweis Der Connect-Leitfaden (März 2016, Datum auf Seite 2) ist alt und in vielen Fällen falsch. Ein neuer Leitfaden ist in Produktion. Dieser Leitfaden ist nützlich für die Informationen zum XML-Format.

WSDL-Datei, einschließlich der Benachrichtigungsmeldungen Format available.

ist die XML-Nachrichten zu sehen, die zurückgegeben werden, gibt es Proben von Benachrichtigungen für sent und delivered Status.

Und schließlich the recipe can be run, for free, on Heroku.

(Sie müssen ein developer's account and integration key, all free, from DocuSign.)

Wenn Sie es auf Heroku ausführen, können Sie die eingehenden Benachrichtigungsmeldungen sehen.

+0

Das ist großartig, aber ich sehe, dass es eine Art XML zurückgibt. Gibt es einen Ort, an dem ich sehen kann, wie dieses XML aussieht? Es ist irgendwie schwer, eine Methode zu schreiben, um das zu verarbeiten, wenn ich nicht sehen kann, was auf meiner Netzhakenmethode bekannt gegeben wird ... – Marko

+0

Sehen Sie meine geänderte Antwort –

+0

@LarryK Link wird gesprengt ... Ich habe überall gesucht für dieses XML-Schema. –

3

Es gibt zwei Möglichkeiten, dies zu tun.

One ist ein Konto breit Connect-Konfiguration innerhalb des DS WebApp einzurichten, wird dies die angeforderten Ereignisbenachrichtigungen auf jedem Umschlag gesendet/vervollständigte an die URL senden: https://www.docusign.com.au/sites/default/files/connect-guide_0.pdf#page=5

Sie können dies auch mit der pro Umschlag definieren eventNotification-Parameter Der Parameter wird jedoch nicht in die bereitgestellten Rezepte übernommen. EDIT: Ich stehe korrigiert, siehe Larrys Antwort unterhttps://www.docusign.com.au/p/RESTAPIGuide/Content/REST%20API%20References/Send%20an%20Envelope.htm