Import nội dung hàng loạt#

Mục tiêu: Khi Influencer đã đăng sẵn nhiều bài ngoài MXH, Admin nhập hàng loạt link vào hệ thống thay vì để họ submit từng cái.

Mục tiêu#

• Sử dụng modal Import Content để nhập nhiều URL cùng lúc.
• Gán đúng Creator + Event.
• Xem lịch sử import và xử lý link lỗi.

Điều kiện tiên quyết#

• Có quyền Import content.
• Biết Creator ID (Influencer) và Event ID (thử thách) mục tiêu.
• Các URL hợp lệ (public, không bị xóa).

Các bước thực hiện#

1. Mở modal Import#

1. Vào Nội dung (/content).
2. Bấm nút Import Content (top-right).

2. Điền form#

• Creator (bắt buộc) — chọn Influencer.
• Event (bắt buộc) — chọn thử thách.
• Content Groups — 1 hoặc nhiều group, mỗi group gồm:
  • Links — paste URL, mỗi link 1 dòng.
  • Source — nền tảng của các link đó (TikTok/YouTube/Facebook/Instagram).

💡 Nếu Influencer đăng trên nhiều nền tảng, thêm nhiều group, mỗi group 1 nền tảng.

3. Submit#

1. Bấm Import.
2. Backend chạy async — check link, tạo content records.
3. Modal trả kết quả:
   • Số link hợp lệ
   • Số link lỗi (kèm lý do)
   • Danh sách content đã tạo

4. Xem lịch sử import#

Tab/section Import Tracking hiển thị:

• Thời gian import, người làm.
• Số link success / fail.
• Error detail từng link.

Chi tiết từng bước#

Format URL hợp lệ#

• TikTok: https://www.tiktok.com/@user/video/xxx
• YouTube: https://youtube.com/watch?v=xxx hoặc youtu.be/xxx
• Facebook: https://facebook.com/user/videos/xxx hoặc post URL
• Instagram: https://instagram.com/p/xxx hoặc /reel/xxx

Link phải public.

Status của content sau import#

Content tạo với status WAITING_APPROVED (Chờ duyệt) — cần Admin duyệt như bài user submit.

Import vs User submit — khác gì?#

	User submit	Admin import
Người tạo	Influencer	Admin (log bởi Admin)
Status init	Chờ duyệt	Chờ duyệt
Check hashtag	Có	Có (cùng logic)
Audit trail	user action	admin bulk action

Use cases#

• Influencer quên submit bài quan trọng.
• Thử thách legacy — import lại bài cũ để đồng bộ.
• Migration từ hệ thống khác.

Lỗi thường gặp#

1. "Link không hợp lệ"#

• URL không match regex của source đã chọn.
• Đảm bảo bạn chọn đúng Source với URL (không chọn TikTok cho link YouTube).

2. "Content đã tồn tại"#

• URL đã được import/submit trước. Backend dedup theo URL.
• Không cần import lại.

3. "Creator không tồn tại"#

• Chọn Creator không đúng. Kiểm tra lại danh sách.

4. Import thành công nhưng không thấy trong bảng#

• Filter đang hạn chế (status, period). Clear filter.
• Hard refresh.

5. Link bị MXH block khi crawl#

• MXH đôi khi chặn bot. Có cơ chế retry.
• Nếu liên tục fail, liên hệ DevOps.

Câu hỏi thường gặp (FAQ)#

Import bao nhiêu link/lần?

Tùy backend. Thường ≤ 100 links/lần để tránh timeout. Nếu cần nhiều hơn, chia batch.

Có auto duyệt sau import không?

Không. Tất cả content import vẫn ở Chờ duyệt. Admin cần duyệt hoặc dùng Blacklist & Auto-approval để tự duyệt.

Import từ file Excel/CSV được không?

Hiện UI chỉ hỗ trợ paste link. Nếu dữ liệu trong Excel, copy cột link → paste vào ô Links.

Có cần Influencer approve việc import không?

Không technical. Nhưng về pháp lý/business: nên thông báo cho Influencer để họ biết bài được đưa vào thử thách.

Import xong có notification cho Influencer không?

Có. Hệ thống gửi notification "Bài của bạn đã được thêm vào thử thách X".

Liên kết liên quan#

• Duyệt nội dung
• Blacklist & Auto-approval

---

Tham khảo SRS: admin-portal/04-noi-dung