การกำหนดค่าสคริปต์ Post

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

ภาพรวม

สคริปต์ post ใช้สำหรับเผยแพร่เนื้อหา (วิดีโอหรือรูปภาพ) ไปยัง TikTok หรือ Instagram โดยอัตโนมัติ รองรับวิธีการโพสต์หลากหลาย แหล่งที่มาของวัสดุ และตัวเลือกเสียง

พารามิเตอร์คำขอ

เมื่อสร้างงาน คุณสามารถระบุพารามิเตอร์ระดับบนสุดต่อไปนี้:

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
serials	string[]	มีเงื่อนไข	[]	รายการหมายเลขซีเรียลอุปกรณ์ (โหมด 1: ตามอุปกรณ์)
usernames	string[]	มีเงื่อนไข	[]	รายการชื่อผู้ใช้เพื่อสร้างงาน (โหมด 2: ตามชื่อผู้ใช้)
script_name	string	ใช่	-	ชื่อสคริปต์ที่จะรันเนื้อหา (เช่น "post")
script_config	object	ใช่	-	พารามิเตอร์การกำหนดค่าสคริปต์ (ดูด้านล่าง)
enable_multi_account	boolean	ไม่	false	เปิดใช้งานโหมดหลายบัญชี (สร้างงานสำหรับแต่ละบัญชีในอุปกรณ์)
start_time	string	ไม่	-	เวลาเริ่มต้นเสริม ในรูปแบบ "HH:MM"
platform	string	มีเงื่อนไข*	auto	แพลตฟอร์มเป้าหมาย: tiktok, instagram. ดูหมายเหตุด้านล่าง

หมายเหตุ: ต้องระบุ serials หรือ usernames อย่างใดอย่างหนึ่ง

*พฤติกรรมพารามิเตอร์ Platform:

• TikMatrix และ IgMatrix: พารามิเตอร์ platform จะถูกละเว้นหากมีการระบุ แพลตฟอร์มจะถูกกำหนดโดยอัตโนมัติจากชื่อแอป (TikMatrix → tiktok, IgMatrix → instagram)
• TikMatrix Pro: พารามิเตอร์ platform เป็นสิ่งจำเป็นและต้องระบุอย่างชัดเจนเป็น tiktok หรือ instagram

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

วัตถุ script_config มีพารามิเตอร์สำหรับสคริปต์ post ด้านล่างเป็นพารามิเตอร์ที่มีอยู่:

พารามิเตอร์ทั่วไป (TikTok และ Instagram)

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
content_type	integer	ไม่	0	ประเภทเนื้อหา: 0 = วิดีโอ, 1 = รูปภาพ
image_count	integer	ไม่	1	จำนวนรูปภาพที่จะเลือก (เมื่อ content_type = 1)
captions	string	ไม่	""	ข้อความคำบรรยายโพสต์ รองรับรูปแบบ spintax: {ตัวเลือก1|ตัวเลือก2|ตัวเลือก3}
caption_format	string	ไม่	"multiline"	วิธีจัดการคำอธิบายหลายบรรทัด: multiline (แทรกบรรทัดใหม่จริง) หรือ singleline (แทนที่ \n ด้วยช่องว่าง)
ai_label	boolean	ไม่	false	ว่าจะเพิ่มป้ายกำกับเนื้อหาที่สร้างโดย AI ลงในโพสต์หรือไม่
save_draft	boolean	ไม่	false	บันทึกโพสต์เป็นฉบับร่างแทนที่จะเผยแพร่ทันที
post_way	string	ไม่	"addButton"	วิธีการโพสต์ ดูรายละเอียดได้ที่ส่วน วิธีการโพสต์ ด้านล่าง
material_source	string	ไม่	"materialLibrary"	แหล่งที่มาของวัสดุ: materialLibrary หรือ localFolder (ถูกละเว้นถ้ามี material_list)
material_path	string	มีเงื่อนไข	""	เส้นทางโฟลเดอร์ภายในเครื่อง (จำเป็นเมื่อ material_source = "localFolder")
material_list	string[]	ไม่	[]	อาร์เรย์เส้นทางไฟล์วัสดุโดยตรง เมื่อระบุจะข้าม logic ของ material_source และ material_path เหมาะสำหรับระบบอัตโนมัติ API
materials_tags	string	ไม่	""	แท็กวัสดุที่คั่นด้วยจุลภาคสำหรับกรองจากคลัง
upload_wait_time	integer	ไม่	10	วินาทีในการรอการอัปโหลดเสร็จสิ้น

upload_wait_time ใช้กับทั้งการโพสต์ปกติและโหมด save_draft แม้จะบันทึกเป็นฉบับร่าง TikTok/Instagram ก็ยังต้องใช้เวลาอัปโหลดวิดีโอให้เสร็จในเบื้องหลัง. | sound_wait_time | integer | ไม่ | 10 | วินาทีในการรอการโหลดเสียง | | add_sound | string/integer | ไม่ | "-1" | ตัวเลือกเสียง: -1 = เริ่มต้น, 0 = ปิด, 1 = เปิด, custom = ใช้เสียงกำหนดเอง | | sound_name | string | มีเงื่อนไข | "" | ชื่อเสียง/URL (จำเป็นเมื่อ post_way = "useSound") | | custom_sound_keyword | string | มีเงื่อนไข | "" | คำค้นหาเสียงกำหนดเอง (จำเป็นเมื่อ add_sound = "custom") | | origin_sound_volume | integer | ไม่ | 100 | ระดับเสียงต้นฉบับ (0-100) | | add_sound_volume | integer | ไม่ | 100 | ระดับเสียงที่เพิ่ม (0-100) |

วิธีการโพสต์ (post_way)

พารามิเตอร์ post_way ควบคุมวิธีที่สคริปต์เปิดหน้าจอโพสต์:

ค่า	คำอธิบาย
addButton	(ค่าเริ่มต้น) แตะปุ่มสร้าง "+" ภายในแอป จากนั้นเลือกสื่อจากแกลเลอรีของอุปกรณ์ ใช้งานได้กับทุกตำแหน่งการโพสต์ (reel, story, post) แนะนำสำหรับกรณีส่วนใหญ่
share	เรียก Android share intent โดยตรงจากไฟล์สื่อไปยังแอป Instagram/TikTok เป็นวิธีทางเลือกที่ข้ามการนำทาง داخلแอป เหมาะเมื่อขั้นตอน addButton ไม่เสถียรบนอุปกรณ์หรือเวอร์ชันแอปบางรายการ
useSound	ไปยังแทร็กเสียงที่ระบุก่อน (ผ่าน URL หรือคีย์เวิร์ดใน sound_name) แล้วจึงแนบวิดีโอกับเสียงนั้น ใช้ได้เฉพาะ Reels / TikTok เท่านั้น ต้องตั้งค่า sound_name และไม่รองรับกับ placement = "post" หรือ placement = "story"

note

เมื่อ placement เป็น post (โพสต์ฟีด Instagram) จะไม่รองรับการทำงานเสียงอัตโนมัติไม่ว่า post_way จะเป็นค่าใดก็ตาม สคริปต์จะข้ามขั้นตอนเสียงให้อัตโนมัติ

พารามิเตอร์เฉพาะ TikTok

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
placement	string	ไม่	""	ตำแหน่งการโพสต์: "" (วิดีโอปกติ ค่าเริ่มต้น) หรือ "story" (TikTok Story) เมื่อตั้งค่า "story" สคริปต์จะคลิก "Your Story" หลังการตั้งค่าเสียง โดยข้ามขั้นตอนหัวข้อ/ลิงก์สินค้า/ป้ายกำกับ AI
add_product_link	integer	ไม่	0	ว่าจะเพิ่มลิงก์สินค้า/ช้อปปิ้งหรือไม่: 0 = ไม่, 1 = ใช่

พารามิเตอร์เฉพาะ Instagram

พารามิเตอร์	ประเภท	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
placement	string	ไม่	"reel"	ตำแหน่งการโพสต์: reel (Reels), story (Stories) หรือ post (โพสต์ปกติในฟีด) หมายเหตุ: ไม่รองรับตัวเลือกเสียงเมื่อ placement เป็น post
enable_schedule_reels	boolean	ไม่	false	ว่าจะกำหนดเวลา Reel สำหรับเวลาในอนาคตหรือไม่
schedule_reels_time	string	มีเงื่อนไข	""	เวลาเผยแพร่ที่กำหนดในรูปแบบ YYYY-MM-DD HH:MM (จำเป็นเมื่อ enable_schedule_reels = true)
story_link	string	ไม่	""	URL สำหรับแนบเป็นลิงก์สติกเกอร์บน Story (ใช้ได้เฉพาะเมื่อ placement = "story")

ตัวอย่าง

โพสต์ TikTok Story

โพสต์ลง TikTok Story โดยตรง หลังการตั้งค่าเสียง สคริปต์จะคลิก "Your Story" — ไม่มีขั้นตอนหัวข้อ/ลิงก์สินค้า/ป้ายกำกับ AI :

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

งานโพสต์พื้นฐานพร้อมรายการวัสดุโดยตรง

นี่เป็นวิธีที่แนะนำสำหรับระบบอัตโนมัติ API - ส่งเส้นทางวัสดุโดยตรงโดยไม่ต้องพึ่งคลังวัสดุหรือการสแกนโฟลเดอร์:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "ชมวิดีโอใหม่ของฉัน! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

งานโพสต์พร้อมคลังวัสดุ (TikTok)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "ชมวิดีโอใหม่ของฉัน! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

งานโพสต์ตามรายการชื่อผู้ใช้

โหมดนี้ช่วยให้คุณสร้างงานสำหรับบัญชีเฉพาะได้โดยตรงโดยไม่ต้องรู้หมายเลขซีเรียลอุปกรณ์:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "ชมวิดีโอใหม่ของฉัน! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

งานโพสต์พร้อมโฟลเดอร์ภายในเครื่อง (Instagram)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "เนื้อหาที่น่าทึ่ง! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

โพสต์ฟีด Instagram (placement: post)

เผยแพร่ไปยังฟีด Instagram ปกติ (ไม่ใช่ Reel) ตำแหน่งนี้ไม่รองรับตัวเลือกเสียง:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

โพสต์พร้อมเสียงกำหนดเอง

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "เต้นตามเสียงยอดนิยมนี้!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending dance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

โพสต์โดยใช้ URL เสียงที่ระบุ

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "ใช้เสียงที่ยอดเยี่ยมนี้!",
      "material_source": "materialLibrary"
    }
  }'

โพสต์รูปภาพ (Carousel)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "ชมภาพเหล่านี้! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

โพสต์พร้อมการเลือกแพลตฟอร์มโดยชัดเจน

คุณสามารถระบุแพลตฟอร์มเป้าหมายได้อย่างชัดเจนโดยใช้พารามิเตอร์ platform มีประโยชน์เมื่อคุณต้องการแทนที่ค่าเริ่มต้นของสภาพแวดล้อม:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "กำลังโพสต์ไปยัง Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

การตอบกลับ

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

ดูเพิ่มเติม

• API การจัดการงาน - สร้าง แสดงรายการ และจัดการงาน