📖 Hướng dẫn sử dụng AUTO-POST

Tài liệu dẫn bạn từ lúc mở hệ thống lần đầu đến khi bài đăng tự đi lên các nền tảng. Mỗi bước kèm ảnh chụp màn hình thật của hệ thống theo đúng giao diện hiện tại. Theo đúng thứ tự bên dưới là không bỏ sót bước nào.

1

Quy trình tổng quan — hệ thống chạy thế nào?

Toàn bộ hệ thống gồm 5 chặng. Bạn chỉ làm việc ở chặng 1–4, chặng 5 hệ thống tự chạy:

CHẶNG 1
⚙️ Cài đặt
Chọn nơi đăng + API key
CHẶNG 2
🧠 Kiến thức
Dạy AI giọng văn, quy tắc
CHẶNG 3
🎬 Nạp nội dung
Video / ảnh AI / caption
CHẶNG 4
📅 Lên lịch
Tạo bài, chọn nền tảng, hẹn giờ
CHẶNG 5
⚡ Tự động
Scheduler tự đăng + báo kết quả

Menu bên trái xếp đúng theo trình tự làm việc — làm từ trên xuống dưới là hết quy trình: Tổng quan → Thư viện video → Kho hình AI → Caption & Hashtag → Kiến thức & Quy tắc → Lịch đăng → Tài khoản → Cài đặt → Hướng dẫn sử dụng (trang này).

Trang Tổng quan: số liệu tổng hợp (video, chờ đăng, đã đăng, lỗi, tài khoản) + bài đăng gần đây + nhật ký hệ thống — tự cập nhật 30 giây/lần
Trang Tổng quan: số liệu tổng hợp (video, chờ đăng, đã đăng, lỗi, tài khoản) + bài đăng gần đây + nhật ký hệ thống — tự cập nhật 30 giây/lần

💡 Hệ thống đang ở chế độ Mock (giả lập) khi mới cài — mọi thao tác đều chạy được nhưng “đăng thành công” chỉ là giả lập. Làm theo Chương 2 để chuyển sang đăng thật.

2

Trước khi bắt đầu — yêu cầu hệ thống

  • Node.js 22.5 trở lên (bắt buộc — hệ thống dùng SQLite tích hợp sẵn trong Node). Kiểm tra: mở Command Prompt gõ node -v.
  • App đang chạy: double-click start.bat (hoặc dev.bat) trong thư mục F:\AUTO-POST, rồi mở http://localhost:3210.
  • Scheduler chỉ chạy khi app mở — đóng cửa sổ app là tạm dừng đăng (bài không mất, mở lại sẽ đăng bù).
  • Bảo mật: app chỉ truy cập được từ máy này (127.0.0.1) — không ai trong mạng lan vào được.
3

Cài đặt — chọn nơi đăng bài và kích hoạt AI

Trang Cài đặt quyết định bài đăng đi qua đâu (Mock/PostPeer/Blotato) và AI dùng key nào. Đây là chương quan trọng nhất — làm xong chương này hệ thống mới “sống”.

1

Mở menu “Cài đặt” (⚙️ — gần cuối menu, ngay trên Hướng dẫn sử dụng)

Cài đặt → khối “Nhà cung cấp đăng bài”: Mock / PostPeer / Blotato. Hàng đang chọn có viền tím.
Cài đặt → khối “Nhà cung cấp đăng bài”: Mock / PostPeer / Blotato. Hàng đang chọn có viền tím.
  • Mock — giả lập, miễn phí: dùng để làm quen, không đăng thật.
  • PostPeer — đăng thật, free 20 bài/tháng, cần API key (postpeer.dev).
  • Blotato — đăng thật đa nền tảng: $29/tháng + credit (~$6/1000 bài).

💡 Bấm chọn hàng tương ứng → “Lưu cài đặt” → “Kiểm tra kết nối”. Nút kiểm tra lưu trước rồi test đúng những gì đang chọn trên form — không cần bấm Lưu riêng. Muốn thu hồi key: bấm “Xoá key PostPeer/Blotato”.

➜ Nếu chọn PostPeer hoặc Blotato: cần API key — lấy tại postpeer.dev (free) hoặc app.blotato.com → Settings → API Keys ($29/tháng).

2

Nhập API key AI — Cerebras (soạn caption) và fal.ai (tạo hình)

Cài đặt → khối “AI soạn nội dung — Cerebras” và “Tạo hình AI — fal.ai”. Dán key → “Lưu cài đặt AI” → “Kiểm tra Cerebras”.
Cài đặt → khối “AI soạn nội dung — Cerebras” và “Tạo hình AI — fal.ai”. Dán key → “Lưu cài đặt AI” → “Kiểm tra Cerebras”.
  • Cerebras (miễn phí): lấy key tại cloud.cerebras.ai → API Keys, dán vào ô API KEY, chọn model “GPT-OSS 120B”, bấm “Lưu cài đặt AI” rồi “Kiểm tra Cerebras” — thấy dòng xanh “Kết nối OK” là xong.
  • fal.ai (tạo hình, ~$0.003/ảnh): lấy key tại fal.ai → Keys, dán vào ô API KEY. Tài khoản phải còn số dư — hết dư thì nạp tại fal.ai/dashboard/billing.

💡 Key lưu ngay trên máy bạn (database cục bộ). Muốn thu hồi: bấm “Xoá key Cerebras/fal.ai”. Đổi model không cần xoá key.

4

Kết nối tài khoản mạng xã hội

Mỗi nền tảng cần 1 tài khoản được kết nối 1 lần duy nhất. Sau đó mọi bài đăng tự đi đúng tài khoản đã chọn.

1

Mở menu “Tài khoản” và kết nối theo nhà cung cấp đang dùng

Tài khoản → danh sách nền tảng đã kết nối (ảnh chụp chế độ Mock với 6 tài khoản demo). Với PostPeer sẽ có thêm ô chọn nền tảng + nút “Kết nối qua OAuth”; với Blotato sẽ có nút “Đồng bộ tài khoản từ Blotato”.
Tài khoản → danh sách nền tảng đã kết nối (ảnh chụp chế độ Mock với 6 tài khoản demo). Với PostPeer sẽ có thêm ô chọn nền tảng + nút “Kết nối qua OAuth”; với Blotato sẽ có nút “Đồng bộ tài khoản từ Blotato”.
  • Đang dùng PostPeer: chọn nền tảng trong ô vuông → “Kết nối qua OAuth” → đăng nhập tài khoản MXH → cấp quyền → quay lại trang này (có thông báo nhắc) → “Đồng bộ danh sách đã kết nối”.
  • Đang dùng Blotato: kết nối tại app.blotato.com → Social Accounts (Blotato giữ OAuth), rồi về đây bấm “Đồng bộ tài khoản từ Blotato”.
  • Đang dùng Mock: bấm “+ Thêm 6 tài khoản demo” để có tài khoản chạy thử.

💡 Facebook đăng lên Page (không phải trang cá nhân): sau khi kết nối, bấm “Cấu hình” trên dòng Facebook để nhập pageId. YouTube có thể đặt tiêu đề mặc định tương tự.

💡 Ngắt kết nối tài khoản sẽ tự huỷ các bài đang chờ của tài khoản đó (có xác nhận trước khi làm) — không để bài “mồ côi” fail ngầm.

➜ Kết nối xong → sang Chương 5 nhập kho kiến thức để AI biết viết theo chất thương hiệu của bạn.

5

Dạy AI bằng kho Kiến thức & Quy tắc

Đây là “bộ não” của AI. Bước này càng kỹ, caption AI càng đúng chất thương hiệu của bạn. Bỏ trống cũng được — AI viết theo kinh nghiệm chung, nhưng sẽ không có chất riêng.

1

Mở menu “Kiến thức & Quy tắc”

Kiến thức & Quy tắc → 2 khối: Quy tắc (trái) và Kiến thức (phải), mỗi mục có công tắc bật/tắt xanh/xám
Kiến thức & Quy tắc → 2 khối: Quy tắc (trái) và Kiến thức (phải), mỗi mục có công tắc bật/tắt xanh/xám
2

Nhập QUY TẮC — điều AI bắt buộc tuân theo

Ví dụ: giọng văn, cấu trúc caption, điều cấm. Mỗi mục gồm Tiêu đề + Nội dung, bấm “Thêm vào kho”.

3

Nhập KIẾN THỨC — thông tin để AI khai thác

Sản phẩm, giá, ưu điểm, đối tượng khách hàng… AI sẽ dựa vào đây để viết caption và vẽ ảnh đúng chủ đề của bạn.

💡 Công tắc xanh = AI đang dùng mục này. Tắt đi nếu muốn thử nghiệm mà không xoá. AI soạn caption và viết prompt ảnh đều đọc từ kho này.

➜ Kho kiến thức càng đầy → Chương 6 (AI soạn caption, tạo ảnh) càng chất. Làm xong chuyển sang Chương 6 nạp nội dung.

6

Nạp nội dung: video, ảnh AI, caption & hashtag

Chuẩn bị 3 nguyên liệu trước khi tạo bài: (a) video, (b) ảnh, (c) caption/hashtag. Có thể chuẩn bị dần, không cần đủ hết mới đăng.

1

4a — Upload video vào Thư viện

Thư viện video → bấm khung nét đứt để chọn tệp từ máy; danh sách bên dưới hiển thị dung lượng, thời lượng tự đọc
Thư viện video → bấm khung nét đứt để chọn tệp từ máy; danh sách bên dưới hiển thị dung lượng, thời lượng tự đọc

MP4/MOV/WebM, tối đa 10 phút & 4GB. Hệ thống tự đọc thời lượng và tự băm SHA-256 để cảnh báo video trùng (bản trùng được gộp, không lưu 2 lần).

💡 Đang upload video lớn mà đổi ý? Bấm “Huỷ upload” ngay dưới thanh tiến trình.

2

4b — Tạo ảnh bằng AI trong Kho hình

Kho hình AI → nhập chủ đề tiếng Việt → “✨ AI viết” tạo prompt → “Tạo ảnh”; gallery bên dưới là kho ảnh đã có
Kho hình AI → nhập chủ đề tiếng Việt → “✨ AI viết” tạo prompt → “Tạo ảnh”; gallery bên dưới là kho ảnh đã có

Bước 1: gõ chủ đề tiếng Việt → bấm “✨ AI viết” (Cerebras đọc kho kiến thức, viết prompt tiếng Anh chuẩn). Bước 2: bấm “Tạo ảnh” (Flux, mất 3–10 giây). Ảnh lưu vào kho để dùng cho bài dạng hình ảnh.

💡 Tài khoản fal.ai phải còn số dư. Chọn “Dọc 9:16” cho TikTok/Reels/Shorts, “Vuông 1:1” cho feed.

3

4c — Tạo mẫu caption và nhóm hashtag

Caption & Hashtag → trái: mẫu caption (có biến {ten_video}, {ngay}); phải: nhóm hashtag với số tag mỗi bài
Caption & Hashtag → trái: mẫu caption (có biến {ten_video}, {ngay}); phải: nhóm hashtag với số tag mỗi bài

Mẫu caption: viết sẵn khung lời, dùng biến {ten_video}, {ngay} để tự thay khi đăng. Nhóm hashtag: chứa nhiều tag, hệ thống tự quay vòng lấy N tag mỗi bài (mỗi bài một bộ khác nhau — tránh TikTok đánh dấu spam).

7

Tạo bài đăng và hẹn giờ

Trang Lịch đăng là nơi làm việc chính: chọn nội dung, để AI soạn caption, chọn nền tảng, xem trước và hẹn giờ.

1

Chọn loại nội dung: 🎬 Video hoặc 🖼️ Hình ảnh

Lịch đăng → form tạo bài: toggle Video/Hình ảnh, khối ✨ AI soạn caption, ô chọn tài khoản bên phải
Lịch đăng → form tạo bài: toggle Video/Hình ảnh, khối ✨ AI soạn caption, ô chọn tài khoản bên phải
  • Bước A — chọn video trong thư viện, hoặc bấm “🖼️ Hình ảnh” rồi tick 1–10 ảnh trong kho.
  • Bước B — viết caption thủ công, hoặc chọn mẫu caption, hoặc để AI soạn (bước 2 bên dưới).
  • Bước C — chọn nhóm hashtag (tuỳ chọn): hệ thống tự quay vòng tag theo từng bài.
2

Để AI soạn caption giúp bạn (dùng kho kiến thức ở Chương 5)

Bấm “✨ Soạn” → AI đọc kho Kiến thức & Quy tắc + chủ đề → caption + hashtag điền thẳng vào form, vẫn sửa được trước khi đăng
Bấm “✨ Soạn” → AI đọc kho Kiến thức & Quy tắc + chủ đề → caption + hashtag điền thẳng vào form, vẫn sửa được trước khi đăng

Ô chủ đề để trống cũng được — AI tự dựa vào tên video và kho kiến thức. Muốn định hướng cụ thể thì gõ chủ đề (vd: “khuyến mãi 20% cuối tuần cho máy lọc không khí”).

💡 Caption AI đã tự kèm hashtag và tuân thủ giới hạn 2.200 ký tự — bộ đếm ở khung “Xem trước” luôn cảnh báo.

3

Nếu đăng dạng hình ảnh — tick ảnh trong kho

Bấm toggle “🖼️ Hình ảnh” → lưới ảnh trong kho hiện ra → tick 1–10 ảnh → xem trước hiển thị luôn các ảnh đã chọn
Bấm toggle “🖼️ Hình ảnh” → lưới ảnh trong kho hiện ra → tick 1–10 ảnh → xem trước hiển thị luôn các ảnh đã chọn

➜ Cần ảnh trong kho trước — xem Chương 6 bước 4b (Kho hình AI).

4

Chọn nơi đăng, chế độ, quyền riêng tư — rồi đăng

  • Đăng lên đâu? — tick nhiều tài khoản cùng lúc: mỗi tài khoản là 1 bài riêng, nền tảng nào lỗi không ảnh hưởng nền tảng khác.
  • Chế độ: “Đăng ngay” (vào hàng đợi, đăng trong ~20 giây) hoặc “Hẹn giờ” (chọn ngày giờ — scheduler tự đăng đúng giờ, không cho chọn giờ quá khứ).
  • Quyền riêng tư: áp dụng TikTok (Công khai/Bạn bè/Người theo dõi/Chỉ mình tôi); YouTube tự map public/private/unlisted.
  • Kiểm tra khung Xem trước bài đăng (kèm bộ đếm 0/2200 ký tự) rồi bấm nút đăng.
8

Theo dõi hàng đợi và kết quả đăng

Sau khi tạo bài, mọi thứ tự chạy. Bạn chỉ cần theo dõi trạng thái.

1

Đọc bảng “Hàng đợi & lịch sử”

Hàng đợi tự cập nhật mỗi 5 giây: nền tảng, caption, giờ, trạng thái, link bài sau khi đăng (dừng tự cập nhật khi tab bị ẩn để tiết kiệm)
Hàng đợi tự cập nhật mỗi 5 giây: nền tảng, caption, giờ, trạng thái, link bài sau khi đăng (dừng tự cập nhật khi tab bị ẩn để tiết kiệm)

Bảng hiển thị từng bài với badge trạng thái. Bài “Đã đăng” có link bấm sang bài thật trên nền tảng. Nút hành động: Huỷ (bài đang chờ), Đăng lại (bài lỗi), Xoá (có xác nhận).

2

Hiểu màu trạng thái

Chờ đăngĐang đăngĐã đăngLỗiĐã huỷ

Bài lỗi hệ thống tự thử lại — tối đa 3 lần thử (2 lần tự retry, cách nhau 5 phút × số lần). Vẫn lỗi → badge đỏ, đọc cột lỗi để biết nguyên nhân, sửa xong bấm “Đăng lại” (được reset đủ số lần thử như bài mới).

“Tổng quan” cũng tự cập nhật 30 giây/lần — số liệu và nhật ký luôn mới.

💡 Scheduler chạy trong app — giữ cửa sổ AUTO-POST mở. Đóng app thì bài không mất: mở lại sẽ đăng bù các bài đã quá giờ.

9

Xử lý lỗi thường gặp

Triệu chứngNguyên nhân & cách xử lý
“Chưa có API key Cerebras / fal.ai” khi bấm nút AINhập key ở Cài đặt → AI (Chương 3, bước 2), nhớ bấm “Lưu cài đặt AI”.
Nút “Kiểm tra Cerebras” báo lỗiKey sai hoặc hết hạn — kiểm tra lại tại cloud.cerebras.ai. Model nên để GPT-OSS 120B.
Tạo ảnh báo “Exhausted balance / User is locked”Tài khoản fal.ai hết số dư — nạp tại fal.ai/dashboard/billing.
Bài báo lỗi “Facebook cần pageId”Tài khoản → Cấu hình trên dòng Facebook → nhập pageId của Page.
Bài “Đã đăng” nhưng chưa có linkBình thường với Blotato: nền tảng đang xử lý, hệ thống tự cập nhật link sau vài phút.
Bài báo lỗi 402Hết 20 bài free/tháng của PostPeer — chờ tháng sau, hoặc chuyển sang Blotato.
Bài không tự đăngKiểm tra app còn mở không; giờ hẹn đã qua chưa (đã quá giờ sẽ đăng bù ngay khi mở app).
Caption bị chặn “quá dài”Giảm caption hoặc bớt tag trong nhóm hashtag — giới hạn 2.200 ký tự kể cả hashtag (chỉ áp dụng khi có TikTok).
Không thấy trang vừa tạo xuất hiệnTải lại trang (F5); danh sách Tổng quan/Lịch đăng cập nhật sau mỗi thao tác.
Upload video báo vượt 4GB hoặc sai định dạngChỉ nhận .mp4/.mov/.webm ≤ 4GB — nén video trước khi upload nếu cần.
Muốn thu hồi API key đã nhậpCài đặt → nút “Xoá key…” tương ứng (PostPeer/Blotato/Cerebras/fal.ai).

💡 Cần chi tiết kỹ thuật hơn (schema, quy tắc hệ thống, cách thêm nhà cung cấp)? Toàn bộ nằm trong các file *.md tại thư mục dự án: PROJECT, ARCHITECTURE, DOMAIN, PIPELINE-GUIDE, AI-GUIDE, AUDIT.

AUTO-POST — Hướng dẫn sử dụng · Cập nhật 25/09/2026 theo giao diện bản hiện tại · ảnh chụp nằm tại public/guide/ (đổi giao diện thì chụp lại)