Tự động hoá — Chạy việc lặp đi lặp lại thay cho bạn
Tài liệu dành cho người mới. Đọc 10 phút là dùng được. Không cần biết lập trình.
Tải tài liệu kỹ thuật
File đi kèm, dành cho người muốn tự viết workflow chuyên sâu, hoặc điều khiển trình duyệt từ chương trình của mình.
File Markdown (.md) — mở bằng trình soạn thảo văn bản bất kỳ, hoặc VS Code / Notepad. File .zip là project C#, cần .NET 8 SDK để chạy.
🤖 Tự động hoá là gì?
Bảo máy tự làm thay bạn những thao tác lặp đi lặp lại trên trình duyệt.
Hãy tưởng tượng bạn phải làm cùng một việc trên 50 profile: mở một trang web, đăng nhập, bấm vài nút, điền form… Làm tay thì mỏi tay và dễ sai. Tự động hoá giúp bạn ghi lại các bước đó một lần, rồi cho máy tự chạy lại trên bao nhiêu profile cũng được.
📚 Vài từ cần biết
Bạn sẽ gặp các từ này khắp nơi trong app. Nắm 7 từ là đủ.
Một chuỗi các bước tự động. Là “công thức” bạn cho máy chạy.
Một việc nhỏ trong workflow: mở web, bấm nút, gõ chữ, chờ, đọc dữ liệu…
Một “danh tính trình duyệt” riêng (cookie, vân tay…). Workflow chạy trên profile.
Gói cấu hình: chọn profile nào chạy, chạy mấy luồng, dùng workflow nào.
Số profile chạy cùng lúc. 5 luồng = 5 cửa sổ chạy song song.
Thông tin bạn nhập trước khi chạy (vd: từ khoá, file danh sách). Xem mục 6.
Cho campaign tự chạy theo lịch và số lần định sẵn, rồi xem kết quả.
🚀 Chạy thử trong 5 bước
Cách nhanh nhất để thấy tự động hoá hoạt động: chạy thử trên 1 profile.
- Mở mục “Tự động hoá” Trên thanh điều hướng bên trái, bấm Tự động hoá, rồi vào tab Workflow.
- Lấy một workflow Bấm Tạo workflow mới để tự làm, hoặc vào Cửa hàng bấm Cài đặt một workflow có sẵn (xem mục 5). Mới bắt đầu thì nên dùng cái có sẵn.
- Mở workflow và bấm Run Bấm Mở để vào màn hình chỉnh sửa, rồi bấm Run để chạy thử.
- Chọn profile chạy Hộp thoại “Chọn profile chạy” hiện ra — chọn một profile đang mở. Nếu workflow không cần trình duyệt, chọn “(Không kết nối)”. Nếu workflow có Inputs, điền giá trị test ở đây.
- Xem nó chạy Theo dõi cửa sổ trình duyệt làm việc và bảng Log bên dưới để biết từng bước. Xong rồi thì bạn đã sẵn sàng chạy hàng loạt bằng Campaign.
🗂️ Ba mục chính trong “Tự động hoá”
Quy trình tự nhiên: làm Workflow → gom vào Campaign → đặt Lịch chạy.
① Workflow — “công thức”
Nơi tạo, mở, sửa và quản lý các workflow đã lưu. Tại đây bạn có thể:
- Tạo workflow mới rồi kéo–thả các bước để xây quy trình.
- Mở một workflow để xem/sửa, hoặc bấm Run chạy thử.
- Import / Export: nhập hoặc xuất workflow ra file để sao lưu, chia sẻ.
- Publish: đẩy workflow của bạn lên Cửa hàng cho cả nhóm dùng.
② Campaign — “chạy hàng loạt”
Định nghĩa một lần chạy thật. Bạn chọn:
| Mục | Ý nghĩa |
|---|---|
| Workflow áp dụng | Công thức nào sẽ chạy. |
| Profile chạy | Những profile nào tham gia. |
| Số luồng chạy đồng thời | Bao nhiêu profile chạy cùng lúc (chia lưới cửa sổ trên màn hình). |
| Inputs | Các giá trị workflow cần (từ khoá, file…). Xem mục 6. |
③ Lịch chạy — “tự chạy theo giờ”
Cho một campaign tự chạy mà không cần bạn ngồi canh. Đặt số lần chạy
(0 = chạy không giới hạn), bấm Bắt đầu để kích hoạt và
Dừng khi muốn ngừng. Kết quả từng lần chạy xem được ngay tại đây.
🧱 Bảng tra cứu Action (theo nhóm)
Đây là tất cả “viên gạch” bạn thấy trong bảng chọn (palette) khi mở workflow — chia đúng 6 nhóm như trong app. Bấm vào tên nhóm để mở/đóng.
Bấm vào một action để xem các tham số (parameter) của nó: kiểu dữ liệu, bắt buộc hay không, giá trị mặc định và các lựa chọn. Gõ vào ô dưới để tìm nhanh.
Kiểu tham số: Biểu thức · {{var}} nhận biến · Chọn 1 danh sách cố định · Tên biến (output) nơi lưu kết quả · Số / Đúng-Sai / Văn bản nhập trực tiếp.
workflow-script-guide.md).
Người dùng thường chỉ cần nhìn nhãn và mô tả.
📊 Chuẩn bị Google Sheets (làm 1 lần)
Hai action Read / Write Google Sheet nói chuyện thẳng với Google Sheets API — không mở trình duyệt, không cần đăng nhập, sheet không phải share ra public. Đổi lại chúng cần một Credential file: file key .json của Service Account.
- Tạo project Vào Google Cloud Console, tạo mới (hoặc chọn) một project.
- Bật API APIs & Services → Library, tìm Google Sheets API rồi bấm Enable.
- Tạo service account IAM & Admin → Service Accounts → Create service account, đặt tên gì cũng được.
- Tải file key Mở service account vừa tạo → tab Keys → Add key → Create new key → JSON. File tải về chính là Credential file.
- Lấy email của nó Mở file .json, copy dòng client_email — dạng ten-bot@project-id.iam.gserviceaccount.com.
- Share sheet cho email đó Mở Google Sheet → Share → dán email vừa copy → chọn Viewer nếu chỉ đọc, Editor nếu cần ghi → Send.
Dùng trong workflow: trỏ Credential file tới file .json (viết ~/google/bot.json, %APPDATA%\tst\bot.json hay {{profile_dir}} đều được), dán URL sheet vào File ID, để Sheet ID = 0 cho tab đầu tiên — hoặc gõ thẳng tên tab.
Nhiều profile cùng ghi một lúc? Dùng mode append_row. Google tự tìm dòng trống kế tiếp nên 25 profile xong cùng lúc ra đủ 25 dòng, không đè nhau. cell và row ghi đúng toạ độ bạn đưa, hai profile trỏ cùng một ô thì vẫn đè nhau như thường.
Không muốn dính tới tài khoản Google? Read Excel File và Write Excel File làm đúng việc đó trên file .xlsx ngay trên máy, không phải cài đặt gì cả.
🏪 Cửa hàng Workflow
Kho workflow do nhóm chia sẻ — không cần tự làm từ đầu.
Vào Cửa hàng, chọn workflow phù hợp rồi bấm Cài đặt để tải về máy. Sau khi cài, nó xuất hiện trong danh sách Workflow của bạn và dùng được ngay.
| Loại | Cách dùng |
|---|---|
| Miễn phí | Bấm Cài đặt là dùng được liền. |
| Trả phí | Được chạy thử vài lần miễn phí. Hết lượt dùng thử thì cần mua mới chạy tiếp. |
✏️ Inputs là gì?
Là chỗ để bạn “nói cho workflow biết” thông tin nó cần.
Ví dụ: một workflow tìm kiếm Google cần biết từ khoá. Thay vì cố định một từ khoá,
người làm workflow tạo một Input tên keyword. Khi bạn chạy,
app sẽ hỏi bạn nhập từ khoá đó. Nhờ vậy một workflow dùng được cho nhiều mục đích.
Input có nhiều kiểu dữ liệu tuỳ thông tin cần nhập:
| Kiểu | Dùng khi |
|---|---|
| Văn bản / Văn bản nhiều dòng | Nhập chữ ngắn hoặc danh sách nhiều dòng. |
| Số | Nhập một con số (vd số lần lặp). |
| Đúng / Sai | Bật/tắt một tuỳ chọn. |
| Chọn một / Chọn nhiều | Chọn từ danh sách có sẵn. |
| File | Chọn một file trên máy (vd file danh sách .txt). |
📊 Xem kết quả & log
Biết workflow chạy tới đâu, thành công hay lỗi.
- Khi Run thử: bảng Log ngay dưới hiển thị từng bước theo thời gian thực.
- Khi chạy Campaign / Lịch chạy: log được tách theo từng luồng — bấm vào một profile bên trái để xem chi tiết riêng của profile đó.
- Các mức log:
Info(thông tin),Warn(cảnh báo, vẫn chạy tiếp),Error(lỗi). Gặp lỗi cứ đọc dòng đỏ để biết nguyên nhân.