Quản Lý Kênh & Phân Giải Kênh Mặc Định

StackVid xây dựng cơ chế quản lý kênh trực quan trên Dashboard giúp bạn điều phối nhiều tài khoản mạng xã hội một cách dễ dàng và an toàn.

---

1. Thiết Lập Kênh Mặc Định Trên Dashboard

Trong một tài khoản, bạn có thể kết nối nhiều kênh TikTok khác nhau. Khi bạn đánh dấu một kênh là Kênh Mặc Định (isDefault):

• Mọi yêu cầu API đăng bài hoặc lấy sản phẩm giỏ hàng nếu không truyền tên kênh cụ thể sẽ tự động được xuất bản qua kênh mặc định này.
• Khi bạn đặt một kênh mới làm mặc định trên Dashboard, hệ thống sẽ tự động chuyển cờ mặc định sang kênh đó.

Thao Tác Trên Dashboard:

1. Truy cập mục Kênh (/channels) trên Dashboard.
2. Tìm kênh bạn muốn ưu tiên và bật tùy chọn Đặt làm mặc định.
3. Kênh sẽ hiển thị huy hiệu MẶC ĐỊNH để dễ dàng nhận biết.

---

2. Quy Tắc Phân Giải Kênh Khi Gọi API

Hệ thống phân tách rõ ràng giữa các tác vụ cần kênh đăng bài và các tác vụ khai thác dữ liệu công khai:

A. Đối với API Xuất Bản Video (POST /api/tiktok/upload):

• Chỉ định kênh cụ thể: Bạn có thể truyền targetChannel: "Tên Kênh" trong JSON payload để chỉ định chính xác tài khoản TikTok nhận video.
• Tự động dùng Kênh Mặc Định: Nếu bạn không truyền targetChannel, hệ thống sẽ tự động định tuyến và đăng tải qua Kênh Mặc Định đã chọn trên Dashboard.

B. Đối với API Tra Cứu & Khai Thác Dữ Liệu (Crawl Posts, Profile, Nhạc):

• Các tác vụ như Crawl Video Creator (GET /api/tiktok/user/posts), Crawl Profile (GET /api/tiktok/user/profile), và Tìm kiếm Nhạc (POST /api/tiktok/music/search) hoạt động hoàn toàn độc lập và không yêu cầu kênh đăng bài: bạn chỉ cần truyền X-API-Key hợp lệ để truy vấn dữ liệu.

---

3. Quản Lý Trạng Thái & Cập Nhật Session Trên Dashboard

Trên giao diện Dashboard → Kênh, mỗi tài khoản sẽ có trạng thái hoạt động theo thời gian thực:

• ACTIVE: Kênh đang hoạt động ổn định, phiên đăng nhập TikTok còn hiệu lực.
• EXPIRED: Phiên đăng nhập (cookies) của tài khoản TikTok đã hết hạn. Bạn chỉ cần bấm nút Cập nhật Session trên Dashboard để dán cookies mới mà không phải tạo lại kênh từ đầu.
• Xóa kênh: Bấm nút Xóa bên cạnh kênh bất kỳ lúc nào để ngắt kết nối hoàn toàn khỏi hệ thống.

⚠️ Duy Trì Phiên Khi Quản Lý Đa Tài Khoản

• Tránh bấm nút Đăng xuất (Log out) trên trang web TikTok vì hành động này lập tức hủy cookie đăng nhập của kênh, khiến trạng thái chuyển sang EXPIRED.
• Để nuôi và kết nối nhiều tài khoản TikTok cùng lúc: Hãy tạo các Profile người dùng riêng biệt trên trình duyệt Chrome (Chrome Profiles) hoặc dùng tab ẩn danh. Khi kết nối xong, chỉ cần đóng tab mà không đăng xuất.