Cấu hình script Comment

Trang này mô tả các tham số cấu hình của script comment dùng khi tạo task.

Tổng quan

Script comment dùng để tự động đăng bình luận trên bài viết TikTok hoặc Instagram. Khi bạn cung cấp nhiều URL bài viết mục tiêu qua API, mỗi URL mục tiêu sẽ tạo một task. Bạn có thể dùng start_time để kiểm soát thời điểm thực thi của từng task.

Cấu hình script (`script_config`)

Đối tượng script_config chứa các tham số của script comment. Các tham số khả dụng:

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
target_post_urls	string[]	Có*	[]	Mảng URL bài viết mục tiêu cần comment (mỗi URL tương ứng 1 task)
target_post_url	string	Có*	""	Một URL bài viết mục tiêu hoặc nhiều URL cách nhau bằng xuống dòng/dấu phẩy
comment_content	string	Có	""	Nội dung bình luận. Có thể chứa nhiều bình luận cách nhau bằng xuống dòng
comment_order	string	Không	"random"	Cách chọn bình luận: `random` (ngẫu nhiên) hoặc `sequential` (tuần tự)
insert_emoji	boolean	Không	false	Có chèn emoji ngẫu nhiên vào bình luận hay không
comment_image_path	string	Không	""	Đường dẫn ảnh cho bình luận kèm ảnh (chỉ TikTok). Hỗ trợ đường dẫn tuyệt đối hoặc tương đối với `work_dir/upload/`

ghi chú

Bạn phải cung cấp target_post_urls hoặc target_post_url. Nếu cung cấp cả hai, target_post_urls được ưu tiên.

Bình luận kèm ảnh (chỉ TikTok)

Tham số comment_image_path cho phép bạn đính kèm ảnh vào bình luận. Tính năng này chỉ hỗ trợ trên TikTok - bình luận Instagram không hỗ trợ đính kèm ảnh. Ảnh sẽ được đẩy lên thiết bị và chọn làm ảnh đầu tiên trong thư viện.

Tạo task

Khi cung cấp nhiều URL bài viết mục tiêu, API sẽ tạo một task cho mỗi URL bài viết mục tiêu. Ví dụ, nếu bạn chỉ định 3 URL bài viết và 2 thiết bị, hệ thống sẽ tạo 6 task. Dùng start_time để kiểm soát thời điểm task bắt đầu chạy.

Ví dụ

Comment một bài viết

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "Nội dung tuyệt vời! 🔥"
    }
  }'

Dùng nhiều mẫu bình luận

Cung cấp nhiều bình luận cách nhau bằng xuống dòng. Hệ thống sẽ chọn một bình luận theo comment_order:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "Video quá hay!\nRất thích nội dung này!\nTiếp tục phát huy nhé! 👏\nThật sự rất tốt!",
      "comment_order": "random"
    }
  }'

Comment nhiều bài viết

Khi comment nhiều bài viết, mỗi bài viết sẽ tạo một task:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ],
      "comment_content": "Video hay!\nQuá tuyệt!\nRất thích!",
      "comment_order": "sequential"
    }
  }'

Thao tác này sẽ tạo 3 task độc lập và chạy ngay.

Comment theo lịch

Dùng start_time để lên lịch thời điểm task bắt đầu:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "Bình luận theo lịch!"
    },
    "start_time": "14:30"
  }'

Comment có chèn emoji

Bật chèn emoji tự động để bình luận sinh động hơn:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "Thật tuyệt vời",
      "insert_emoji": true
    }
  }'

Comment theo chế độ danh sách username

Tạo task comment trực tiếp cho các tài khoản chỉ định:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123",
      "comment_content": "Video khá tốt!"
    }
  }'

Comment hàng loạt trên nhiều thiết bị

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@viral/video/999",
      "comment_content": "Nội dung rất hay!\nTác phẩm xuất sắc!\nRất thích!",
      "comment_order": "random"
    },
    "enable_multi_account": true
  }'

Ví dụ comment Instagram

API tương tự cũng áp dụng cho bài viết Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/",
      "comment_content": "Bức ảnh rất đẹp! 📸",
      "insert_emoji": true
    }
  }'

Ví dụ comment ảnh trên TikTok

Đính kèm ảnh vào bình luận TikTok của bạn (Instagram không hỗ trợ):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "comment",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890",
      "comment_content": "Xem ảnh này nhé!",
      "comment_image_path": "C:/images/my_image.jpg"
    }
  }'

Đường dẫn ảnh

comment_image_path có thể là:

Đường dẫn tuyệt đối: C:/images/my_image.jpg hoặc /home/user/images/my_image.jpg
Đường dẫn tương đối: my_image.jpg (tương đối với work_dir/upload/)

Phản hồi

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [301, 302, 303],
    "created_count": 3
  }
}

Thứ tự bình luận

Ngẫu nhiên (`random`)

Chọn ngẫu nhiên một bình luận từ danh sách đã cung cấp
Phù hợp để bình luận trông tự nhiên hơn
Hành vi mặc định

Tuần tự (`sequential`)

Chọn bình luận theo thứ tự dựa trên job_count
Task đầu dùng bình luận đầu tiên, task thứ hai dùng bình luận thứ hai, v.v.
Khi đến cuối danh sách sẽ quay lại từ đầu
Phù hợp để phân phối nhiều bình luận khác nhau giữa các task

Tổng quan​

Cấu hình script (script_config)​

Tham số​

Ví dụ​

Comment một bài viết​

Dùng nhiều mẫu bình luận​

Comment nhiều bài viết​

Comment theo lịch​

Comment có chèn emoji​

Comment theo chế độ danh sách username​

Comment hàng loạt trên nhiều thiết bị​

Ví dụ comment Instagram​

Ví dụ comment ảnh trên TikTok​

Phản hồi​

Thứ tự bình luận​

Ngẫu nhiên (random)​

Tuần tự (sequential)​