DocuSign - Как получить URL, который длится дольше, чем несколько минут?

Question

Я использую DocuSign REST Api и заметил, что время жизни URL, полученного с помощью API EnvelopeViews (https://developers.docusign.com/esign-rest-api/reference/Envelopes/EnvelopeViews/createRecipient), составляет всего несколько минут. Однако в прошлом я получал электронные письма со ссылками DocuSign. КакМогут ли эти ссылки быть добавлены в электронное письмо (и, следовательно, имеют более длительный срок действия)?

Существует ли отдельный API, который можно использовать для получения ссылки с более длительным сроком действия, такой как ссылка в электронном письме?

Например, вот электронное письмо, содержащее Документ проверки Ссылка DocuSign:

Answer 1

Хороший вопрос. Вот что вы можете сделать.

1. Ваше приложение хочет, чтобы Ларри подписал документ, используя Вызов EnvelopViews :: createRecipient API.
2. Ваше приложение должно хранить детали, необходимые для вызова API, в базе данных вашего приложения. Что-то вроде: envelopeId, signerEmail, clientUserId.
3. Создайте направляющую для записи базы данных и добавьте ее в запись базы данных.
4. Теперь вы можете искать запись базы данных с помощью ключа строки или через гид. Убедитесь, что столбец базы данных guid проиндексирован.

5. Теперь создайте URL-адрес подписи, который вы отправите Ларри. Что-то вроде:

   https://myapplication.example.com/docusign-ceremony/[guid]

6. Отправьте адрес Ларри
7. Когда Ларри нажимает на URL:
   1. Ваше приложение вызывается
   2. Найдите guid в URL в вашей базе данных. Вы должны найти запись, которую вы там хранили.
   3. Получить всю информацию о записи: envelopeId, signerEmail, clientUserId.
   4. Вызовите вызов API EnvelopeViews :: createRecipient с данными. и получите URL-адрес церемонии подписания (который должен быть использован в 5 минут)
   5. Перенаправить браузер пользователя на URL.
   6. Они подпишут документ (ы), а затем будут перенаправлены обратно на ваш применение.
   7. Готово.

И угадайте что? Это почти то, что DocuSign делает сам.

Answer 2

Пожалуйста, исправьте меня, если я ошибаюсь, но я думаю, что ваша цель - создать URL-адрес просмотра получателя, создать электронное письмо, отформатированное определенным образом, и отправить это письмо получателям.

Если вы используете функцию брендинга, вы можете указать формат вашей электронной почты (если вы хотите использовать конкретное сообщение) и просто отправить конверт своим получателям. Как только получатели получат электронное письмо, они увидят сообщение в указанном вами формате, а ссылка для доступа к конверту станет обычной ссылкой DocuSign, срок действия которой не истекает.

Ссылка ниже показывает, как создавать бренды в вашем аккаунте. В частности, подписание брендов позволит вам установить содержание электронной почты.

Если у вас несколько форматов электронной почты, вы можете создать несколько брендов и просто указать brandId при создании конверта.

Надеюсь, это поможет.

Брендинг: https://support.docusign.com/guides/ndse-admin-guide-configure-branding

Answer 3

Ответ от Ларри К выше верен, вам нужно справиться с этим на вашей стороне.

Это все параметры, которые вы можете отправить как часть тела запроса для конечной точки API POST {vx} / accounts / {accountid} / envelopes / {envelopeid} / views / получателя, и нет параметров для установки срок действия созданного вами представления получателя.

Вы можете изучить использование PowerForms, чтобы убедиться, что они соответствуют вашим потребностям. С помощью PowerForms вы можете создать URL, по которому пользователи смогут щелкать, и это позволит им заполнить определенный конверт DocuSign. Это может не соответствовать вашим потребностям, если вам нужно предварительно заполнить некоторые поля информацией, относящейся к конкретному получателю, но на это стоит обратить внимание.

Документация PowerForms: https://www.docusign.com/features-and-benefits/features/powerforms