Thêm người nhận bản sao

POST /esignglobal/v1/envelope/recipients/addCCs

Mô tả giao diện

Thêm người nhận bản sao vào phong bì. Sau khi phong bì được khởi tạo, hệ thống sẽ tự động thông báo cho người nhận bản sao; người nhận bản sao chỉ có quyền xem.

Lưu ý:

Hỗ trợ thêm người nhận bản sao khi trạng thái phong bì làBản nháp、Đang ký
Thứ tự hiển thị của người nhận bản sao không ảnh hưởng đến thứ tự gửi bản sao của phong bì.
Không cho phép thêm trùng lặp cùng một người nhận bản sao (lấy địa chỉ email làm định danh duy nhất của người dùng). Nếu cần cập nhật thông tin nhiệm vụ ký, vui lòng thêm lại người nhận bản sao tương ứng.

Tham số yêu cầu

Tên tham số				Kiểu dữ liệu	Bắt buộc	Mô tả
envelopeId				string	true	ID phong bì
CCInfos				array	true	Danh sách thông tin người được sao chép
	userEmail			string	true	Địa chỉ email của người được sao chép
	userName			string	true	Tên của người được sao chép, dùng để hiển thị tên bên sao chép trên trang ký kết và quy trình. [Lưu ý] Không được chứa các ký tự đặc biệt sau: / \ : * " < > \| ? và tất cả các biểu tượng cảm xúc (emoji)
	ccOrder			int	false	Vị trí thứ tự của người được sao chép trong quy trình ký kết, chia sẻ thứ tự với signOrder của người ký. Chỉ có thể cấu hình cho các nút ký chưa bắt đầu; nếu không truyền, sẽ kế thừa logic thông báo thêm người sao chép cũ.
	customizeSettings			object	false	Cấu hình tùy chỉnh
		notificationSettings		object	false	Cấu hình tùy chỉnh loại thông báo
			notificationLanguage	string	false	Ngôn ngữ thông báo, mặc định lấy từ cấu hình "Ngôn ngữ thông báo mặc định" en-US Tiếng Anh zh-CN Tiếng Trung giản thể zh-Hant Tiếng Trung phồn thể ja-JP Tiếng Nhật es-MX Tiếng Tây Ban Nha pt-PT Tiếng Bồ Đào Nha th-TH Tiếng Thái id-ID Bahasa Indonesia vi-VN Tiếng Việt ms-MY Bahasa Melayu fil-PH Tiếng Philippines de-DE Tiếng Đức fr-FR Tiếng Pháp ru-RU Tiếng Nga it-IT Tiếng Ý ko-KR Tiếng Hàn

Tham số yêu cầu

{
	"envelopeId": "flow1234567890",
	"CCInfos": [{
		"userEmail": "buweiqiang@xxxx.com",
		"userName": "WeiQiang",
		"ccOrder": 2
		},{
		"userEmail": "tiandou@xxxx.com",
		"userName": "dou",
		"ccOrder": 3
	}
}

Tham số phản hồi

Tên tham số		Kiểu dữ liệu	Mô tả
envelopeId		string	ID phong bì
CCInfos		array	Tập hợp thông tin người được sao chép
	userEmail	string	Địa chỉ email của người được sao chép
	userName	string	Tên của người được sao chép

Ví dụ phản hồi

{
	"code": "0",
	"message": "成功",
	"data": {
		"envelopeId": "flow1234567890",
		"CCInfos": [{
			"userEmail": "buweiqiang@xxxx.com",
			"userName": "WeiQiang"
			},{
			"userEmail": "tiandou@xxxx.com",
			"userName": "dou"
		}]
	}
}