1. Bussiness | Logic
Social Tool Documentation
  • Tổng quan
  • Bussiness | Logic
    • Bussiness | Logic
  • Project
    • ADMIN
      • Tổng quan ADMIN
      • Architecture
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • Hướng dẫn sử dụng
        • Đăng nhập
        • FAQ
        • Mạng xã hội
          • Tài khoản mạng xã hội
          • Nội dung bài viết & bình luận
          • Quản lý liên kết
          • Thư viện hình ảnh
          • Thu thập dữ liệu
        • Hệ thống
          • Quản lý proxy
        • Chiến dịch
          • Tạo & quản lý chiến dịch
          • Đăng nhập tài khoản
          • Check Proxy
          • Join Group
    • API
      • Tổng quan API
      • Architecture
        • System architecture
        • Database schema
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🔑 Identity & Session
          • List users
          • Create user
          • Update info user
          • Update info user
          • List user departments
          • Delete user
          • List user's AI keys
          • Create AI key
          • Get user's active API key
          • Get supported services
          • Get supported AI models
          • Update AI key
          • Delete AI key
          • Get AI key by ID
          • List departments
          • Create department
          • Update department
          • Create department
          • Update department
          • Update department roles
          • Get department roles
          • Update department status
          • Delete department
          • List user sessions
          • Create user session
          • Delete user session
          • Get user sessions by user ID
          • Delete all user sessions
          • Update user session status
          • List user activity logs
          • Create user activity log
          • Get user activity logs
          • Delete user activity logs
          • User login
          • User registration
          • User logout
          • Logout from all devices
          • Refresh access token
          • Create api key
          • Reset password
          • Get current user
          • Get user roles
          • Create role
          • Update role
          • Update role
          • Update role
          • List user permission groups
          • Get user permission group by ID
          • Delete user permission group
          • Create user permission group
          • Update user permission group
          • Get all user permission groups with permissions
        • 🛰️ Proxy & Connectivity
          • List proxies
          • Create proxy
          • Create many proxies
          • Update proxy
          • Delete proxy
          • Get proxy by ID
          • Import proxies from CSV/Excel
          • Check expired proxies
          • Kiểm tra proxy (qua Campaign)
          • Xóa proxy
          • Cập nhật proxy
          • Proxy Group list
          • Create a Proxy Group
          • Get a Proxy Group by ID
          • Update a Proxy Group
          • Delete a Proxy Group
          • Delete a Proxy Group
          • List proxy providers
          • Create proxy provider
          • Update proxy provider
          • Delete proxy provider
          • Get proxy provider by ID
          • Import proxy packages from CSV
          • List proxy packages
          • Create proxy package
          • Update proxy package
          • Delete proxy package
          • Get proxy package by ID
          • Import proxy packages from CSV
        • 📱 Social Management
          • List socials
          • Create social
          • Update social
          • Delete social
          • Get social by ID
          • List social accounts
          • Create social account
          • Create social account
          • Get account tasks
          • Assign proxies to social account
          • Update social account
          • Delete social account
          • Get social account by ID
          • Join social account
          • Cancel social accounts
          • Cancel social accounts
          • Import social accounts from file
          • Get account usage statistics
          • Push cookies manually for specific accounts (via Campaign)
          • Đổi tên nhiều tài khoản (qua Campaign)
          • Đổi mật khẩu nhiều tài khoản (qua Campaign)
          • Đổi ảnh đại diện (qua Campaign)
          • Social Account Group list
          • Create a Social Account Group
          • Get a Social Account Group by ID
          • Create a Social Account Group
          • Delete a Social Account Group
          • List social pages
          • Create social page
          • Update social page
          • Delete social page
          • Get social page by ID
          • Batch update social page status
          • Batch delete social pages
          • Import social pages from file
          • Search social pages
          • Batch delete social pages
          • Social Page Group list
          • Create a Social Page Group
          • Get a Social Page Group by ID
          • Update a Social Page Group
          • Delete a Social Page Group
          • List social actions
          • Create social action
          • Update social type
          • Delete social action
          • Get social type by ID
          • List social pages
          • Create social content
          • Update social content
          • Delete social content
          • Get social content by ID
          • Batch delete social content
          • Import social accounts from file
          • Create a new social content group
          • Get paginated list of social content groups
          • Get social content group by ID
          • Update social content group
          • Soft delete social content group
          • Batch delete social content groups
          • Delete social content group
          • Get groups by social platform ID
          • Social Image list
          • Create a Social Image
          • Get a Social Image by ID
          • Update a Social Image
          • Delete a Social Image
          • Social Collect Data list
          • Create a Social Collect Data
          • Get a Social Collect Data by ID
        • 📁 Campaign Management
          • List campaigns
          • Create campaign
          • Update campaign
          • Delete campaign
          • Get campaign by ID
          • Create campaign platform
          • List campaign platforms
          • Update campaign platform
          • Delete campaign platform
          • Get campaign platform by ID
          • Create campaign platform
          • Create campaign platform
          • Clone campaign platforms
          • Cancel multiple campaign platforms
          • List campaign joins
          • Create campaign platform
          • List campaign joins
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • List jobs
          • Update job
          • Delete job
          • Get job by ID
          • List campaign platform tasks
          • Create campaign platform task
          • Update campaign platform task
          • Delete campaign platform task
          • Get campaign platform job task by ID
          • List Report Categories
          • Create Report Categories
          • Create Report Categories
          • Create Report Categories
          • List Report Details
          • Create Report Details
          • Create Report Details
          • Create Report Details
    • TOOL
      • Tổng quan TOOL
      • Architecture
        • Database schema
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🎯 NATS — Task
          • [NATS RPC] Tạo batch Task mới
          • [NATS RPC] Lấy danh sách tất cả Tasks
          • [NATS RPC] Đếm số Task đang chờ xử lý
          • [NATS RPC] Xóa tất cả Tasks
        • 🍪 NATS — Cookie
          • [NATS RPC] Thêm batch Cookie (Auto Login)
          • [NATS RPC] Lấy danh sách tất cả Cookies
          • [NATS RPC] Xóa tất cả Cookies
        • 🌐 NATS — Proxy
          • [NATS RPC] Gửi batch Proxy để kiểm tra
        • 🔗 NATS — TaskJoin
          • [NATS RPC] Tạo lệnh tham gia Group
          • [NATS RPC] Kiểm tra trạng thái tham gia Group
        • 📤 NATS — Callbacks
          • [NATS PUB] Kết quả thực thi Task
          • [NATS PUB] Kết quả Crawl dữ liệu
          • [NATS PUB] Kết quả Auto Login
          • [NATS PUB] Kết quả kiểm tra Proxy
          • [NATS PUB] Kết quả tham gia Group
          • [NATS PUB] Kết quả kiểm tra trạng thái tham gia
        • 📊 HTTP — Logs & Info
          • Service Root — Thông tin Worker
          • Health Check
          • Đọc file log
          • Log hôm nay
          • Log theo ngày cụ thể
          • Danh sách ngày có log
          • Test kết nối ChatGPT
        • 📋 HTTP — Data Query
          • Danh sách Tasks (phân trang + lọc)
          • Xóa tất cả Tasks
          • Danh sách tất cả Cookies
          • Xóa tất cả Cookies
          • Xóa Cookie theo _id
          • Danh sách Proxies (lọc theo task_id)
          • Xóa tất cả Proxies
          • Proxy Checks đang chờ xử lý
          • Proxy Checks đã hoàn thành
          • Xóa Proxy theo _id
          • Danh sách Task Join (phân trang + lọc)
          • Tạo Task Join (HTTP mode)
          • Xóa tất cả Task Join
  • Schemas
    • AIInfo
    • CommentInfo
    • ReplyInfo
    • ShareInfo
    • CaptchaInfo
    • PageInfo
    • SocialAccountInfo
    • ProxyInfo
    • SocialInfo
    • ActionInfo
    • CreateTaskPayload
    • CreateCookiePayload
    • CreateProxyPayload
    • CreateTaskJoinPayload
    • NatsAcceptedResponse
    • NatsRejectedResponse
    • NatsErrorResponse
    • TaskCompletedPayload
    • CookieUpdatePayload
    • ProxyCheckResultPayload
    • TaskJoinResultPayload
    • TaskJoinCheckResultPayload
    • PagingInfo
    • AppError
  1. Bussiness | Logic

Bussiness | Logic

📢 Quản lý Chiến dịch – Business Logic#

Module Quản lý Chiến dịch là trung tâm điều phối toàn bộ hoạt động seeding trên các nền tảng mạng xã hội (Facebook, Google, v.v.).

Cho phép tạo, quản lý, theo dõi tiến trình và thống kê kết quả các chiến dịch tương tác tự động như Like, Comment, Follow, Join Group, Nuôi Via, v.v.
🎯 1. Mục tiêu nghiệp vụ
Social Tool – Quản lý Chiến dịch là công cụ tự động hoá các tương tác trên mạng xã hội ở quy mô lớn. Cụ thể:
  • Seeding hàng loạt: Tự động thực hiện Like, Comment, Share, Follow trên nhiều bài viết/trang bằng hàng chục đến hàng trăm tài khoản clone/via.
  • Nuôi Via (Account Warming): Tạo chiến dịch "nuôi" tài khoản Facebook trong thời gian dài (VD: 30 ngày) để tăng trust score trước khi dùng cho seeding chính.
  • Đăng nhập hàng loạt: Login nhiều tài khoản mạng xã hội đồng thời, kiểm tra trạng thái hoạt động (cookie còn sống, 2FA lỗi, v.v.).
  • Join Group hàng loạt: Tự động tham gia các nhóm Facebook mục tiêu bằng nhiều tài khoản.
  • Check Proxy: Kiểm tra trạng thái proxy trước khi gắn cho tài khoản, đảm bảo proxy hoạt động ổn định.
  • Thống kê & báo cáo: Theo dõi realtime tiến trình chiến dịch (thành công / thất bại / đang chạy), xuất báo cáo chi tiết.
🔧 2. Điều kiện cần để vận hành tool
Trước khi tạo bất kỳ chiến dịch nào, cần chuẩn bị đầy đủ các yếu tố sau:
  1. Đăng nhập hệ thống — Cần tài khoản quản trị (VD: tleo@gmail.com) để truy cập giao diện quản lý.
  2. Tài khoản mạng xã hội (Mạng xã hội → Tài khoản) — Thêm các tài khoản Facebook/Google (clone, via) vào hệ thống. Mỗi tài khoản cần:
    • UID hoặc thông tin đăng nhập (email, phone, cookie)
    • Thuộc một Nhóm tài khoản (VD: Clone seeding, 2nd)
    • Trạng thái đăng nhập hợp lệ: Đang hoạt động hoặc Chờ đăng nhập
  3. Proxy (Hệ thống → Quản lý Proxy) — Thêm proxy và gắn proxy cho từng tài khoản để tránh bị phát hiện. Hỗ trợ IP:Port format (VD: 14.241.72.150:55534).
  4. Liên kết mục tiêu (Mạng xã hội → Quản lý liên kết) — Thêm danh sách URL mục tiêu (bài viết, trang, nhóm Facebook) mà chiến dịch sẽ tương tác. Hỗ trợ:
    • Loại: page, post, group
    • Import hàng loạt qua Excel
    • Tìm page ads tự động
    • Quản lý theo nhóm liên kết
  5. Nội dung (Mạng xã hội → Nội dung) — Cấu hình template bình luận, bài viết mẫu cho các hành động cần nội dung (Comment, Post).
  6. Thư viện hình ảnh (Mạng xã hội → Thư viện hình ảnh) — Upload ảnh sẵn để gắn vào bài viết/bình luận khi chiến dịch chạy.
⚠️ Bắt buộc hoàn tất ít nhất bước 1–4 thì hệ thống mới có thể thực thi chiến dịch.
🚀 3. Cách để chạy chiến dịch
Bước 1 — Tạo nhóm chiến dịch
  1. Vào Chiến dịch → Chiến dịch (sidebar).
  2. Nhấn nút ⊕ Tạo mới (góc phải trên).
  3. Điền form tạo mới:
    • Mạng xã hội: Chọn nền tảng (Facebook, Google, v.v.).
    • Tên: Đặt tên chiến dịch (VD: Facebook - Nuôi Via 30 Ngày).
    • Mô tả: Ghi chú mục đích chiến dịch.
    • Ngày bắt đầu / Ngày kết thúc: Chọn khoảng thời gian chạy (VD: 2026-03-23 → 2026-03-30).
    • Hoạt động: Bật toggle để kích hoạt chiến dịch ngay sau khi tạo.
  4. Nhấn Tạo mới để lưu.
Bước 2 — Tạo hành động trong chiến dịch
Sau khi có nhóm chiến dịch, nhấn nút ⊕ Tạo hành động trên dòng chiến dịch tương ứng.
  1. Hành động: Chọn loại hành động — Thích (Like), Bình luận, Theo dõi, Chia sẻ, v.v.
  2. Tên: Đặt tên mô tả cho hành động (VD: Like Post Tháng 3).
  3. Ngày bắt đầu: Thời điểm khởi chạy hành động.
  4. Chi tiết hành động:
    • Độ trễ (giây): Khoảng cách giữa các lần tương tác (VD: 20 giây) để tránh bị phát hiện spam.
    • Số liên kết / tài khoản: Mỗi tài khoản sẽ tương tác bao nhiêu link (VD: 2).
  5. Chọn tài khoản: Chọn Tất cả hoặc Cụ thể — hệ thống hiển thị tổng số tài khoản đã chọn (VD: 69 tài khoản).
  6. Cấu hình bài viết: Với hành động Like/React, chọn loại reaction:
    • 👍 Like   ❤️ Heart   😍 Give Heart   😂 Haha   😮 Surprise   😢 Cry   😡 Angry
  7. + Thêm hành động phụ: Có thể gắn hành động phụ kèm theo (VD: Like + Comment).
💡 Ước tính hệ thống: Sau khi cấu hình, hệ thống tự động tính toán:

  • Số tác vụ: VD: 138 tác vụ (69 tài khoản × 2 liên kết/tài khoản)

  • Thời gian chạy: VD: 11 phút, 30 giây
Nhấn Tạo mới để lưu hành động. Hành động sẽ xuất hiện trong bảng của nhóm chiến dịch.
🔄 4. Cơ chế cập nhật trạng thái
4.1 Trạng thái chiến dịch (Tự động)
Hệ thống tự động cập nhật cột Trạng thái trong bảng dựa trên tiến trình xử lý:
  • Đang chạy — Hành động đang được thực thi bởi worker.
  • Kết thúc — Tất cả task đã hoàn thành (thành công hoặc thất bại).
  • Xảy ra lỗi — Xảy ra lỗi trong quá trình xử lý.
  • Đang chờ — Hành động đã tạo nhưng chưa đến thời điểm chạy.
4.2 Bật / Tắt chiến dịch (Thủ công)
  • Nhấn biểu tượng ✏️ Chỉnh sửa (icon bút) cạnh tên nhóm chiến dịch.
  • Trong modal chỉnh sửa, toggle Hoạt động (bật/tắt) để kích hoạt hoặc tạm dừng chiến dịch.
  • Cập nhật ngày bắt đầu/kết thúc nếu cần điều chỉnh thời gian chạy.
4.3 Tuỳ chọn từng hành động
  • Cột Tuỳ chọn (icon ⋮) trong bảng cho phép: chỉnh sửa, xoá, hoặc chạy lại hành động cụ thể.
4.4 Trạng thái tài khoản mạng xã hội
  • Đang hoạt động — Tài khoản đăng nhập thành công, cookie hợp lệ.
  • Chờ đăng nhập — Cần được login lại.
  • Xảy ra lỗi — Tài khoản bị khoá, yêu cầu xác minh, hoặc 2FA không đúng.
📊 5. Cơ chế thống kê kết quả
5.1 Thống kê theo chiến dịch
Nhấn nút Thống kê kết quả trên dòng nhóm chiến dịch → mở modal "Báo cáo chiến dịch".
  • Bộ lọc: Chọn khoảng thời gian (VD: 24-03-2026 → 30-03-2026) và loại hành động.
  • Tổng quan (Summary Cards):
    • 🟦 Tổng chiến dịch — Số chiến dịch trong khoảng thời gian.
    • 🟪 Tổng hành động — Tổng số hành động đã tạo.
    • 🟦 Tổng số tasks hoạt động — Tổng task đã/đang được thực thi.
    • 🟪 Tổng số tài khoản sử dụng — Số tài khoản tham gia.
    • 🟩 Tổng số trang đã tương tác — Số link/page mục tiêu đã được tương tác.
  • Trạng thái chi tiết:
    • ✅ Tổng thành công
    • ⏳ Tổng đang chờ
    • 🔄 Tổng đang chạy
    • ❌ Tổng thất bại
    • 🚫 Tổng task đã huỷ
  • Thống kê hành động phụ: Tương tự như trên nhưng dành cho các sub-action đi kèm.
5.2 Biểu đồ chi tiết
Phía dưới modal báo cáo có 4 tab biểu đồ:
  • Tổng hợp: Biểu đồ tổng quan theo thời gian.
  • Hành động: Phân bổ theo loại hành động (Like, Comment, Follow, v.v.).
  • Hành động phụ: Phân bổ theo sub-action.
  • Trạng thái: Phân bổ theo trạng thái (thành công / thất bại / đang chạy).
5.3 Xuất báo cáo
Nhấn nút 📥 Tải báo cáo để export dữ liệu thống kê ra file.
5.4 Theo dõi realtime trong bảng
Mỗi hành động trong bảng chiến dịch hiển thị các cột realtime:
  • Thành công / Tổng: Tỉ lệ thành công (VD: 14 / 50).
  • Tiến trình: Thanh tiến trình phần trăm (progress bar).
  • Trạng thái: Badge trạng thái (Đang chạy / Kết thúc / Lỗi).
  • Ngày bắt đầu: Timestamp chính xác (VD: 16:25 27/03/2026).
🗂 6. Các module liên quan trong sidebar
📢 Chiến dịch
  • Chiến dịch — Tạo & quản lý campaign + action
  • Tài khoản — Chiến dịch đăng nhập hàng loạt
  • Proxy — Check proxy
  • Join Group — Chiến dịch join group hàng loạt
🌐 Mạng xã hội
  • Tài khoản — Quản lý Facebook/Google accounts
  • Nội dung — Template comment/bài viết
  • Quản lý liên kết — Danh sách URL mục tiêu
  • Thư viện hình ảnh — Ảnh dùng cho bài viết
  • Thu thập dữ liệu — Scraping dữ liệu MXH
⚙️ Hệ thống & Cấu hình
  • Hệ thống — Quản lý proxy, hạ tầng
  • Người dùng — Quản lý user hệ thống
  • Thiết lập hệ thống — Cấu hình chung
🔁 7. Flow vận hành tổng quan
  1. Chuẩn bị dữ liệu: Import tài khoản MXH + Proxy + Liên kết mục tiêu + Nội dung.
  2. Gắn Proxy cho tài khoản: Đảm bảo mỗi tài khoản có proxy riêng.
  3. Đăng nhập tài khoản: Chạy chiến dịch Login để xác nhận cookie/session hợp lệ.
  4. Tạo chiến dịch: Tạo nhóm chiến dịch với thời gian chạy.
  5. Tạo hành động: Gắn hành động (Like, Comment, v.v.) + chọn tài khoản + liên kết.
  6. Hệ thống thực thi: Worker backend tự động thực thi task, cập nhật trạng thái realtime.
  7. Theo dõi & thống kê: Xem tiến trình trong bảng hoặc mở Báo cáo chiến dịch.
  8. Xuất báo cáo: Download report khi chiến dịch kết thúc.
💡 Gợi ý: Luôn kiểm tra trạng thái proxy và tài khoản trước khi chạy chiến dịch lớn. Sử dụng chức năng Thống kê kết quả để đánh giá hiệu suất và điều chỉnh chiến lược seeding phù hợp.
Modified at 2026-03-31 02:43:55
Previous
Tổng quan
Next
Tổng quan ADMIN
Built with