DocuSign API: веб-крюковые уведомления для встроенных церемоний подписания

Question

Хотя мы можем получать сообщения webhook для подписей электронной почты, похоже, что DocuSign не отправляет событие webhook для встроенной подписи сеанса. Это работает?

Answer 1

События, связанные со встроенным сеансом подписания, - это recipient события против более широких envelope событий. - Убедитесь, что ваша подписка Connect запрашивает правильные события. Например, recient_completed, а не просто envelope_completed.

Кроме того, стратегия очереди Connect по умолчанию обычно объединяет уведомления о событиях, которые происходят почти в одно и то же время.

Например,

1. Знаки получателя 1 (посредством встроенной церемонии или церемонии, инициированной по электронной почте)
2. Конверт завершен (получатель 1 был последним получателем для конверт)

Если вы спрашивали о событиях получателя и конверта, вы, как правило, будете уведомлены об этих двух событиях только один раз.

Если вы хотите получать индивидуальные уведомления для каждого из указанных выше событий, переключитесь на использование очереди SIM-карт для подключения. Это делается на уровне учетной записи через раздел «Обновления» инструмента администрирования eSignature.

Answer 2

Docusign поддерживает события webhook двумя способами -

1. Уровень учетной записи - Connect Configuration: для этого вам необходимо настроить URL-адрес webhook. Go на страницу администрирования Docusign -> в разделе «Интеграции» выберите «Подключиться» -> Добавить конфигурацию -> Пользовательский -> Укажите URL-адрес веб-крючка и инициирующие события. Это будет применяться ко всем конвертам этой учетной записи.

2. Уровень конверта: Добавьте следующее к запросу createEnvelope:

 "eventNotification" : {
  		"URL": "<webhookurl>",
		"loggingEnabled": "true",
		"requireAcknowledgment": "true",
		"useSoapInterface": "false",
		"includeCertificateWithSoap": "false",
		"signMessageWithX509Cert": "false",
		"includeDocuments": "true",
		"includeEnvelopeVoidReason": "true",
		"includeTimeZone": "true",
		"includeSenderAccountAsCustomField": "true",
		"includeDocumentFields": "true",
		"includeCertificateOfCompletion": "true",
		"envelopeEvents": [
			{"envelopeEventStatusCode": "sent"},
		  	{"envelopeEventStatusCode": "delivered"},
		  	{"envelopeEventStatusCode": "completed"},
			{"envelopeEventStatusCode": "declined"},
			{"envelopeEventStatusCode": "voided"}
		],
		"recipientEvents": [
			{"recipientEventStatusCode": "Sent"},
			{"recipientEventStatusCode": "Delivered"},
			{"recipientEventStatusCode": "Completed"},
			{"recipientEventStatusCode": "Declined"},
			{"recipientEventStatusCode": "AuthenticationFailed"},
			{"recipientEventStatusCode": "AutoResponded"}
		]
	}

Это относится только к этому конверту.

Вы можете настроить события, для которых вы хотите, чтобы URL-адрес веб-крючка срабатывал.

DocuSign включает веб-крючок для соответствующих событий с XML, который содержит всю информацию о событиях конверта и получателя. Вы также можете настроить, если вы не хотите получать подписанный документ в XML.

Answer 3

Да, Connect может инициировать события для событий встроенной подписи.

Используете ли вы конфигурацию Connect на уровне учетной записи или EventNotifications на уровне конверта?