DocuSign API: วิธีการค้นหาซองจดหมายด้วยค่าฟิลด์ที่กำหนดเอง

การจัดการที่มีประสิทธิภาพในการนำทางซองจดหมายใน DocuSign API

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

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

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

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

ทำความเข้าใจซองจดหมายและฟิลด์ที่กำหนดเองใน DocuSign API

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

จากมุมมองทางธุรกิจ การใช้ฟิลด์ที่กำหนดเองสำหรับการค้นหาสามารถปรับปรุงการกำกับดูแลข้อมูลได้ ธุรกิจในอุตสาหกรรมที่มีการควบคุม เช่น การเงินหรือการดูแลสุขภาพ สามารถใช้ฟิลด์เหล่านี้เพื่อกรองซองจดหมายตามเครื่องหมายการปฏิบัติตามข้อกำหนด ทำให้มั่นใจได้ถึงการเข้าถึงที่รวดเร็วในระหว่างการตรวจสอบ DocuSign API เป็นส่วนหนึ่งของแพลตฟอร์มนักพัฒนา โดยรองรับฟังก์ชันนี้ผ่านจุดสิ้นสุด RESTful โดยมีระดับราคา เช่น แผน Intermediate (3,600 ดอลลาร์สหรัฐต่อปี) ที่ให้ซองจดหมายได้มากถึง 100 ซองต่อเดือนสำหรับการดำเนินการดังกล่าว

คู่มือทีละขั้นตอน: การค้นหาซองจดหมายตามค่าฟิลด์ที่กำหนดเอง

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

ข้อกำหนดเบื้องต้นและการตั้งค่า

1. รับการเข้าถึง API: ลงทะเบียนสำหรับ DocuSign Developer Sandbox ที่ developer.docusign.com สร้างคีย์การรวมระบบ (รหัสไคลเอ็นต์) และคีย์สำหรับตรวจสอบสิทธิ์ OAuth สำหรับสภาพแวดล้อมการผลิต ให้อัปเกรดเป็นแผนแบบชำระเงิน โดยแผน Starter (600 ดอลลาร์สหรัฐต่อปี) เหมาะสำหรับการค้นหาขั้นพื้นฐาน

2. กำหนดฟิลด์ที่กำหนดเอง: เมื่อสร้างซองจดหมาย ให้เพิ่มฟิลด์ที่กำหนดเองผ่าน API ใช้ออบเจ็กต์ customFields ในคำจำกัดความของซองจดหมาย ตัวอย่างเช่น:

   {
     "status": "sent",
     "emailSubject": "Agreement for Review",
     "customFields": {
       "textCustomFields": [
         {
           "name": "ClientID",
           "value": "CLI-12345",
           "required": "false"
         }
       ]
     }
   }
   

   ซึ่งจะฝัง "CLI-12345" เป็นค่าที่ค้นหาได้ภายใต้ฟิลด์ "ClientID"

3. การตรวจสอบสิทธิ์: ใช้ JWT หรือกระบวนการให้สิทธิ์รหัสการตรวจสอบสิทธิ์ ตัวอย่างคำขอ JWT ใน Python (โดยใช้ไลบรารี requests) มีดังนี้:

   import requests
   import jwt
   import time
   
   def get_jwt_token(integration_key, user_id, rsa_key, account_id):
       claim = {
           "iss": integration_key,
           "sub": user_id,
           "aud": "account-docusigncom",
           "iat": int(time.time()),
           "exp": int(time.time()) + 3600,
           "scope": "signature impersonation"
       }
       token = jwt.encode(claim, rsa_key, algorithm='RS256')
       response = requests.post(
           "https://account-docusign.com/oauth/token",
           headers={"Authorization": f"Bearer {token}"},
           data={
               "grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
               "assertion": token
           }
       )
       return response.json()["access_token"]
   

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

การดำเนินการค้นหา

จุดสิ้นสุดที่สำคัญคือ GET /accounts/{accountId}/envelopes/search แต่สำหรับการกรองฟิลด์ที่กำหนดเอง ให้รวมพารามิเตอร์การสืบค้นหรือใช้ GET /envelopes ที่ยืดหยุ่นกว่าพร้อมเกณฑ์การค้นหา DocuSign Search API อนุญาตให้สืบค้นตามฟิลด์ที่กำหนดเองผ่านพารามิเตอร์ searchText ซึ่งตรงกับข้อมูลเมตาของซองจดหมาย รวมถึงค่าที่กำหนดเอง

• จุดสิ้นสุดการค้นหาพื้นฐาน: ใช้ GET /accounts/{accountId}/envelopes?search_text={value} ซึ่งจะสแกนหัวเรื่อง ชื่อ และฟิลด์ที่กำหนดเองของซองจดหมาย

  สำหรับการจับคู่ฟิลด์ที่กำหนดเองที่แม่นยำ ให้ใช้พารามิเตอร์ query ในการค้นหาขั้นสูง อย่างไรก็ตาม การสืบค้นฟิลด์ที่กำหนดเองโดยตรงต้องมีสิทธิ์ Envelopes: listStatusChanges หรือสิทธิ์ที่คล้ายกัน

  ตัวอย่างคำขอ cURL:

  curl -X GET "https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes?search_text=CLI-12345" \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/json"
  

  ส่วนตอบกลับ:

  {
    "envelopes": [
      {
        "envelopeId": "abc-123-def",
        "status": "completed",
        "customFields": {
          "textCustomFields": [
            {
              "name": "ClientID",
              "value": "CLI-12345"
            }
          ]
        }
      }
    ]
  }
  

• การกรองขั้นสูงโดยใช้ฟิลด์ที่กำหนดเอง: สำหรับการค้นหาซองจดหมายเฉพาะ ให้ดึงข้อมูลซองจดหมายภายในช่วงวันที่หรือสถานะก่อน จากนั้นกรองทางฝั่งไคลเอ็นต์ DocuSign แนะนำให้ใช้พารามิเตอร์ fromDate และ toDate ร่วมกับ search_text เพื่อเพิ่มประสิทธิภาพ หากปริมาณของคุณเกินโควต้า (เช่น 100 ซองต่อเดือนสำหรับแผน Intermediate) ให้พิจารณาอัปเกรดเป็น Advanced (5,760 ดอลลาร์สหรัฐต่อปี) เพื่อรับฟังก์ชันการทำงานแบบกลุ่ม

  ในโค้ด ให้แยกวิเคราะห์การตอบกลับเพื่อจับคู่ค่าฟิลด์ที่กำหนดเองที่แน่นอน:

  import json
  
  response = requests.get(
      f"https://demo.docusign.net/restapi/v2.1/accounts/{account_id}/envelopes",
      headers={
          "Authorization": f"Bearer {access_token}",
          "Accept": "application/json"
      },
      params={"search_text": "CLI-12345", "from_date": "2025-01-01T00:00:00Z"}
  )
  envelopes = response.json()["envelopeSummary"]["envelopes"]
  matching_envelopes = [
      env for env in envelopes
      if any(cf["name"] == "ClientID" and cf["value"] == "CLI-12345" for cf in env.get("customFields", {}).get("textCustomFields", []))
  ]
  print(json.dumps(matching_envelopes, indent=2))
  

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

• โควต้าและต้นทุน: การค้นหานับรวมในขีดจำกัด API ของซองจดหมาย การเกินจะทำให้เกิดค่าธรรมเนียมส่วนเกินหรือต้องมีการปรับแต่ง Enterprise
• ความปลอดภัย: ใช้ HTTPS และสิทธิ์การเข้าถึงตามบทบาทเสมอ เพื่อป้องกันการสืบค้นที่ไม่ได้รับอนุญาต
• การจัดการข้อผิดพลาด: ปัญหาทั่วไป ได้แก่ 401 (โทเค็นไม่ถูกต้อง) หรือ 400 (การสืบค้นไม่ถูกต้อง) บันทึกการตอบกลับเพื่อแก้ไขข้อบกพร่อง
• ความสามารถในการปรับขนาด: สำหรับการค้นหาที่มีปริมาณมาก ให้รวมเข้ากับ DocuSign Connect webhook เพื่อพุชการอัปเดต ลดความต้องการในการสำรวจ

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

DocuSign: ผู้นำตลาดด้านโซลูชันลายเซ็นอิเล็กทรอนิกส์

DocuSign เป็นผู้บุกเบิกด้านลายเซ็นอิเล็กทรอนิกส์มาตั้งแต่ปี 2004 โดยนำเสนอเครื่องมือการจัดการเอกสารที่ครอบคลุม แพลตฟอร์มลายเซ็นอิเล็กทรอนิกส์ประกอบด้วยแผนตั้งแต่ Personal (120 ดอลลาร์สหรัฐต่อปี) ไปจนถึง Business Pro (480 ดอลลาร์สหรัฐ/ผู้ใช้ต่อปี) การเข้าถึง API ทำได้ผ่านแผนนักพัฒนาอิสระ คุณสมบัติที่สำคัญ ได้แก่ เทมเพลต การส่งแบบกลุ่ม และการรวมเข้ากับแอปมากกว่า 400 แอป สำหรับความต้องการขั้นสูง DocuSign Intelligent Agreement Management (IAM) รวม CLM (การจัดการวงจรชีวิตสัญญา) เข้ากับข้อมูลเชิงลึกที่ขับเคลื่อนด้วย AI ทำให้การแก้ไขและการประเมินความเสี่ยงเป็นไปโดยอัตโนมัติ IAM เหมาะสำหรับองค์กร แม้ว่าราคาจะเป็นแบบกำหนดเองและอาจเพิ่มขึ้นตามจำนวนที่นั่งและซองจดหมาย

Adobe Sign: การรวมระบบที่ทรงพลังสำหรับเวิร์กโฟลว์ขององค์กร

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

eSignGlobal: โซลูชันที่ปรับแต่งได้สำหรับการปฏิบัติตามข้อกำหนด APAC และทั่วโลก

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

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

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

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

HelloSign (Dropbox Sign): โซลูชันที่ใช้งานง่ายสำหรับ SMB

HelloSign ซึ่งปัจจุบันคือ Dropbox Sign ให้ความสำคัญกับอินเทอร์เฟซที่ใช้งานง่ายสำหรับธุรกิจขนาดเล็กและขนาดกลาง (SMB) เวอร์ชันฟรีอนุญาตให้ใช้เอกสารได้สูงสุดสามฉบับต่อเดือน โดยแผนแบบชำระเงินเริ่มต้นที่ 15 ดอลลาร์สหรัฐต่อเดือน API รองรับการค้นหาซองจดหมายผ่านฟิลด์ที่กำหนดเอง โดยใช้จุดสิ้นสุด เช่น /templates และ /signatures แม้ว่าจะไม่ละเอียดเท่า DocuSign เหมาะสำหรับการรวมเข้ากับ Dropbox อย่างรวดเร็ว โดยเน้นที่ความง่ายในการใช้งานมากกว่าการปรับแต่งระดับองค์กร

ภาพรวมการเปรียบเทียบแพลตฟอร์มลายเซ็นอิเล็กทรอนิกส์

ตารางนี้เน้นย้ำถึงการแลกเปลี่ยนที่เป็นกลาง การเลือกขึ้นอยู่กับความต้องการและขนาดของภูมิภาค

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