Hướng dẫn
Công thức cho app nhiều tài khoản
App đăng bài, đọc hộp thư hay thu thập dữ liệu cho nhiều tài khoản mạng xã hội nên dùng Browlix thế nào — mỗi tài khoản một liên kết, kiểm danh tính trước, giữ trình duyệt theo việc, thử thách giao cho người, trạng thái của app do app giữ.
Các công thức này dành cho app làm việc với nhiều tài khoản trên các trang như Facebook, Instagram, LinkedIn hay X. Chúng mô tả cách dùng Browlix, không phải cách tự động hoá một trang cụ thể. Mọi đoạn code chúng dựa vào nằm trong app mẫu và Chuyển từ hồ sơ Chrome trên máy, đều chạy thật trên máy lab của Browlix.
Hãy dùng trong phạm vi điều khoản của từng trang và chính sách sử dụng. Browlix không hứa rằng trang sẽ không bao giờ hạn chế tài khoản.
1. Mỗi tài khoản một liên kết
Gắn mỗi tài khoản một lần: bindings.create với app_id của anh và external_account_id của tài khoản, trỏ tới hồ sơ của nó. Tìm bằng bindings.list trước khi tạo, và khi gặp CONFLICT thì dùng liên kết đã được tạo trước (app mẫu có đoạn này). Giữ metadata gọn và không chứa bí mật — khoá trông như thông tin đăng nhập bị từ chối.
Gom hồ sơ theo nhóm hoặc khách hàng bằng groups.* và gắn nhãn bằng tags.*; cả hai đều đổi tên hoặc xoá được qua API.
2. Kiểm danh tính trước mọi thao tác
Trình duyệt mở được không chứng minh tài khoản nào đang đăng nhập. Sau khi gắn vào, đọc tài khoản đang đăng nhập từ chính trang và so với external_account_id của liên kết trước khi làm gì:
| Trang | Đọc từ trang sau khi tải xong |
|---|---|
| ID số của người dùng đang đăng nhập | |
| Tài khoản người xem đang đăng nhập | |
| Mã định danh (URN) của thành viên đang đăng nhập | |
| X | Người xem đang đăng nhập, đọc lại sau mỗi lần mở |
Nếu không khớp, hoặc chưa ai đăng nhập, hãy dừng: không đăng, không đọc, không thử lại dưới liên kết đó. Đánh dấu tài khoản trong app và để một người xem.
3. Giữ trình duyệt theo từng việc
acquireSessionvớiholderReflà tên tiến trình worker. SDK tự gia hạn trong lúc việc chạy.- Giữa hai việc của cùng tài khoản,
detach({ keepWarmSeconds })giữ trình duyệt mở để việc sau bắt đầu ngay. - Cuối ngày, nhả với
keepWarmSeconds: 0rồistopSession: dữ liệu được niêm phong và đồng bộ sau khi trình duyệt đóng. BUSYnghĩa là một người hoặc app khác đang giữ trình duyệt. Chờ rồi thử lại; không bao giờ giành.FENCEDnghĩa là quyền giữ của anh đã bị thay. Dừng thao tác trên trang đó ngay — worker khác đang giữ.
Xem App giữ trình duyệt cho đủ luật giữ phiên.
4. Thử thách giao cho người
Khi trang hỏi mã, xác nhận, captcha hay kiểm tra danh tính, hãy dừng việc và giao tài khoản cho một người, họ hoàn tất qua màn xem trực tiếp trên web trong lúc app chờ. Browlix không giải captcha và app của anh cũng không nên thêm.
5. Trạng thái của app do app giữ
Hàng đợi việc, lịch chạy, danh sách không liên hệ, hạn mức theo tài khoản và hộp thư chờ gửi thuộc về app. Phiên đóng không có nghĩa việc xong: ghi kết quả việc trong app trước khi nhả trình duyệt, và làm việc gửi đi có khoá chống lặp ở phía app để một việc chạy lại không bao giờ gửi hai lần.
6. Khi có sự cố
| Tín hiệu | Cách làm |
|---|---|
RECOVERY_REQUIRED | Phiên trước kết thúc không chắc chắn. Quyết định bằng sessions.recover rồi mở lại — xem Phiên |
Sự kiện session.failed, hoặc phiên rời trạng thái ready | Dừng việc; thử lại sau |
| Máy mất kết nối | Quyền giữ hết hạn. Hồ sơ mở được trên máy khác khi dữ liệu của phiên cuối đã đồng bộ; trước đó mở sẽ nhận SYNC_PENDING |
Theo dõi sự kiện bằng sessions.events hoặc webhook.
7. Chuyển tài khoản vào
Chuyển tài khoản từ thư mục Chrome trên máy từng cái một, kiểm danh tính từng cái và giữ thư mục cũ đến khi chắc chắn — Chuyển từ hồ sơ Chrome trên máy.
Báo cho Browlix điều còn thiếu
Nếu thao tác anh cần chưa có trong API, agent AI đang làm tích hợp có thể gửi bằng feedback_submit, hoặc anh tự gửi — xem Phản hồi từ agent.