Docusign API 使用 TemplateRole 发送带有 SMS 的信封
Docusign API Sending an envelope with SMS using TemplateRole
这是关于 DocuSign Java 客户端库的。
使用 Docusign Java 客户端发送带有 SMS 的信封的各种方式有哪些?我知道 com.docusign.esign.model.Signer
class 中的 setAdditionalNotifications()
方法。我可以在其中分配一个 com.docusign.esign.model.RecipientPhoneNumber
的对象。
但是根据代码示例,如果我们使用现有模板创建信封,那么我们必须使用 com.docusign.esign.model.TemplateRole
对象而不是 Signer
对象。由于我的应用程序使用模板而不是硬编码的 PDF 作为文档,我正在寻找一种方法,例如 TemplateRole
class 中的 setAdditionalNotifications()
。但是找不到。
使用现有模板发送带有 SMS 的信封的最佳方法是什么。代码片段也会有所帮助。
通常情况下,如果没有短信,您可以使用 TemplateRole,但如果您需要短信通知,那将不起作用。在这种情况下,您将不得不进行多次 API 调用。
首先 - 从模板创建信封。没有其他的。
然后,您使用类似于下面的代码来更新收件人。
最后,您通过第三次 API 调用
发送它
/* example of signer and cc */
Signer signer = new Signer();
signer.setEmail(args.getSignerEmail());
signer.setName(args.getSignerName());
signer.setRecipientId("1");
signer.setRoutingOrder("1");
signer.setTabs(signerTabs);
RecipientAdditionalNotification smsDelivery = new RecipientAdditionalNotification();
smsDelivery.setSecondaryDeliveryMethod("SMS");
RecipientPhoneNumber phoneNumber = new RecipientPhoneNumber();
phoneNumber.setCountryCode(args.getCountryCode());
phoneNumber.setNumber(args.getPhoneNumber());
smsDelivery.phoneNumber(phoneNumber);
signer.setAdditionalNotifications(Arrays.asList(smsDelivery));
// Create a cc recipient to receive a copy of the documents, identified by name and email
CarbonCopy cc = new CarbonCopy();
cc.setEmail(args.getCcEmail());
cc.setName(args.getCcName());
cc.setRecipientId("2");
cc.setRoutingOrder("2");
RecipientAdditionalNotification ccSmsDelivery = new RecipientAdditionalNotification();
ccSmsDelivery.setSecondaryDeliveryMethod("SMS");
RecipientPhoneNumber ccPhoneNumber = new RecipientPhoneNumber();
ccPhoneNumber.setCountryCode(args.getCcCountryCode());
ccPhoneNumber.setNumber(args.getCcPhoneNumber());
ccSmsDelivery.phoneNumber(ccPhoneNumber);
cc.setAdditionalNotifications(Arrays.asList(ccSmsDelivery));
/* missing code - build recipients object and add items above */
envelopesApi.UpdateRecipients(accountId, envelopeId, recipients);
这是关于 DocuSign Java 客户端库的。
使用 Docusign Java 客户端发送带有 SMS 的信封的各种方式有哪些?我知道 com.docusign.esign.model.Signer
class 中的 setAdditionalNotifications()
方法。我可以在其中分配一个 com.docusign.esign.model.RecipientPhoneNumber
的对象。
但是根据代码示例,如果我们使用现有模板创建信封,那么我们必须使用 com.docusign.esign.model.TemplateRole
对象而不是 Signer
对象。由于我的应用程序使用模板而不是硬编码的 PDF 作为文档,我正在寻找一种方法,例如 TemplateRole
class 中的 setAdditionalNotifications()
。但是找不到。
使用现有模板发送带有 SMS 的信封的最佳方法是什么。代码片段也会有所帮助。
通常情况下,如果没有短信,您可以使用 TemplateRole,但如果您需要短信通知,那将不起作用。在这种情况下,您将不得不进行多次 API 调用。 首先 - 从模板创建信封。没有其他的。 然后,您使用类似于下面的代码来更新收件人。 最后,您通过第三次 API 调用
发送它/* example of signer and cc */
Signer signer = new Signer();
signer.setEmail(args.getSignerEmail());
signer.setName(args.getSignerName());
signer.setRecipientId("1");
signer.setRoutingOrder("1");
signer.setTabs(signerTabs);
RecipientAdditionalNotification smsDelivery = new RecipientAdditionalNotification();
smsDelivery.setSecondaryDeliveryMethod("SMS");
RecipientPhoneNumber phoneNumber = new RecipientPhoneNumber();
phoneNumber.setCountryCode(args.getCountryCode());
phoneNumber.setNumber(args.getPhoneNumber());
smsDelivery.phoneNumber(phoneNumber);
signer.setAdditionalNotifications(Arrays.asList(smsDelivery));
// Create a cc recipient to receive a copy of the documents, identified by name and email
CarbonCopy cc = new CarbonCopy();
cc.setEmail(args.getCcEmail());
cc.setName(args.getCcName());
cc.setRecipientId("2");
cc.setRoutingOrder("2");
RecipientAdditionalNotification ccSmsDelivery = new RecipientAdditionalNotification();
ccSmsDelivery.setSecondaryDeliveryMethod("SMS");
RecipientPhoneNumber ccPhoneNumber = new RecipientPhoneNumber();
ccPhoneNumber.setCountryCode(args.getCcCountryCode());
ccPhoneNumber.setNumber(args.getCcPhoneNumber());
ccSmsDelivery.phoneNumber(ccPhoneNumber);
cc.setAdditionalNotifications(Arrays.asList(ccSmsDelivery));
/* missing code - build recipients object and add items above */
envelopesApi.UpdateRecipients(accountId, envelopeId, recipients);