如何通过DocuSign API利用已有Envelope ID发送邮件签名请求？

核心实现逻辑 #

要发送已创建但未发送的信封，只需调用DocuSign eSign API的信封更新接口，将信封状态从created修改为sent即可触发签名请求发送。

替换原有代码（替换生成Recipient View的部分） #

// 构造信封更新请求，仅需设置状态为"sent"
$envelope_update = new \DocuSign\eSign\Model\Envelope();
$envelope_update->setStatus('sent');

// 初始化API客户端（复用你已有的配置逻辑）
$config = new \DocuSign\eSign\Configuration();
$config->setHost($args['base_uri']);
$config->addDefaultHeader('Authorization', 'Bearer ' . $args['ds_access_token']);
$api_client = new \DocuSign\eSign\Client\ApiClient($config);
$envelope_api = new \DocuSign\eSign\Api\EnvelopesApi($api_client);

// 调用接口发送信封
try {
    $envelope_api->update(
        $args['account_id'],
        $args['envelope_id'],
        $envelope_update
    );
    // 发送成功，可返回自定义响应
    return ['status' => 'success', 'message' => '签名请求已发送'];
} catch (\DocuSign\eSign\ApiException $e) {
    // 捕获并返回错误信息
    return ['status' => 'error', 'message' => $e->getMessage()];
}

重要注意事项 #

• 仅状态为created（未发送）的信封可执行此操作，若信封已处于sent或其他状态会返回错误
• 确保你的API账号对目标信封拥有发送权限
• 信封创建时已添加的收件人会在发送后自动收到DocuSign的签名邮件

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