Hủy xác thực UnifyPort mà không để mã QR cũ xuất hiện lại
Để hủy luồng xác thực UnifyPort, hãy gọi POST /v1/accounts/{account_id}/auth/cancel với {} cho nhà cung cấp được hỗ trợ. Đóng cửa sổ QR chỉ là thao tác giao diện cục bộ. Hãy ẩn dữ liệu đăng nhập cũ, chặn phản hồi đến muộn hiển thị lại dữ liệu đó, gửi yêu cầu hủy rồi đọc trạng thái xác thực trước khi cho phép đăng nhập mới. Hết thời gian chờ nghĩa là kết quả chưa được xác nhận, không phải bằng chứng hủy thất bại.
Điểm chính
- Tài liệu liệt kê Telegram, WhatsApp và TikTok là các nhà cung cấp hỗ trợ hủy. Có đăng nhập QR không đồng nghĩa với có thao tác hủy.
- Giá trị
cancelledtrong phản hồi thao tác khác với trạng thái xác thực hiện tại của tài khoản. - Điều phối thao tác bắt đầu, hủy và gửi thông tin xác thực theo từng tài khoản, kể cả giữa các thẻ trình duyệt.
- Hủy xác thực không phải xóa tài khoản, thay đổi tính phí hay xác nhận mọi phiên trên nền tảng đã bị thu hồi.
Chọn thao tác theo đúng mục đích
| Mục đích của người dùng | Thao tác phù hợp |
|---|---|
| Tạm ẩn màn hình đăng nhập | Đóng giao diện và quy định rõ xác thực có tiếp tục hay không |
| Bỏ lần xác thực hiện tại | Dùng thao tác hủy xác thực được hỗ trợ |
| Tạm dừng kết nối đang hoạt động | Dừng runtime, không đặt lại xác thực |
| Xóa tài nguyên tài khoản khỏi UnifyPort | Dùng quy trình xóa tài khoản riêng |
Hướng dẫn tạm dừng runtime có kế hoạch dành cho tài khoản đã kết nối. Bài này xử lý lần xác thực mà người vận hành không còn muốn hoàn tất.
Tài liệu Cancel authentication mô tả hủy luồng mã xác minh, QR và nhập phiên, nhưng chỉ hỗ trợ Telegram, WhatsApp và TikTok. Nếu giao diện quản lý cả WhatsApp lẫn Zalo, không nên bật cùng một thao tác hủy cho Zalo chỉ vì Zalo có đăng nhập QR. LINE cũng không nằm trong danh sách hỗ trợ thao tác này.
Phân biệt QR hết hạn với hủy cả lần đăng nhập
Đặc tả QR chính thức của Telegram mô tả token đăng nhập hết hạn, việc tạo mã QR thay thế và chấp nhận token từ ứng dụng đã đăng nhập. Vì vậy, ảnh QR cũ không phải trạng thái đăng nhập có thể lưu dùng lâu dài. Tuy nhiên, đặc tả này không định nghĩa hợp đồng hủy của UnifyPort và không bảo đảm đóng trình duyệt sẽ dừng xác thực.
Get authentication state của UnifyPort trả về status, auth_fields, auth_payload, expires_at và last_error. Dùng trạng thái cùng dữ liệu hiện tại, không dùng ảnh chụp đã lưu. Không đưa QR, mã xác minh, mật khẩu hoặc dữ liệu phiên vào nhật ký hay hệ thống phân tích.
Nếu cần kết nối lần đầu, hãy xem hướng dẫn Telegram bằng mã và QR. Phần bổ sung ở đây là kiểm soát lần thử nào còn được phép thay đổi màn hình hoặc gửi yêu cầu tiếp theo.
Tuần tự hóa thao tác xác thực của từng tài khoản
Đây là thiết kế ứng dụng được đề xuất, không phải bảo đảm giao dịch nguyên tử từ máy chủ:
- Gắn màn hình với workspace và
account_idđã kiểm tra. Xác nhận người vận hành có quyền quản lý tài khoản nhắn tin đó. - Duy trì một bộ điều phối xác thực đang có hiệu lực cho mỗi tài khoản ở backend. Phối hợp cả thẻ trình duyệt và người vận hành khác, không chỉ ngăn nhấp đúp.
- Khi chọn Hủy, vô hiệu hóa lần thử cục bộ, ẩn dữ liệu nhạy cảm, khóa việc gửi mã hoặc mật khẩu và ngừng lên lịch thăm dò mới.
- Tăng thế hệ giao diện cục bộ để phản hồi của yêu cầu đã gửi không thể khôi phục màn hình cũ.
- Gửi yêu cầu hủy qua backend. Chưa bật nút bắt đầu lại cho đến khi đối chiếu kết quả.
Ví dụ phía trình duyệt sau đây loại bỏ phản hồi đọc đã lỗi thời. generation và loginVisible là biến của ứng dụng, không phải trường UnifyPort:
let generation = 0;
let loginVisible = true;
async function refreshLogin(readAuth, render) {
const observedGeneration = generation;
const auth = await readAuth();
if (!loginVisible || observedGeneration !== generation) return;
render(auth);
}
function abandonLocalAttempt(clearSensitiveUi) {
loginVisible = false;
generation += 1;
clearSensitiveUi();
}
Lớp bảo vệ này không hủy được HTTP đã gửi, không thu hồi chấp thuận đã xảy ra ở nhà cung cấp và không ngăn thẻ khác hoạt động. Vẫn cần điều phối backend và đọc trạng thái. Giữ bộ nhận webhook hoạt động; sự kiện xác thực đến muộn nên kích hoạt đối chiếu trạng thái, không tự mở lại cửa sổ QR cũ.
Gửi hủy rồi đọc trạng thái hiện tại
Các yêu cầu dưới đây chỉ là ví dụ, chưa được thực thi. Lấy biến từ cấu hình backend được bảo vệ và tài khoản đã được người vận hành kiểm tra:
curl -X POST \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth/cancel" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}" \
-H "Content-Type: application/json" \
-d '{}'
curl \
"https://api.unifyport.ai/v1/accounts/${ACCOUNT_ID}/auth" \
-H "X-Api-Key: ${UNIFYPORT_API_KEY}"
Tài liệu hủy minh họa HTTP 200 với data.status: "cancelled". Vòng đời tài khoản mô tả việc bỏ luồng đang chờ là chuyển về pending_auth. Không sao chép kết quả thao tác vào mọi trường trạng thái của tài khoản.
| Quan sát | Cách xử lý đề xuất |
|---|---|
Hủy đã được xác nhận, trạng thái là pending_auth | Tiếp tục ẩn dữ liệu cũ; cho phép người dùng chủ động bắt đầu lần mới |
| Hết thời gian chờ hoặc không đọc được phản hồi | Đánh dấu chưa xác nhận, đọc trạng thái trước thao tác thay đổi tiếp theo |
| Vẫn đang chờ nhập dữ liệu | Giữ giao diện cũ vô hiệu, tiếp tục đối chiếu hoặc chuyển cấp xử lý, không mở luồng cạnh tranh |
Trạng thái là authorized | Xem đó là bằng chứng hiện tại; không báo đã đăng xuất và không tự gửi hủy lần nữa |
Nếu chấp thuận và hủy xảy ra đồng thời, hợp đồng công khai không bảo đảm thao tác nào thắng một cách nguyên tử. Lưu chẩn đoán yêu cầu đã loại bỏ dữ liệu nhạy cảm và để người vận hành quyết định dựa trên trạng thái quan sát được. Không hứa có webhook hủy khi tài liệu không định nghĩa sự kiện đó.
Chỉ bắt đầu lại sau một quyết định mới
Tài liệu vòng đời nêu rằng bắt đầu xác thực bằng mã, QR hoặc phiên khi tài khoản đã được xác thực sẽ trả về 409 account_already_authorized. Đây không phải lý do tự động hủy một tài khoản đang hoạt động tốt rồi thử lại. Trước hết cần xác nhận có thực sự muốn xác thực mới hay không.
Với lần thử đang chờ đã bị bỏ, hãy đối chiếu kết quả hủy trước, tạo thế hệ giao diện mới rồi gọi thao tác bắt đầu theo chế độ đã cấu hình cho tài khoản. Chỉ hiển thị dữ liệu vừa nhận được. Sau khi xác thực thành công, vẫn phải kiểm tra riêng runtime_status trước khi coi kết nối đã sẵn sàng.
UnifyPort cung cấp giao diện không chính thức. Thao tác hủy không phải chức năng đăng xuất toàn bộ các phiên khác của nền tảng, cũng không gỡ bỏ kiểm soát bảo mật của nhà cung cấp.
Câu hỏi thường gặp
Đóng cửa sổ QR có hủy xác thực không?
Không tự động hủy. Đóng cửa sổ chỉ thay đổi giao diện ứng dụng. Hủy phía máy chủ cần thao tác API được hỗ trợ.
QR hết hạn có nên tự động hủy không?
Không. Hết hạn liên quan đến dữ liệu đăng nhập đang hiển thị. Hãy đọc trạng thái hiện tại và theo quy trình cập nhật của nhà cung cấp, trừ khi người dùng thực sự muốn bỏ lần thử.
Có thể báo hủy thành công sau timeout không?
Không. Hiển thị kết quả chưa xác nhận và đối chiếu trạng thái. Không bắt đầu luồng mới ngay hoặc liên tục gửi yêu cầu hủy.
Hủy có dừng tính phí hay xóa tin nhắn không?
Hợp đồng hủy không bảo đảm hai việc đó. Tách riêng việc ngừng sử dụng tài khoản, tính phí, dọn tin nhắn đã lưu và kiểm soát xác thực.
Bước tiếp theo và nguồn
Triển khai theo tài liệu Cancel authentication. Nên kiểm thử phản hồi thăm dò đến muộn, hai thẻ trình duyệt, chấp thuận đồng thời với hủy, mất phản hồi và chủ động bắt đầu lại. Đây là các ca kiểm thử đề xuất, không phải kết quả đã thực hiện.
Nguồn được kiểm tra ngày 2026-11-12:
Biến tích hợp nhắn tin thành một pipeline sản phẩm ổn định.
Bắt đầu bằng cách gửi qua một API, rồi đưa mọi tin nhắn inbound trở lại hệ thống kinh doanh bằng sự kiện chuẩn.