使用DocuSign Java SDK通过WhatsApp发送信封遇400错误求助

问题重现 #

使用docusign-esign-java 3.16.1版本SDK，设置代码：

additionalNotification.setSecondaryDeliveryMethod("WhatsApp")

触发400错误，响应内容：

EXError while requesting server, received a non successful HTTP code 400 with response Body: '{"errorCode":"ADDITIONAL_NOTIFICATION_CHANNEL_NOT_SUPPORTED","message":"The Additional Notification channel is not supported. Envelope definition should not have additional notification channel: WhatsApp for recip 1"}'

原因及解决方案 #

• 账号未开通WhatsApp通知权限：DocuSign的WhatsApp通知功能并非默认开放，需满足两个条件：
  1. 账号套餐为Business Pro或更高等级；
  2. 必须联系DocuSign官方支持团队申请启用该功能，这是导致错误的核心原因。
• 检查接收人信息格式：确保接收人的WhatsApp号码是带国际区号的完整格式（例如+1234567890），且该号码已在DocuSign系统中完成验证。
• 完善API参数配置：仅设置secondaryDeliveryMethod是不够的，需关联正确的接收人ID并指定通知类型，示例完整代码：

AdditionalNotification additionalNotification = new AdditionalNotification();
additionalNotification.setSecondaryDeliveryMethod("WhatsApp");
additionalNotification.setRecipientId("1"); // 对应接收人的ID
additionalNotification.setNotificationType("signing"); // 指定通知类型为签名请求

EnvelopeDefinition envelopeDefinition = new EnvelopeDefinition();
envelopeDefinition.setAdditionalNotifications(Arrays.asList(additionalNotification));

• SDK版本兼容（可选）：虽然3.16.1版本理论支持该参数，但建议升级到最新稳定版SDK，避免潜在的版本兼容问题。

内容的提问来源于stack exchange，提问作者Igor