'%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C10.221%2012.8327%2012.8327%2010.221%2012.8327%206.99935C12.8327%203.77769%2010.221%201.16602%206.99935%201.16602C3.77769%201.16602%201.16602%203.77769%201.16602%206.99935C1.16602%2010.221%203.77769%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M1.16602%207H12.8327'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20fill-rule='evenodd'%20clip-rule='evenodd'%20d='M6.99935%2012.8327C8.28802%2012.8327%209.33268%2010.221%209.33268%206.99935C9.33268%203.77769%208.28802%201.16602%206.99935%201.16602C5.71068%201.16602%204.66602%203.77769%204.66602%206.99935C4.66602%2010.221%205.71068%2012.8327%206.99935%2012.8327Z'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M2.875%202.95898C3.93063%204.01461%205.38896%204.66754%206.99978%204.66754C8.61062%204.66754%2010.069%204.01461%2011.1246%202.95898'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M11.1246%2011.0425C10.069%209.98691%208.61062%209.33398%206.99978%209.33398C5.38896%209.33398%203.93063%209.98691%202.875%2011.0425'%20stroke='%23666666'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_1267_9109'%3e%3crect%20width='14'%20height='14'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
Nếu sản phẩm của bạn đã có quy trình tạo hợp đồng (ví dụ: tuyển dụng nhân viên, tạo khoản vay, đăng ký nhà cung cấp), tích hợp ký thư loại bỏ việc chuyển hướng và giữ người dùng trong quy trình.
Tại sao tích hợp ký thư thay vì chuyển hướng?
Chuyển hướng người dùng đến trang ký thư của bên thứ ba tạo ra sự cản trở: chuyển đổi ngữ cảnh, mất liên tục thương hiệu và giảm số lượng người dùng. Tích hợp ký thư giữ người dùng trong ứng dụng của bạn suốt quá trình ký thư. Giao diện người dùng ký thư xuất hiện trong iframe hoặc thành phần nội địa, được thương hiệu hóa với phong cách của bạn, trong khi động cơ ký thư chạy trên backend của nhà cung cấp.
So sánh ba phương pháp tích hợp
| Công việc phát triển | Kiểm soát thương hiệu | |
|---|---|---|
| Tích hợp iframe | Dưới (chỉ frontend) | Trung bình — iframe được định dạng |
| API + giao diện người dùng tùy chỉnh | Cao (toàn bộ stack) | Toàn bộ — tự xây dựng giao diện người dùng của bạn |
| SDK di động | Trung bình (đặc thù cho nền tảng) | Kinh nghiệm người dùng toàn bộ nội địa |
Khi nào nên tích hợp ký thư
Tích hợp ký thư không phải lúc nào cũng là lựa chọn đúng. Dưới đây là các tình huống nơi nó mang lại giá trị lớn nhất.
Portal doanh nghiệp phục vụ nhân viên hoặc khách hàng có thể tích hợp ký thư cho xác nhận chính sách, phê duyệt nội bộ và thỏa thuận tự phục vụ mà không cần gửi người dùng đến công cụ bên ngoài.
Khi lượng ký thư cao (ngàn mỗi ngày), mỗi lần chuyển hướng đều gây tổn thất về chuyển đổi. Tích hợp ký thư giảm thiểu việc giảm số lượng người dùng và cải thiện tỷ lệ hoàn thành,直接影响收入.
Chức năng ký số tích hợp cung cấp quyền kiểm soát toàn bộ hành trình người dùng, giúp dễ dàng triển khai các vết theo dõi tùy chỉnh, công bố quy định và thu thập sự đồng ý trong ngữ cảnh ứng dụng của bạn.
Luồng API ký số tích hợp
Một thực hiện tích hợp ký số典型 theo thứ tự này.
Tạo phong bì qua API
Backend của bạn gọi API ký số để tạo một phong bì: tải lên tài liệu, xác định các trường ký, thiết lập vai trò người ký và cấu hình yêu cầu xác thực. API trả về ID phong bì.
Tạo URL ký
Đối với mỗi người ký, yêu cầu một URL ký từ API. URL này bao gồm một mã token một lần xác thực người ký cho phong bì cụ thể này. Tùy chọn truyền xác thực người nhận (mã truy cập, SMS OTP, eID).
Tích hợp trong iframe hoặc SDK
Hiển thị URL ký trong iframe (web) hoặc SDK di động (iOS/Android). Giao diện người dùng ký tải vào ứng dụng của bạn. Tùy chỉnh外观 để phù hợp với màu sắc, phông chữ và logo thương hiệu của bạn.
Xử lý webhook hoàn thành
Khi người ký hoàn thành (hoặc từ chối), nền tảng ký số gửi webhook đến backend của bạn. Sử dụng điều này để cập nhật trạng thái ứng dụng, kích hoạt bước tiếp theo hoặc thông báo cho các bên khác.
Lấy tài liệu ký
Tải xuống tài liệu ký và gói bằng chứng (chứng chỉ hoàn thành, vết theo dõi) qua API. Lưu chúng trong hệ thống hoặc lưu trữ đám mây của bạn.
Lưu ý kỹ thuật cho ký số tích hợp
Cross-origin và CSP
Tích hợp iframe yêu cầu domain ký số phải được phép trong Chính sách Bảo mật Nội dung của bạn. Cấu hình frame-ancestors và header child-src. Hầu hết các nền tảng ký số cung cấp cơ chế danh sách trắng cho các domain của bạn.
Độ tin cậy webhook
Webhook có thể thất bại do vấn đề mạng. Triển khai bộ xử lý webhook không thay đổi và cơ chế hồi đáp kiểm tra định kỳ trạng thái phong bì. Không bao giờ dựa hoàn toàn vào webhook cho các chuyển đổi trạng thái quan trọng.
Tính tương thích trên thiết bị di động
Giao diện ký phải hoạt động trên các thiết bị di động. Kiểm tra việc ký dựa trên iframe trên iOS Safari và Android Chrome. Một số thực hiện của máy ghi chữ ký gặp vấn đề về sự kiện chạm trên thiết bị di động. Sử dụng SDK cho ứng dụng di động bản địa.
Giới hạn tần suất và hàng loạt
Việc ký tích hợp với khối lượng lớn có thể vượt qua giới hạn tần suất API. Thực hiện việc排队 yêu cầu và tạo phong bì hàng loạt khi được hỗ trợ. Theo dõi sử dụng API và thiết lập cảnh báo cho giới hạn sắp tới.
Cách hoạt động của việc ký tích hợp eSign.AI
eSign.AI cung cấp việc ký tích hợp nhãn trắng cho các sản phẩm SaaS cần ký bên trong giao diện của mình.
iFrame và SDK thành phần
Tích hợp trải nghiệm ký eSign.AI vào sản phẩm của bạn thông qua iFrame hoặc thành phần React/Vue. Người ký không rời khỏi ứng dụng của bạn. Việc ký tích hợp hỗ trợ tất cả các tính năng eSign.AI: định tuyến đa bên, xác thực danh tính, QES, vết theo dõi.
Webhook cho trạng thái thực thời
Cấu hình webhook để nhận các sự kiện ký: phong bì gửi, xem, ký, hoàn thành, từ chối. Ứng dụng của bạn có thể kích hoạt các quy trình sau này (kích hoạt hợp đồng, thông báo, thanh toán) ngay lập tức sau khi ký hoàn thành.
API ký tích hợp: độ trễ, SLA và webhook
Quy định hiệu suất cho kế hoạch tích hợp API.
Điểm chuẩn độ trễ API
eSign.AI: tạo phong bì 200-400 ms, lấy trạng thái 50-100 ms, tải xuống PDF đã ký 300-800 ms. DocuSign: tạo phong bì 300-600 ms, lấy trạng thái 80-150 ms. Adobe Sign: tạo phong bì 400-800 ms. Tải iFrame ký tích hợp: eSign.AI 1-2 giây, DocuSign 2-4 giây.
Độ tin cậy webhook
Webhook eSign.AI: thời gian chờ 30 giây, 3 lần thử lại với giảm dần theo thời gian (5 phút, 30 phút, 2 giờ), chữ ký HMAC cho việc xác thực tải lên. DocuSign: thời gian chờ 10 giây, cửa sổ thử lại 24 giờ. Adobe Sign: thời gian chờ 3 giây, 6 lần thử trong 72 giờ. Để thực hiện các quy trình sau này thực thời, eSign.AI có webhook giao hàng đáng tin cậy nhất.
Câu hỏi thường gặp
Không. Độ hợp lệ pháp lý của chữ ký phụ thuộc vào phương pháp ký (SES, AES, QES), xác thực danh tính và gói bằng chứng — không phải là giao diện ký UI tích hợp hay chuyển hướng. Việc ký tích hợp tạo ra bằng chứng pháp lý như ký độc lập.
