DocuSign: можно ли отправить пользовательскую полезную нагрузку по ссылке PowerForm и вернуть ее через webhook?

Question

Я интегрируюсь с API DocuSign, и мне интересно, возможно ли реализовать следующий сценарий:

1. ПОЛУЧИТЬ PowerForm для получения его URL-адреса
2. Присоединить пользовательскую полезную нагрузку кURL-адрес (например, некоторые строковые и кодированные в формате JSON)
3. Отправить URL-адрес пользователю
4. Попросить пользователя подписать документы, прикрепленные к шаблону PowerForm
5. Получить обратный вызов на мойwebhook
6. Как-то восстановить пользовательскую нагрузку

Контекст таков: я хочу отправить конкретному пользователю документ для подписи, а когда он это сделает - распознать его конкретное уведомление.И это будет частью чата через SMS или Skype (чатбот), поэтому обратный URL не очень хороший вариант.

Я смотрел в направлении API пользовательских полей шаблона, потому что вы можете заполнитьих используя URL.Но похоже, что настраиваемые поля должны быть видны в документе, пока он подписан, и это создает проблему - наличие чего-то вроде dfd84fc1-317f-4939-9dfb-4350d2127d2f (даже «звездочка») будет плохим UX для конечного пользователя.

Это первый раз, когда я работаю с API DocuSign, и я надеюсь, что мне просто чего-то не хватает в основных понятиях ... Поэтому я публикую этот вопрос.

Answer 1

Вы можете использовать пользовательское поле шаблона с текстом, окрашенным в белый цвет, чтобы соответствовать фону.Текст все равно будет «записан» в документ (его можно найти с помощью ctrl-f), но он не будет показан подписавшему.

В качестве альтернативы вы можете использовать настраиваемое поле конверта - они не видны подписавшему, они не записываются в документ, но сохраняются как «метаданные», доступные через API.По https://docs.docusign.com/DocuSignHelp/Content/populate-custom-fields.htm:

Envelope Field: To populate an envelope field in the Web PowerForm, add the following text in the URL:
EnvelopeField_<EnvelopeFieldName>=<value>
Where <EnvelopeFieldName> is the name of the envelope field in the Web PowerForm and the <value> is the value you want in the field.
Example: EnvelopeField_Region=Northwest

Вы можете получить эту информацию с помощью вызова

GET /v2/accounts/{accountId}/envelopes/{envelopeId}/custom_fields

в соответствии с https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeCustomFields/list

Также доступны пользовательские поля конвертов.включены в публикацию Connect