Đăng ký kênh mạng xã hội#

Mục tiêu: Liên kết kênh TikTok, YouTube hoặc Facebook vào T-Fluencers để đủ điều kiện tham gia thử thách.

Mục tiêu#

Sau bài này, bạn sẽ có thể:

Liên kết kênh TikTok qua OAuth (cấp quyền truy cập một lần).
Liên kết kênh YouTube hoặc Facebook qua hashtag xác thực quyền sở hữu.
Hiểu các trạng thái kênh: Chờ duyệt, Đã duyệt, Chờ xác nhận, Đã hủy.

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

Đã đăng nhập T-Fluencers (Đăng ký & Đăng nhập).
Tài khoản MXH phải công khai (public) để hệ thống đọc được thông tin thống kê.
Dành cho YouTube/Facebook: bạn có quyền chỉnh sửa mô tả kênh (để dán hashtag xác thực).

Các nền tảng được hỗ trợ#

Nền tảng	Phương thức liên kết	Độ phức tạp
TikTok	OAuth (popup) — tự động	Dễ
YouTube	Nhập URL + hashtag xác thực	Trung bình
Facebook	Nhập URL + hashtag xác thực	Trung bình

ℹ️ Instagram chưa được hỗ trợ ở phiên bản hiện tại.

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

Phương án A: Liên kết kênh TikTok#

Vào menu Đăng ký kênh (/lien-ket-tai-khoan) → bấm Đăng ký kênh.
Trong modal Đăng ký kênh, chọn Đăng ký với TikTok.
Modal Đăng ký kênh TikTok mở ra, đọc hướng dẫn.
(Tùy chọn) Nếu bạn dùng nhiều tài khoản TikTok, hãy mở tiktok.com trong tab khác và đăng xuất tài khoản cũ trước.
Bấm Liên kết tài khoản.
Popup TikTok (kích thước ~450×730px) mở ra. Đăng nhập bằng tài khoản TikTok bạn muốn liên kết.
Cấp đầy đủ các quyền được yêu cầu:
- Xem thông tin cơ bản (user.info.basic)
- Xem hồ sơ (user.info.profile)
- Xem thống kê (user.info.stats)
- Xem danh sách video (video.list)
Sau khi cấp quyền, popup tự đóng và bạn thấy thông báo "Đăng ký kênh thành công!".
Kênh xuất hiện trong danh sách với badge Chờ duyệt (vàng).

Admin sẽ duyệt kênh trong 24–48 giờ làm việc.

Phương án B: Liên kết kênh YouTube#

Vào Đăng ký kênh → Đăng ký với Youtube.
Trong modal Đăng ký kênh Youtube, bạn thấy hashtag cá nhân (ví dụ: #tf_abc123).
Sao chép hashtag này.
Mở kênh YouTube của bạn trong tab khác → Tùy chỉnh kênh (Customize channel) → Cơ bản (Basic info) → Mô tả (Description) → dán hashtag vào → Lưu.
Quay lại T-Fluencers, nhập link kênh YouTube vào ô input:
- Chấp nhận: https://www.youtube.com/@tencuaban, https://www.youtube.com/channel/UC..., https://youtu.be/...
Bấm Đăng ký.
Thông báo "Đăng ký kênh thành công!" xác nhận.

💡 Sau khi Admin duyệt, bạn có thể xóa hashtag khỏi mô tả kênh YouTube.

Phương án C: Liên kết kênh Facebook#

Quy trình tương tự YouTube:

Vào Đăng ký kênh → Đăng ký với Facebook.
Sao chép hashtag cá nhân.
Vào trang Facebook cá nhân hoặc Fanpage → Giới thiệu (About) → dán hashtag → Lưu.
Quay lại T-Fluencers, nhập link trang Facebook:
- Chấp nhận: https://www.facebook.com/tencuaban, https://facebook.com/pageid
Bấm Đăng ký.
Xóa hashtag sau khi duyệt (tùy chọn).

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

Các trạng thái kênh#

Sau khi đăng ký, kênh có 1 trong 4 trạng thái (badge màu ở góc phải card):

Badge	Ý nghĩa	Hành động tiếp theo
Chờ duyệt (vàng)	Admin đang kiểm tra hashtag/quyền	Chờ 24–48h
Đã duyệt (xanh lá)	Kênh đã active, có thể tham gia thử thách	Tham gia thử thách
Chờ xác nhận (xanh dương)	Cần bạn bổ sung thông tin demographics	Bấm Cập nhật thêm thông tin kênh
Đã hủy (đỏ)	Admin từ chối (hashtag sai, không phải chủ kênh)	Liên hệ hỗ trợ hoặc đăng ký lại

Thông tin được lấy về tự động#

Khi kênh được duyệt, hệ thống hiển thị:

Ảnh đại diện kênh
Tên kênh / username
Theo dõi — số subscriber/follower
Nội dung — tổng số video (TikTok, YouTube)
Tương tác — tổng lượt xem (TikTok, YouTube)

Facebook chỉ hiển thị follower count (không có content/engagement).

Bổ sung thông tin demographics#

Khi thấy badge Chờ xác nhận, kênh cần bạn điền thêm:

Độ tuổi audience chính
Giới tính audience chính
Chủ đề nội dung chính (topics)

Bấm Cập nhật thêm thông tin kênh trên card, điền form rồi submit. Khi hoàn tất, badge chuyển sang Đã duyệt.

Lỗi thường gặp#

1. "Vui lòng nhập link kênh Youtube" / "Vui lòng nhập link trang Facebook"#

→ Ô URL đang trống. Dán link kênh vào rồi thử lại.

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

→ Link không match định dạng được hỗ trợ. Kiểm tra:

Có phải kênh (không phải video) — link đúng là youtube.com/@tenkenh hoặc /channel/UC...
Không có khoảng trắng/ký tự thừa.

3. Kênh bị Đã hủy ngay sau khi đăng ký#

Nguyên nhân phổ biến:

Hashtag chưa có trong mô tả (YouTube/Facebook) — Admin không verify được quyền sở hữu.
Kênh private — Admin không đọc được.
Kênh đã được liên kết bởi user khác — mỗi kênh chỉ gắn được với 1 Influencer.

Cách khắc phục: kiểm tra lại hashtag → bấm Đăng ký kênh và submit lại.

Bật popup cho tên miền T-Fluencers trong cài đặt trình duyệt.
Không dùng chế độ Incognito/Private (localStorage không lưu được, popup communication fail).
Không dùng in-app browser của Zalo/Telegram — mở trong Chrome/Safari.

5. TikTok yêu cầu đăng nhập tài khoản cũ#

→ Bạn đã đăng nhập sẵn 1 tài khoản TikTok khác trong trình duyệt. Mở tiktok.com → đăng xuất → thử lại.

6. Số liệu thống kê hiển thị "??"#

→ Kênh đang ở trạng thái Chờ xác nhận, cần bổ sung demographics. Bấm Cập nhật thêm thông tin kênh để hoàn tất.

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

Tôi có thể đăng ký nhiều kênh không?

Có. Bạn có thể đăng ký nhiều kênh ở nhiều nền tảng (1 TikTok + 1 YouTube + 1 Facebook), thậm chí nhiều kênh cùng nền tảng.

Có thể gỡ liên kết kênh không?

Hiện tại chưa hỗ trợ gỡ liên kết từ giao diện. Nếu cần, liên hệ hỗ trợ.

Sau khi đăng ký, số liệu kênh bao lâu cập nhật?

Hệ thống cập nhật định kỳ. Số liệu mới từ TikTok/YouTube có thể mất vài giờ đến 1 ngày để reflect.

Tôi cần tối thiểu bao nhiêu followers để đăng ký?

Frontend không có check cứng về followers; Admin duyệt theo chính sách của từng thử thách. Một số thử thách yêu cầu tối thiểu 1.000 followers.

Token TikTok hết hạn thì sao?

Hệ thống đánh dấu kênh cần re-auth. Bạn cần đăng ký lại qua cùng flow để refresh token.

Liên kết liên quan#

Tham khảo SRS: creator-portal/03-mxh