การกำหนดค่าสคริปต์ข้อความ

หน้านี้บันทึกพารามิเตอร์การกำหนดค่าสคริปต์ message

ภาพรวม

สคริปต์ message ส่งข้อความโดยตรงโดยอัตโนมัติให้กับผู้ใช้บน TikTok หรือ Instagram เมื่อระบุผู้ใช้เป้าหมายหลายคนผ่าน API สร้างงานหนึ่งงานต่อผู้ใช้ ควบคุมเวลาด้วย start_time

การกำหนดค่าสคริปต์ (script_config)

พารามิเตอร์สำหรับสคริปต์ข้อความ:

พารามิเตอร์

พารามิเตอร์	ชนิด	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
target_users	string[]	Yes*	[]	อาร์เรย์ผู้ใช้เป้าหมาย (หนึ่งงานต่อผู้ใช้)
target_user	string	Yes*	""	ชื่อผู้ใช้เดียวหรือหลายคนคั่นด้วยบรรทัดใหม่/จุลภาค
message_content	string	Yes	""	เนื้อหาข้อความที่จะส่ง
access_method	string	No	"direct"	วิธีเข้าถึง: direct หรือ search

note

ต้องระบุ target_users หรือ target_user หากระบุทั้งคู่ target_users มีความสำคัญกว่า

info

เมื่อระบุผู้ใช้เป้าหมายหลายคน API สร้าง หนึ่งงานต่อผู้ใช้ 3 ผู้ใช้ + 2 อุปกรณ์ = 6 งาน

ตัวอย่าง

ส่งข้อความถึงผู้ใช้หนึ่งคน

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@username_to_message"],
      "message_content": "Hello! Check out our latest content.",
      "access_method": "direct"
    }
  }'

ส่งข้อความถึงผู้ใช้หลายคน

สร้างงานหนึ่งต่อผู้ใช้:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "message_content": "Hi! We have an exclusive offer for you."
    }
  }'

สร้าง 3 งานแยกต่างหากที่ดำเนินการทันที

กำหนดการส่งข้อความด้วยเวลาเริ่มต้น

ใช้ start_time เพื่อกำหนดการ:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "message_content": "Scheduled greeting!"
    },
    "start_time": "14:30"
  }'

ส่งข้อความผ่านวิธีค้นหา

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["username1", "username2"],
      "message_content": "Hello from TikMatrix!",
      "access_method": "search"
    }
  }'

ส่งข้อความตามรายชื่อผู้ใช้

สร้างงานข้อความสำหรับบัญชีเฉพาะโดยตรง:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@target_user"],
      "message_content": "Hi there!"
    }
  }'

ส่งข้อความแบบกลุ่มบนหลายอุปกรณ์

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@influencer_account"],
      "message_content": "Love your content! Let's collaborate."
    },
    "enable_multi_account": true
  }'

ตัวอย่าง Instagram

API เดียวกันสำหรับ Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_user": "instagram_username",
      "message_content": "Hey! Loved your post"
    }
  }'

การตอบสนอง

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

วิธีการเข้าถึง

วิธีตรง (direct)

เปิดโปรไฟล์ผู้ใช้ผ่าน URL เร็วและเชื่อถือได้กว่า

วิธีค้นหา (search)

ไปที่การค้นหาและพิมพ์ชื่อ ช้ากว่าแต่ใช้ได้เมื่อ URL ถูกบล็อก

แนวปฏิบัติที่ดีที่สุด

1. กำหนดการงาน: ใช้ start_time

2. ปรับแต่งข้อความ: ทำให้ดูเป็นส่วนตัว

3. ใช้วิธีตรง: เร็วและเชื่อถือได้

4. เคารพขีดจำกัด: ไม่สร้างงานมากเกินไปในครั้งเดียว

รหัสข้อผิดพลาด

Code	Description
40001	ไม่มีผู้ใช้เป้าหมายหรือเนื้อหาข้อความ
40003	ไม่รองรับสคริปต์ผ่าน API
40301	ต้องใช้แผน Pro+

ดูเพิ่มเติม

• API การจัดการงาน
• การกำหนดค่าสคริปต์ Follow
• การกำหนดค่าสคริปต์ Comment
• ภาพรวม API ท้องถิ่น