📘 คู่มือการใช้งาน ShopSpark

สารบัญ

1. ภาพรวมและลำดับการทำงาน
2. จัดการหมวดและสินค้า
3. Gallery
4. Gen Clip แบบเลือกเอง
5. Workflow อัตโนมัติ
6. Video Post
7. ADB Template และ ADB Builder
8. เพิ่มสินค้าแบบง่าย / ดึงจากหน้าร้าน
9. เพิ่มสินค้า TikTok ผ่าน LINE
10. Request Log
11. Master Data และ Config
12. Checklist ประจำวัน
13. ตัวอย่างตั้งแต่เพิ่มสินค้าจนโพส
14. สถานะและผลกระทบของปุ่ม
15. คำถามที่พบบ่อย
16. แก้ปัญหา

1. ภาพรวมและลำดับการทำงาน

2. จัดการหมวดและสินค้า

เพิ่มหมวดสินค้า

1. เปิด Master Data → หมวดสินค้า
2. กรอกชื่อหมวดที่สื่อความหมาย เช่น เสื้อผ้าผู้หญิง หรือของใช้ในบ้าน
3. บันทึก แล้วตั้ง Prompt Template ที่เหมาะกับหมวดนั้น

เพิ่มหรือแก้สินค้า

1. เปิด Master Data → สินค้า แล้วกดเพิ่มสินค้า
2. กรอกชื่อ รายละเอียด ข้อความขาย หมวด และ Product URL
3. ใส่ URL รูปหรือ Import จาก Shopee/TikTok จากนั้นเลือกรูปที่ต้องการใช้
4. ตรวจภาพตัวอย่างก่อนบันทึก โดยระบบจะตัด query หลัง ? และเก็บภาพขนาดใหญ่เมื่อพบรูปซ้ำต่างขนาด
5. Product URL ที่มีคำว่า tiktok จะใช้ TikTok Template ส่วน Shopee URL จะใช้ Shopee Template

3. ใช้งาน Gallery

1. เลือกหมวดหรือสินค้าเพื่อกรองผลงาน
2. กดรูปหรือคลิปเพื่อดูรายละเอียดและตรวจความถูกต้อง
3. ตรวจชื่อสินค้า ภาพ เสียง Caption และแพลตฟอร์มก่อนนำไปโพส
4. หากงานยังไม่ครบ ให้กลับไป Workflow หรือ Gen Clip แล้วรันเฉพาะขั้นที่ต้องการใหม่

4. Gen Clip แบบเลือกเอง

5. Workflow อัตโนมัติเต็มวงจร

1. เปิดเมนู Workflow เลือกหมวดสินค้าและจำนวนงาน
2. ตรวจช่วงเวลาทำงาน หากอยู่นอกช่วง ระบบจะแจ้งเงื่อนไขที่ไม่ผ่าน
3. เปิด Video Post อัตโนมัติหลังรวมเสียงพากย์กับวิดีโอเสร็จ
4. เริ่ม Workflow ได้โดยยังไม่ต้องเสียบมือถือ ระบบจะสร้างสินค้าเรียงทีละรายการ และพักคลิปที่รวมเสร็จไว้ในคิวพร้อมโพสโดยไม่บล็อกสินค้าถัดไป
5. เมื่อต้องการโพส ให้เปิด ShopSpark เสียบมือถือและเชื่อม WebADB ระบบจะโพสรายการพร้อมโพสที่สะสมไว้เรียงทีละรายการ
6. รายการที่ถูกหยุด Workflow, หยุด Auto Post หรือล้างออกจากคิวแล้วจะถูกข้าม ไม่นำมาโพสจนกว่าจะสั่งเริ่มใหม่เอง
7. หากบางขั้นล้มเหลว กดเริ่มใหม่ที่ขั้นที่ระบบเสนอ ไม่จำเป็นต้องสร้างทุกอย่างใหม่

เงื่อนไข Auto Post ที่ต้องผ่าน

• เปิด Checkbox Auto Post
• มีคลิปที่รวมเสร็จและยังไม่โพส
• Product URL ระบุ Shopee หรือ TikTok ได้
• เชื่อมมือถือแล้วและไม่มี Automation อื่นทำงาน
• มี Template ของแพลตฟอร์มและโปรไฟล์มือถือที่เลือก
• หน้าเว็บยังเปิดอยู่และมือถือปลดล็อก

6. Video Post ผ่านมือถือ

1. เสียบสาย USB ปลดล็อกมือถือ และเปิด USB Debugging
2. กดเชื่อมต่อมือถือ เลือกอุปกรณ์ และอนุญาตการเชื่อมต่อบนมือถือ
3. กด Sync ขนาดจอและเลือกโปรไฟล์ที่ตรงรุ่น
4. ตรวจรายการคลิปที่พร้อมส่ง หน้าละ 10 รายการ คลิปจะไม่เล่นเอง
5. ตรวจว่า Product URL และชื่อแพลตฟอร์มถูกต้อง แล้วกด Video Post
6. ระบบส่งไฟล์ไปมือถือและรัน Template ให้ดู Log โดยไม่แตะหน้าจอมือถือ
7. เมื่อโพสสำเร็จ ระบบทำเครื่องหมายงานและปิดแอป Shopee/TikTok

ล้างคิวโพส: ปุ่มนี้ลบรายการวิดีโอที่ยังไม่โพสออกจากคิว ควรตรวจรายการก่อนยืนยัน

ป้องกันโพสซ้ำ: ก่อนโพส Server จะ Claim Job ให้เพียงหนึ่ง Browser/เครื่องเท่านั้น แท็บอื่นจะข้าม Job เดียวกัน และ Claim จะถูกปล่อยเมื่อจบหรือหมดอายุอัตโนมัติ

7. ADB Template และ Visual ADB Builder

แก้แบบ JSON

เปิด Master Data → ADB Automation Templates เลือก Shopee หรือ TikTok เลือกโปรไฟล์มือถือ แก้ JSON แล้วกดบันทึก ใช้ปุ่ม Test เพื่อทดสอบกับมือถือก่อนโพสจริง

สร้างแบบลากวาง

1. เปิด ADB Builder และโหลด Template ที่บันทึกไว้
2. ลากคำสั่งจากซ้ายลง Canvas แล้วลากเรียงลำดับ
3. คลิกการ์ดเพื่อแก้ค่าในแผงขวา
4. ลาก IF ลง Canvas แล้ววางคำสั่งในเส้นทางจริง/เท็จ
5. ตรวจ JSON Preview กดบันทึก และ Test กับมือถือ

ตัวอย่าง Template ที่มี IF และ Product ID

ตัวอย่างนี้เปิด TikTok ตรวจว่าพบคำว่า “สินค้า” หรือไม่ หากพบจะแตะคำดังกล่าว หากไม่พบจะปัดหน้าจอ จากนั้นพิมพ์ Product ID ที่ระบบแยกจาก Product URL และกด Enter:

[
  {
    "name": "เปิด TikTok",
    "type": "open_app",
    "package": "com.ss.android.ugc.trill",
    "fallbackPackage": "com.zhiliaoapp.musically",
    "wait": 2500
  },
  {
    "name": "ตรวจหาคำว่าสินค้า",
    "type": "if",
    "text": "สินค้า",
    "match": "contains",
    "timeout": 2000,
    "then": [
      {"name":"แตะสินค้า","type":"tap_text","text":"สินค้า","match":"contains","timeout":10000,"wait":1500}
    ],
    "else": [
      {"name":"ปัดขึ้นหนึ่งครั้ง","type":"swipe","x1":540,"y1":1800,"x2":540,"y2":700,"duration":300,"wait":1200}
    ]
  },
  {"name":"วาง Product ID","type":"text","source":"productId","wait":1000},
  {"name":"ส่ง Enter","type":"key","code":66,"wait":1500}
]

8. เพิ่มสินค้าแบบง่าย (ไม่ต้องเขียน JSON)

8.1 เพิ่มเองจากลิงก์สินค้าและลิงก์รูป

1. กดเมนู Import JSON แล้วใช้งาน Card แรกชื่อ เพิ่มสินค้าแบบง่าย (ไม่ต้องเขียน JSON)
2. กรอก ชื่อสินค้า หรือปล่อยว่างได้ ระบบจะใช้บรรทัดแรกของคำอธิบายมาตั้งชื่อให้
3. เลือก หมวดสินค้า ให้ถูกต้อง เพราะ Prompt และ Workflow อ้างอิงหมวดนี้
4. วาง Product URL ของ Shopee หรือ TikTok Shop ระบบจะตัดส่วน ? และข้อความด้านหลังออกตอนเพิ่ม
5. วาง ลิงก์รูปสินค้า บรรทัดละ 1 URL อย่างน้อยหนึ่งรูป แต่ละ URL ต้องขึ้นต้นด้วย http:// หรือ https://
6. กรอก คำอธิบายสินค้า รวมจุดเด่น คุณสมบัติ และข้อความขายที่ต้องการให้ AI ใช้เป็นบริบท
7. ดูภาพตัวอย่างด้านล่างช่อง URL รูป หากไม่ต้องการรูปใดให้คลิกรูปนั้นเพื่อตัดออก
8. กด ➕ เพิ่มเข้าระบบ แล้วรอข้อความ “เพิ่มสินค้าแล้ว”
9. เปิด Master Data → สินค้า ตรวจชื่อ หมวด รูป คำอธิบาย และ Product URL อีกครั้ง

8.2 ให้ระบบดึงชื่อ รายละเอียด และรูปจากหน้าสินค้า

1. ครั้งแรก ให้กด Ctrl + Shift + B เพื่อแสดง Bookmarks Bar
2. ลากปุ่ม 📌 ดึงเข้า ShopSpark ไปวางบน Bookmarks Bar ทำเพียงครั้งเดียว
3. เลือก หมวดเริ่มต้น สำหรับสินค้าที่จะดึง
4. วาง Product URL ในช่องของ Card เพิ่มสินค้าแบบง่าย ปุ่มด้านขวาจะเปลี่ยนเป็น ดึง TikTok Product หรือ เปิดหน้า Shopee
5. กดปุ่มเพื่อเปิดหน้าสินค้า รอให้รูปโหลดครบ แล้วกด Bookmark 📌 ดึงเข้า ShopSpark บนหน้าสินค้านั้น
6. รอโดยไม่ปิดแท็บ ระบบจะเปิดรูป/thumbnail ทีละรูป นำสินค้าเข้าหมวดที่เลือก และปิดแท็บรับข้อมูลอัตโนมัติ
7. กลับ ShopSpark แล้วตรวจสินค้าใน Master Data รูปที่มาจากต้นฉบับเดียวกันแต่ต่างขนาดจะเหลือรูปที่ใหญ่กว่า

8.3 Import JSON — ใช้เฉพาะเมื่อต้องเพิ่มหลายรายการ

1. เตรียมไฟล์ JSON หรือวาง Array ตามตัวอย่างในหน้าเว็บ
2. เลือกหมวดเริ่มต้นสำหรับรายการที่ไม่มี field category
3. กด ตรวจสอบข้อมูล ก่อนทุกครั้ง
4. อ่านจำนวนรายการและข้อผิดพลาด แล้วจึงกด นำเข้าระบบ
5. กลับไป Master Data ตรวจสินค้าที่นำเข้าทั้งหมด

8.4 เพิ่มสินค้า TikTok ด้วยมือถือและ LINE @108yycfx

ผู้ใช้ทำงานจากมือถือและ LINE ได้ทั้งหมด โดยส่ง Serial No ครั้งแรก แล้วส่ง TikTok URL เพื่อเพิ่มสินค้า ไม่ต้องเปิด Bookmarklet

8.4.1 ผูก LINE กับ Workspace

1. เปิดเมนู LINE Import เลือกหมวดนำเข้าเริ่มต้น และคัดลอก Serial No ที่หน้าเว็บแสดง
2. เพิ่มเพื่อน LINE Official @108yycfx และใช้แชตส่วนตัวเท่านั้น
3. ส่ง Serial No เป็นข้อความแรก เช่น SHOP-XXXXXXXXXXXX
4. ถ้า Serial ไม่อยู่ใน Whitelist ระบบจะแจ้งว่าไม่ถูกต้อง ให้ตรวจและส่งใหม่
5. ถ้า Serial ถูกต้องแต่ยังไม่พบ Workspace ให้เปิด ShopSpark ด้วย Serial นั้นอย่างน้อยหนึ่งครั้ง แล้วส่ง Serial ใหม่
6. ทุกเครื่องที่ใช้ Serial เดียวกันจะผูกกับ Workspace เดียวกันโดยอัตโนมัติ
7. เมื่อเห็นข้อความยืนยันการผูก จึงเริ่มส่ง TikTok URL ได้

8.4.2 ส่งสินค้า TikTok ผ่าน LINE

1. ในแอป TikTok กดแชร์สินค้าแล้วคัดลอกลิงก์ ตัวอย่าง https://vt.tiktok.com/ZS9MnRwBwjD5X-usU0V
2. ส่ง URL ล้วน ๆ ใน LINE ห้ามใส่คำอธิบายหรือข้อความอื่นในข้อความเดียวกัน
3. ระบบจำลอง Browser ไล่ Redirect สูงสุด 10 ครั้ง ตัด query ตั้งแต่ ? ทุกครั้ง และตรวจหา /view/product/ตัวเลข หรือ Shop URL ที่ลงท้ายด้วย Product ID
4. LINE จะตอบว่ารับ URL แล้ว พร้อมแสดง Product ID
5. ระบบตรวจสินค้าซ้ำ ดึงข้อมูล บันทึกเข้า Workspace และเริ่ม Workflow อัตโนมัติเมื่อ Workspace เปิดเงื่อนไขไว้
6. รอข้อความสรุปชื่อสินค้า จำนวนรูป หมวด และสถานะ Workflow แล้วเปิด Master Data ตรวจข้อมูล

8.4.3 ข้อความที่ส่งได้หลังผูกสำเร็จ

• ส่ง TikTok short URL หรือ TikTok Shop Product URL แบบข้อความล้วน เพื่อเพิ่มสินค้า
• พิมพ์ process list เพื่อดูสินค้าทั้งหมดที่ยังไม่โพส พร้อมขั้น Workflow สถานะปัจจุบัน และข้อความล่าสุด
• พิมพ์ process post #เลข เช่น process post #2 เพื่อโพสหมายเลขจาก Process list โดยใช้ได้เฉพาะรายการที่สถานะ พร้อมโพส ซึ่งมีวิดีโอรวมเสร็จ Caption และ Product URL ครบแล้ว; ต้องเปิด ShopSpark บนคอมและเชื่อมมือถือผ่าน WebADB ไว้
• พิมพ์ process delete #เลข เช่น process delete #2 เพื่อลบรายการออกจาก Process list และหยุดคิว Video Post โดยไม่ลบสินค้า รูป หรือผลงานเดิมออกจาก Master Data
• ห้ามพิมพ์คำอธิบาย อีโมจิ หรือข้อความขายรวมกับ URL
• ข้อความอื่นที่ไม่ใช่ URL, process list, process post #เลข หรือ process delete #เลข จะได้รับคำตอบว่า ข้อความไม่ถูกต้อง
• ถ้า LINE ไม่ตอบ ให้ลองส่งใหม่หนึ่งครั้ง ตรวจว่าใช้แชตส่วนตัวกับ @108yycfx และแจ้งผู้ดูแลพร้อมเวลาเกิดเหตุ

9. Request Log

1. เปิดเมนู Request Log เมื่อ Gen ข้อความ ภาพ วิดีโอ หรือเสียงล้มเหลว
2. หารายการจากเวลา ชนิดบริการ และสถานะ HTTP
3. เปิดรายละเอียด ตรวจ Request และ Response โดยระบบจะไม่แสดง API Key เต็ม
4. ใช้ข้อความ Error ตรวจเครดิต ชื่อโมเดล รูปแบบข้อมูล หรือการเชื่อมต่อ

10. Master Data และ Config

• อุปกรณ์ของฉัน: ดู Serial No ของ Workspace ปัจจุบัน
• หมวด/สินค้า: ข้อมูลต้นทางของการสร้างทุกงาน
• นางแบบ: รูปพรีเซนเตอร์สำหรับ Prompt ที่ต้องการบุคคล
• Prompt Templates: คำสั่งมาตรฐานแยกตามชนิดงาน
• ช่วงเวลา Workflow: วันที่และเวลาที่อนุญาตให้ระบบเริ่มงานอัตโนมัติ
• ตั้งค่า KIE AI: API Key โมเดลเสียง Voice ID และ Subtitle
• ADB Templates: ลำดับโพส Shopee/TikTok แยกตามโปรไฟล์มือถือ

11. Checklist การใช้งานประจำวัน

ก่อนเริ่ม

• ตรวจว่าเข้า Workspace ที่ถูกต้อง
• ตรวจสินค้าใหม่ ชื่อ รูป URL และข้อความขาย
• ตรวจ API Key/เครดิตและช่วงเวลา Workflow
• ปลดล็อกมือถือ เชื่อม USB และตรวจบัญชี Shopee/TikTok
• ตรวจ Auto Post และ Template ที่จะใช้

ระหว่างทำงาน

• เปิดหน้าเว็บค้างไว้และดู Progress/Log
• อย่าเริ่มงานซ้ำเมื่อรายการเดิมยังประมวลผล
• อย่าแตะมือถือขณะ ADB Automation ทำงาน

หลังจบ

• ดูคลิปเต็มก่อนยืนยันผล
• ตรวจสถานะโพสสำเร็จและตรวจโพสต์จริงในแอป
• ตรวจว่าแอปถูกปิดและไม่มีงานค้างผิดปกติ

12. ตัวอย่างจริง: เพิ่มสินค้า TikTok จนโพสสำเร็จ

ช่วง A — เตรียมสินค้า

1. คัดลอก URL หน้าสินค้า เช่น https://shop.tiktok.com/th/pdp/1734781797208720653 ไม่ต้องลบ query เอง เพราะระบบจะเก็บเฉพาะส่วนก่อน ?
2. เปิด Import JSON → เพิ่มสินค้าแบบง่าย ถ้ามีลิงก์รูปอยู่แล้ว หรือใช้ Bookmarklet “📌 ดึงเข้า ShopSpark” ถ้าต้องการให้ระบบดึงชื่อ รายละเอียด และรูปจากหน้าสินค้า
3. ตรวจชื่อสินค้า คำอธิบาย/ข้อความขาย หมวด Product URL และรูป
4. หากมีรูปเดียวกันหลายขนาด ให้เลือกภาพใหญ่ ระบบจะพยายามรวมรูปซ้ำจากต้นฉบับเดียวกันให้อัตโนมัติ
5. บันทึก แล้วเปิด Master Data → สินค้า → แก้ไข ตรวจว่าภาพแสดงครบและ URL มีคำว่า tiktok

ช่วง B — สร้างคลิป

6. เปิด Workflow เลือกสินค้าในช่อง “เริ่มเฉพาะสินค้า”
7. ถ้าจะให้โพสต่ออัตโนมัติ ให้เชื่อมมือถือและติ๊ก Video Post อัตโนมัติก่อนกดรัน
8. กด รันเฉพาะสินค้านี้ และดู Log จนผ่านคัดรูป สร้างภาพ บทพากย์ เสียง วิดีโอ และรวมไฟล์
9. ขั้นสร้างวิดีโอจะสร้าง KIE Task ID ใหม่ทุกครั้ง ไม่ใช้คลิปสำเร็จจาก Task เก่าของสินค้านั้นซ้ำ และไฟล์รวมจะเก็บ Source Video Task ID ไว้ตรวจสอบตอนส่งมือถือ
10. ถ้าขึ้นสีแดง ให้กด “เริ่มใหม่ที่…” ของขั้นที่ล้ม ไม่ควรกดเริ่มใหม่ทั้งหมดทันที
11. เมื่อรวมสำเร็จ เปิดคลิปจาก Gallery หรือ Video Post ฟังเสียง อ่าน Subtitle และตรวจภาพจนจบ

ช่วง C — โพส

11. ปลดล็อกมือถือ เปิดหน้าจอแนวตั้ง และตรวจว่าล็อกอิน TikTok บัญชีที่ถูกต้อง
12. หน้า Video Post ต้องแสดงสถานะเชื่อมต่อสีเขียวและเลือกโปรไฟล์ตรงรุ่น
13. กด Video Post ของคลิป ระบบจะเลือก TikTok Template เพราะ Product URL มีคำว่า tiktok
14. อย่าแตะมือถือจน Log แจ้งสำเร็จ หากหน้าจอต่างจาก Template ให้กดหยุดก่อนแก้ ไม่ควรปล่อยให้กดต่อ
15. หลังระบบปิด TikTok ให้เปิดแอปตรวจโพสต์จริง ตรวจ Caption สินค้า เสียง และการมองเห็น

13. อ่านสถานะงานและผลกระทบของปุ่ม

สถานะ Gen Clip

สถานะ Workflow

ปุ่มที่ต้องอ่านก่อนกด

14. คำถามที่พบบ่อย (FAQ)

Q: ปิดหน้าเว็บได้ไหมระหว่าง Workflow?

A: ไม่ควรปิด โดยเฉพาะช่วง WebADB/Auto Post เพราะการเชื่อมมือถือทำงานผ่านหน้าเว็บ ให้เปิดแท็บและคอมไว้จนจบ

Q: ทำไมเพิ่มสินค้าแล้ว Workflow เริ่มเอง?

A: เปิด “เริ่ม Workflow อัตโนมัติเมื่อมีสินค้าใหม่เข้าผ่าน API” อยู่ ปิด Checkbox นี้หากต้องการตรวจสินค้าก่อนรันเอง

Q: Product URL แบบไหนเลือก TikTok?

A: URL ที่มีคำว่า tiktok จะใช้ TikTok Template นอกนั้นระบบเลือก Shopee Template จึงต้องตรวจ URL ก่อนโพส

Q: ระบบหา TikTok Product ID อย่างไร?

A: อ่านจาก query product_id/productId หรือหมายเลขใน path เช่น /pdp/1734781797208720653 แล้วใช้กับ source: "productId"

Q: ส่ง short URL จากมือถือทาง LINE ได้ไหม?

A: ได้ ส่ง https://vt.tiktok.com/... เป็นข้อความล้วน ระบบจะไล่ Redirect ตัด query หา Product ID และแปลงเป็น Shop URL อัตโนมัติ

Q: ทำไม LINE ไม่ตอบ?

A: ตรวจว่าแชตส่วนตัวกับ @108yycfx ส่ง Serial ถูกต้อง และส่ง URL แบบข้อความล้วน จากนั้นลองใหม่หนึ่งครั้ง หากยังไม่ตอบให้แจ้งผู้ดูแลพร้อมเวลาที่ส่ง

Q: TikTok ติด Security Check ยังเพิ่มสินค้าผ่าน LINE ได้ไหม?

A: ได้เมื่อ short URL มีข้อมูลแชร์ ระบบจะใช้ชื่อและรูปแชร์เป็น fallback แต่ข้อมูลอาจมีรูปเดียวและไม่มีรายละเอียด

Q: ต้องใส่เครื่องหมาย ? และข้อความหลัง URL รูปไหม?

A: ไม่ต้อง ระบบตัดตั้งแต่ ? ออก และรวมรูปต้นฉบับเดียวกันที่ต่างเพียงขนาด

Q: คลิปใน Video Post เล่นเองไหม?

A: ไม่เล่นเอง ให้กดเปิดดูเมื่อต้องการ รายการแบ่งหน้าละ 10 คลิป

Q: กด Enter ใน ADB อย่างไร?

A: ใช้ {"type":"key","code":66}

Q: เลื่อนจอขึ้นหนึ่งครั้งอย่างไร?

A: ใช้ swipe จากด้านล่างขึ้นด้านบน เช่น {"type":"swipe","x1":540,"y1":1800,"x2":540,"y2":700,"duration":300} แล้วปรับพิกัดให้ตรงหน้าจอจริง

Q: หน้า TikTok เปลี่ยนรูปแบบ ทำอย่างไร?

A: เพิ่ม if ตรวจข้อความที่ต่างกัน แล้วใส่ขั้นตอนของแต่ละหน้าใน THEN/ELSE จากนั้น Test ก่อนใช้งานจริง

Q: Gen เสร็จแต่ไม่โพสอัตโนมัติ?

A: เปิด Workflow อ่านบรรทัดเงื่อนไข Auto Post ตรวจ Checkbox, Caption, Product URL, คลิปรวม, สถานะโพส, มือถือ และ Template ทีละข้อ

Q: API Key ใช้ร่วมกันไหม?

A: ใช้ร่วมกันภายใน Serial เดียวกัน เพราะทุกเครื่องที่กรอก Serial เดียวกันชี้ไป Workspace เดียวกัน

15. แก้ปัญหาแบบตัดสินใจทีละขั้น