DocuSign API: วิธีเพิ่มผู้รับ "สำเนาถึง" หลังจากส่งไปแล้ว

ทำความเข้าใจผู้รับสำเนาถึง (CC) ใน DocuSign

ในขอบเขตของการลงนามอิเล็กทรอนิกส์ API ของ DocuSign นำเสนอเครื่องมือที่มีประสิทธิภาพในการทำให้เวิร์กโฟลว์เอกสารเป็นไปโดยอัตโนมัติ แต่การเพิ่มผู้รับหลังจากสร้างซองจดหมายอาจเป็นเรื่องยุ่งยาก ผู้รับ "สำเนาถึง" (CC) คือบทบาทที่ไม่ใช่ผู้ลงนาม ซึ่งจะได้รับสำเนาของเอกสารที่ลงนามแล้วเพื่อการตรวจสอบหรือเก็บถาวร โดยไม่ต้องลงนามหรืออนุมัติ จากมุมมองทางธุรกิจ ฟังก์ชันนี้มีค่าสำหรับทีมกำกับดูแล ฝ่ายกฎหมาย หรือผู้จัดการฝ่ายขายที่ต้องการการแจ้งเตือนโดยไม่จำเป็นต้องเปลี่ยนแปลงห่วงโซ่การลงนาม อย่างไรก็ตาม API ของ DocuSign มีข้อจำกัดในการแก้ไขหลังจากส่งซองจดหมาย ซึ่งเราจะสำรวจข้อจำกัดเหล่านี้โดยละเอียด

บทความนี้เจาะลึกขั้นตอนเชิงปฏิบัติในการเพิ่มผู้รับ CC หลังจากส่งซองจดหมายผ่าน DocuSign eSignature API เราจะครอบคลุมข้อกำหนดเบื้องต้น การเรียก API ข้อผิดพลาดที่อาจเกิดขึ้น และแนวทางปฏิบัติที่ดีที่สุด โดยอ้างอิงจากเอกสารอย่างเป็นทางการและข้อมูลเชิงลึกในการใช้งานจริง สำหรับองค์กรที่รวม DocuSign การทำความเข้าใจความแตกต่างเหล่านี้สามารถป้องกันการหยุดชะงักของเวิร์กโฟลว์และรับประกันกระบวนการที่พร้อมสำหรับการตรวจสอบ

พื้นฐานการจัดการผู้รับ DocuSign API

ก่อนที่จะเพิ่มผู้รับ CC หลังจากส่งแล้ว การทำความเข้าใจวงจรชีวิตของซองจดหมายของ DocuSign เป็นสิ่งสำคัญ ซองจดหมายแสดงถึงชุดเอกสาร และเมื่อ "ส่ง" แล้ว ซองจดหมายจะอยู่ในสถานะใช้งาน ซึ่งการเปลี่ยนแปลงจะถูกจำกัดเพื่อปกป้องประสบการณ์ของผู้ลงนามและความสมบูรณ์ทางกฎหมาย eSignature REST API (v2.1) จัดการการโต้ตอบเหล่านี้ โดยต้องมีการตรวจสอบสิทธิ์ผ่าน JWT หรือ OAuth เพื่อการเข้าถึงที่ปลอดภัย

แนวคิดหลัก:

• ผู้รับ: รวมถึงผู้ลงนาม ผู้อนุมัติ และ CC CC จะถูกเพิ่มผ่านอาร์เรย์ carbonCopies ในอ็อบเจ็กต์ผู้รับ
• สถานะซองจดหมาย: หลังจากส่งแล้ว ซองจดหมายจะอยู่ในสถานะ "sent" หรือ "delivered" การแก้ไขมีข้อจำกัด คุณไม่สามารถเพิ่มผู้ลงนามที่ต้องดำเนินการได้ แต่ CC ได้รับอนุญาตเนื่องจากไม่ได้เปลี่ยนลำดับการลงนาม
• จุดสิ้นสุด API: ใช้ /envelopes/{envelopeId}/recipients สำหรับการอัปเดต

จากมุมมองทางธุรกิจ ราคา API ของ DocuSign เริ่มต้นที่ $600 ต่อปีสำหรับแผน Starter รองรับซองจดหมายสูงสุด 40 ซองต่อเดือน เหมาะสำหรับการรวมขนาดเล็ก แต่ความต้องการปริมาณมากจะเพิ่มต้นทุน

คู่มือทีละขั้นตอน: การเพิ่มผู้รับ CC หลังจากส่งแล้ว

การเพิ่ม CC หลังจากส่งแล้วต้องใช้โหมด correct หรือวิธีแก้ไขปัญหา void-and-resend เนื่องจากโดยตรงหลังจากการส่งไม่ได้ตรงไปตรงมาเสมอไป DocuSign แนะนำให้วางแผนผู้รับล่วงหน้า แต่สำหรับสถานการณ์แบบไดนามิก (เช่น การเพิ่มผู้จัดการตามตรรกะทางธุรกิจตามเงื่อนไข) ให้ทำตามขั้นตอนเหล่านี้ กระบวนการนี้ถือว่าคุณมีบัญชีนักพัฒนาซอฟต์แวร์และโทเค็นการเข้าถึง API

ข้อกำหนดเบื้องต้น

1. การตั้งค่า API: รวม DocuSign SDK (สำหรับ Java, .NET, PHP ฯลฯ) หรือใช้การเรียก REST ดิบ ตรวจสอบสิทธิ์โดยใช้คีย์การรวมและ ID ผู้ใช้ของคุณ
2. ID ซองจดหมาย: ดึง ID จากการตอบสนองการส่งเริ่มต้น (เช่น ผ่าน /envelopes POST)
3. สิทธิ์: ตรวจสอบให้แน่ใจว่าบัญชีของคุณอนุญาตให้แก้ไขซองจดหมายได้ (เปิดใช้งานใน "คุณสมบัติ" ภายใต้การตั้งค่าผู้ดูแลระบบ)
4. การตรวจสอบสถานะซองจดหมาย: สอบถาม /envelopes/{envelopeId} เพื่อยืนยันว่าเป็นสถานะ "sent" และไม่มีผู้ลงนามดำเนินการที่เสร็จสิ้นแล้วซึ่งล็อกการเปลี่ยนแปลง

เคล็ดลับทางธุรกิจ: สำหรับองค์กร แผน Advanced API ($5,760 ต่อปี) ปลดล็อกคุณสมบัติเช่น Bulk Send และ webhook ซึ่งสามารถแจ้งเตือน CC โดยอัตโนมัติเมื่อเสร็จสิ้น

วิธีที่ 1: การใช้การแก้ไขซองจดหมาย (แนะนำสำหรับการเปลี่ยนแปลงเล็กน้อย)

คุณสมบัติ "แก้ไข" ของ DocuSign อนุญาตให้ทำการแก้ไขในระหว่างดำเนินการโดยไม่ต้อง void ซองจดหมาย เหมาะสำหรับการเพิ่ม CC

1. เริ่มต้นการแก้ไข:

   • PUT ไปที่ /envelopes/{envelopeId}/correct โดยมีเนื้อหาดังนี้:

     {
       "clientUserId": "optional_client_id",
       "correctInProgress": true
     }
     

     ซึ่งจะหยุดซองจดหมายชั่วคราว

2. เพิ่มผู้รับ CC:

   • POST ไปที่ /envelopes/{envelopeId}/recipients พร้อมรายละเอียด CC:

     {
       "carbonCopies": [
         {
           "email": "cc@example.com",
           "name": "John Doe",
           "recipientId": "unique_id_for_cc",  // เช่น "CC1"
           "routingOrder": 0  // CC ไม่ส่งผลต่อลำดับ
         }
       ],
       "resendEnvelope": false  // อย่าเพิ่งส่งการแจ้งเตือนใหม่
     }
     

     • recipientId ต้องไม่ซ้ำกัน หลีกเลี่ยงความขัดแย้งกับผู้รับที่มีอยู่
     • ตัวเลือก: เพิ่ม accessControl สำหรับการเข้าถึง CC ที่มีการป้องกันด้วยรหัสผ่าน

3. ส่งใหม่หรือแจ้งเตือน:

   • PUT ไปที่ /envelopes/{envelopeId}/correct อีกครั้งเพื่อดำเนินการต่อ:

     {
       "resendEnvelope": true  // เรียกใช้อีเมลสำหรับ CC ใหม่
     }
     

     CC จะได้รับสำเนาเมื่อซองจดหมายเสร็จสมบูรณ์หรือตามคำขอ

ข้อผิดพลาดที่อาจเกิดขึ้น: หากซองจดหมาย "เสร็จสมบูรณ์" แล้ว จะไม่สามารถแก้ไขได้ ใช้ webhook ผ่านคุณสมบัติ Connect (แผน Advanced) เพื่อตรวจสอบสถานะ

วิธีที่ 2: Void และส่งใหม่ (เหมาะสำหรับสถานการณ์ที่ซับซ้อน)

หากการแก้ไขไม่สามารถทำได้ (เช่น เนื่องจากการดำเนินการของผู้ลงนาม) ให้ void ซองจดหมายและสร้างใหม่ด้วย CC ใหม่

1. Void ซองจดหมาย:

   • PUT ไปที่ /envelopes/{envelopeId}:

     {
       "status": "voided",
       "voidedReason": "Adding CC recipient"
     }
     

2. สร้างใหม่ด้วย CC:

   • POST ไปที่ /envelopes พร้อมเพย์โหลดเดิม บวกกับ CC ในอ็อบเจ็กต์ recipients:

     {
       "emailSubject": "Updated Document",
       "documents": [/* original docs */],
       "recipients": {
         "signers": [/* original signers */],
         "carbonCopies": [
           {
             "email": "cc@example.com",
             "name": "John Doe",
             "recipientId": "CC1"
           }
         ]
       },
       "status": "sent"
     }
     

3. แจ้งเตือนผู้ลงนามเดิม: ใช้ /envelopes/{newEnvelopeId}/recipients/{recipientId}/resend สำหรับผู้ลงนามแต่ละรายเพื่อดำเนินการต่อ

ข้อสังเกตทางธุรกิจ: วิธีนี้ทำให้เกิดค่าใช้จ่ายในการใช้ซองจดหมายเพิ่มเติม (เช่น Business Pro ~100 ซองต่อผู้ใช้ต่อปี $480/ผู้ใช้/ปี) ดังนั้นจึงเหมาะสำหรับการแก้ไขปริมาณน้อย ติดตามโควต้าผ่านแดชบอร์ดโดยใช้ API เพื่อจัดการ

แนวทางปฏิบัติที่ดีที่สุดและข้อจำกัด

• การจัดการข้อผิดพลาด: ข้อผิดพลาดทั่วไป ได้แก่ 400 (ผู้รับไม่ถูกต้อง) หรือ 403 (สิทธิ์ไม่เพียงพอ) ตรวจสอบความถูกต้องเสมอโดยใช้ /envelopes/{envelopeId}/recipients GET ก่อน
• การทดสอบ: ใช้ Developer Sandbox ของ DocuSign (ฟรี) เพื่อจำลองโดยไม่ต้องใช้ซองจดหมายการผลิต
• การปฏิบัติตามข้อกำหนด: การเพิ่ม CC รักษาการติดตามการตรวจสอบ ซึ่งสอดคล้องกับมาตรฐาน ESIGN/UETA แต่บันทึกเหตุผลเพื่อหลีกเลี่ยงข้อพิพาท
• ทางเลือกอัตโนมัติ: สำหรับความต้องการหลังการส่งบ่อยครั้ง ให้รวม webhook (แผน Advanced) เพื่อทริกเกอร์การแจ้งเตือนภายนอกแทนการแก้ไข API

ในทางปฏิบัติ องค์กรต่างๆ รายงานประสิทธิภาพที่เพิ่มขึ้น 20-30% โดยการเขียนสคริปต์การดำเนินการเหล่านี้ด้วย SDK แต่สำหรับการดำเนินการขนาดใหญ่ ให้พิจารณาแผน Enterprise แบบกำหนดเองสำหรับการปรับเปลี่ยนที่ไม่จำกัด

กำลังเปรียบเทียบแพลตฟอร์มการลงนามอิเล็กทรอนิกส์กับ DocuSign หรือ Adobe Sign หรือไม่

eSignGlobal นำเสนอโซลูชันการลงนามอิเล็กทรอนิกส์ที่ยืดหยุ่นและคุ้มค่ากว่า พร้อมด้วยการปฏิบัติตามข้อกำหนดทั่วโลก ราคาที่โปร่งใส และการเริ่มต้นใช้งานที่รวดเร็วกว่า

👉 เริ่มทดลองใช้ฟรี

การเปรียบเทียบ DocuSign กับคู่แข่งหลัก

เพื่อให้มุมมองที่สมดุล เรามาเปรียบเทียบความสามารถของ API ของ DocuSign กับทางเลือกอื่น เช่น Adobe Sign, eSignGlobal และ HelloSign (ปัจจุบันคือ Dropbox Sign) ตารางนี้อิงตามข้อมูลสาธารณะปี 2025 โดยเน้นที่ราคา การจัดการผู้รับ และจุดแข็งในภูมิภาค เพื่อช่วยให้องค์กรตัดสินใจในการเลือกผู้ให้บริการ

การเปรียบเทียบนี้แสดงให้เห็นว่า DocuSign เก่งในด้านความลึกของ API ที่เป็นผู้ใหญ่ แต่มีราคาแพงกว่า ในขณะที่คู่แข่งนำเสนอความยืดหยุ่นสำหรับกลุ่มเฉพาะ

จุดสนใจของ Adobe Sign

Adobe Sign ซึ่งเป็นส่วนหนึ่งของ Adobe Document Cloud นำเสนอ API ที่ราบรื่นสำหรับการจัดการผู้รับ รวมถึงการเพิ่ม CC หลังการส่งที่ง่ายขึ้นผ่านจุดสิ้นสุด API "Amend" ราคาแข่งขันได้ โดยมีพื้นฐานที่ $10/ผู้ใช้/เดือน ขยายไปสู่ Enterprise แบบกำหนดเอง เหมาะสำหรับองค์กรที่อยู่ในชุด Adobe แล้ว โดยนำเสนอการประมวลผล PDF ที่แข็งแกร่งและการปฏิบัติตามข้อกำหนดทั่วโลก แม้ว่าความล่าช้าใน APAC อาจเป็นปัญหา

จุดสนใจของ eSignGlobal

eSignGlobal วางตำแหน่งตัวเองเป็นผู้เล่นระดับโลก โดยปฏิบัติตามข้อกำหนดในกว่า 100 ประเทศหลัก โดยเฉพาะอย่างยิ่งมีความแข็งแกร่งในภูมิภาคเอเชียแปซิฟิก (APAC) ภูมิทัศน์การลงนามอิเล็กทรอนิกส์ของ APAC มีความแตกแยก โดยมีมาตรฐานสูงและกฎระเบียบที่เข้มงวด ซึ่งแตกต่างจากกรอบ ESIGN/eIDAS ของสหรัฐอเมริกา/สหภาพยุโรป APAC ต้องการโซลูชัน "การรวมระบบนิเวศ" ซึ่งหมายถึงการเชื่อมต่อฮาร์ดแวร์/API ระดับลึกกับเอกลักษณ์ดิจิทัลของรัฐบาล (G2B) ซึ่งเป็นอุปสรรคทางเทคนิคที่เหนือกว่ารูปแบบการตรวจสอบอีเมลหรือการประกาศตนเองที่พบได้ทั่วไปในโลกตะวันตก eSignGlobal แก้ไขปัญหานี้ด้วยการรวมระบบดั้งเดิม เช่น iAM Smart ของฮ่องกงและ Singpass ของสิงคโปร์ เพื่อให้มั่นใจถึงความถูกต้องตามกฎหมายโดยไม่มีค่าใช้จ่ายเพิ่มเติม

ราคาไม่แพง โดยแผน Essential มีราคา $16.6 ต่อเดือนต่อปี อนุญาตให้ลงนามเอกสารได้สูงสุด 100 ฉบับ ที่นั่งผู้ใช้ไม่จำกัด และการตรวจสอบสิทธิ์ผ่านรหัสการเข้าถึง มูลค่าที่มุ่งเน้นการปฏิบัติตามข้อกำหนดนี้ทำให้สามารถแข่งขันกับ DocuSign และ Adobe Sign ได้ โดยเฉพาะอย่างยิ่งสำหรับทีมข้ามพรมแดนที่ต้องการ TCO ที่ต่ำกว่า

กำลังมองหาทางเลือกที่ชาญฉลาดกว่า DocuSign หรือไม่

eSignGlobal นำเสนอโซลูชันการลงนามอิเล็กทรอนิกส์ที่ยืดหยุ่นและคุ้มค่ากว่า พร้อมด้วยการปฏิบัติตามข้อกำหนดทั่วโลก ราคาที่โปร่งใส และการเริ่มต้นใช้งานที่รวดเร็วกว่า

👉 เริ่มทดลองใช้ฟรี

ความคิดสุดท้ายเกี่ยวกับการเลือกการลงนามอิเล็กทรอนิกส์

สำหรับองค์กรที่นำทางเวิร์กโฟลว์ที่ขับเคลื่อนด้วย API DocuSign ยังคงเป็นตัวเลือกที่เชื่อถือได้ แม้ว่าการแก้ไขหลังการส่งจะต้องมีการวางแผนอย่างรอบคอบ เมื่อมีทางเลือกอื่นเกิดขึ้น ให้พิจารณาความต้องการในภูมิภาค eSignGlobal โดดเด่นในฐานะตัวเลือกที่เป็นกลางและมุ่งเน้นการปฏิบัติตามข้อกำหนดสำหรับการดำเนินการที่มุ่งเน้น APAC ประเมินตามความจุ การรวม และที่ตั้งทางภูมิศาสตร์ของคุณเพื่อให้ได้สิ่งที่เหมาะสมที่สุด