📘 คู่มือใช้งานเครื่องใหม่

สารบัญ

1. สิ่งที่ต้องเตรียม
2. เข้าใช้งานครั้งแรก
3. ทำความเข้าใจ Serial และ Workspace
4. ตั้ง API Key และเสียง/Subtitle
5. เตรียมหมวดสินค้า Prompt และรูปนางแบบ
6. เพิ่มและตรวจข้อมูลสินค้า
7. เตรียมและเชื่อมต่อมือถือ
8. ตั้ง ADB Template Shopee/TikTok
9. ใช้งาน Full Workflow
10. ตรวจเงื่อนไข Auto Post
11. โพสด้วยตนเองจาก Video Post
12. ลำดับใช้งานประจำวัน
13. แก้ปัญหาอย่างละเอียด

1. สิ่งที่ต้องเตรียม

2. เข้าใช้งานครั้งแรก

3. Serial No และ Workspace ทำงานอย่างไร

• Serial No ใช้ยืนยันว่าได้รับอนุญาตผ่าน Whitelist และกำหนดสิทธิ์ว่าเป็นผู้ใช้ทั่วไปหรือจัดการ Whitelist ได้
• Serial No เป็นตัวกำหนด Workspace โดยตรง
• กรอก Serial เดียวกันในหลายเครื่องหรือมือถือ ทุกเครื่องจะเห็นสินค้า งาน และ API Key ชุดเดียวกัน
• การเปลี่ยน Serial จะพาไปยัง Workspace ของ Serial ใหม่

4. ตั้ง API Key, เสียงพากย์ และ Subtitle

4.1 เปิดหน้าตั้งค่า

1. ไปที่ Master Data → ตั้งค่า KIE AI
2. กรอกค่าตามหัวข้อด้านล่าง
3. เมื่อเสร็จทุกส่วน ให้กด 💾 บันทึกการตั้งค่า เพียงครั้งเดียว
4. กลับเข้าหน้านี้อีกครั้งเพื่อตรวจว่าค่าถูกบันทึกใน Workspace เครื่องนี้

4.2 BigModel

• กรอก BigModel API Key
• ตรวจชื่อโมเดล เช่น glm-5v-turbo
• Prompt บทพากย์จะได้รับข้อมูลสินค้าและข้อความขายจากสินค้าโดยอัตโนมัติ
• Prompt Caption ควรระบุสไตล์ภาษา ความยาว และจำนวน Hashtag ที่ต้องการ

4.3 KIE AI

• กรอก KIE API Key และตรวจ Base URL
• ตรวจโมเดลภาพ สัดส่วน และชนิดไฟล์ เช่น PNG/JPEG
• ตรวจโมเดลวิดีโอ สัดส่วน ความละเอียด และความยาวคลิป
• งานแนวตั้งสำหรับ Shopee/TikTok โดยทั่วไปควรเลือกสัดส่วน 9:16 หากโมเดลรองรับ

4.4 เลือกเสียงพากย์

4.5 ตั้ง Subtitle

• เลือกว่าต้องการ Subtitle หรือไม่
• กำหนดสี ความกว้างบรรทัด และตำแหน่งจากขอบบน
• Path ฟอนต์ไทยเว้นว่างได้เพื่อให้ระบบค้นหาอัตโนมัติ หากภาษาไทยเป็นสี่เหลี่ยมให้ระบุ Path และชื่อฟอนต์เอง
• ต้องเปิดอย่างน้อยหนึ่งอย่างระหว่าง เสียงพากย์ หรือ Subtitle

5. เตรียมหมวดสินค้า Prompt Template และรูปนางแบบ

5.1 สร้างหมวดสินค้า

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

5.2 สร้าง Prompt Template

1. เพิ่ม Template สำหรับ รูปภาพ อย่างน้อย 1 รายการในหมวด
2. เพิ่ม Template สำหรับ วิดีโอ อย่างน้อย 1 รายการในหมวด
3. Prompt ภาพควรระบุฉาก แสง มุมกล้อง การจัดวางสินค้า และข้อห้ามไม่ให้สินค้าเพี้ยน
4. Prompt วิดีโอควรระบุการเคลื่อนกล้อง การเคลื่อนไหวสินค้า ระยะเวลา และห้ามเพิ่มข้อความ/โลโก้ที่ไม่ต้องการ
5. ทดสอบกับสินค้า 1 ชิ้นก่อนรันทั้งหมวด เพื่อประหยัดเครดิต

5.3 รูปนางแบบ

• เพิ่มรูปนางแบบใน Master Data เมื่อสินค้าต้องมีคนถือ ใส่ หรือสาธิต
• ใช้ภาพคมชัด แสงสม่ำเสมอ เห็นบุคคลตามช่วงตัวที่ต้องการ
• หน้า Gen Clip สามารถเลือก ใส่นางแบบในภาพ ก่อนสั่ง Gen

6. เพิ่มและตรวจข้อมูลสินค้า

6.1 ข้อมูลที่ต้องมี

6.2 Product URL และแพลตฟอร์ม

• URL ที่มีคำว่า tiktok จะใช้ TikTok ADB Template
• URL อื่นจะใช้ Shopee ADB Template
• ระบบจะตัดเครื่องหมาย ? และ Query String ด้านหลัง URL ที่ไม่จำเป็นออก
• TikTok Product ID จะถูกดึงจาก URL เพื่อใช้กับคำสั่ง source: "productId"

6.3 ตรวจรูปสินค้า

• เลือกรูปที่เห็นตัวสินค้าชัด ไม่มีป้ายโปรโมชันหรือตารางไซซ์บังสินค้า
• หาก URL รูปซ้ำกันแต่ต่างขนาด ระบบจะเก็บเวอร์ชันใหญ่สุด
• หน้าแก้ไขสินค้าจะแสดงรูปเพื่อให้ตรวจและลบรูปที่ไม่ต้องการได้
• Full Workflow จะคัดรูปด้วย AI ตามจำนวนสูงสุดที่ตั้งไว้

7. เตรียมและเชื่อมต่อมือถือ

7.1 เตรียม Android

1. เปิด Settings → About phone → Software information
2. แตะ Build number 7 ครั้ง จนขึ้นว่าเปิดโหมดนักพัฒนาแล้ว
3. กลับไป Settings → Developer options แล้วเปิด USB debugging
4. ติดตั้ง Shopee/TikTok และล็อกอินบัญชีที่จะโพสให้เรียบร้อย
5. เปิดแอปด้วยตนเองหนึ่งครั้งเพื่อยอมรับ Permission, Popup และข้อกำหนดที่ค้างอยู่
6. หาก Template ต้องพิมพ์ภาษาไทย ให้ติดตั้งและเปิดใช้ ADBKeyboard

7.2 เชื่อมมือถือกับ ShopSpark

1. ปิด Android Studio, scrcpy, Emulator หรือโปรแกรมอื่นที่กำลังใช้ ADB
2. เสียบสาย USB ที่รองรับข้อมูล และเลือกโหมด USB เป็น File transfer หากโทรศัพท์ถาม
3. เปิดหน้า Workflow แล้วกด 🔌 อนุญาต/เชื่อมต่อครั้งแรก
4. ในหน้าต่างของ Chrome/Edge เลือกชื่อมือถือแล้วกด Connect
5. บนมือถือกด Allow USB debugging และเลือก “Always allow from this computer” หากเป็นเครื่องที่ไว้ใจ
6. รอจนหน้า Workflow แสดงจุดสีเขียวและชื่อ/รุ่นมือถือ

7.3 ตรวจความพร้อม

• หน้าจอมือถือปลดล็อกและเปิดอยู่
• แบตเตอรี่เพียงพอหรือเสียบชาร์จผ่านสาย
• อินเทอร์เน็ตมือถือทำงาน
• ไม่มี Popup ระบบหรือ Popup แอปค้างบังปุ่ม
• ระหว่าง Automation ห้ามแตะหน้าจอหรือสลับแอป

8. ตั้ง ADB Template สำหรับ Shopee และ TikTok

วิธีใช้เมนู ADB Builder

1. เปิดเมนู 🧩 ADB Builder แล้วเลือก Shopee/TikTok และโปรไฟล์มือถือ
2. ลากคำสั่งจากแถบซ้ายลง Canvas หรือคลิกคำสั่งเพื่อเพิ่มท้ายกลุ่มที่เลือก
3. ลากการ์ดเพื่อเรียงใหม่ ใช้ปุ่มลูกศร ทำสำเนา หรือลบได้จากการ์ด
4. คลิกการ์ด แล้วแก้ชื่อ พิกัด ข้อความ Package, wait และค่าอื่นใน Inspector ด้านขวา
5. คำสั่ง IF มีพื้นที่ THEN และ ELSE ให้ลากคำสั่งเข้าแต่ละสาขาได้ และรองรับ IF ซ้อนกัน
6. ตรวจ JSON Preview แล้วกด บันทึก Template ที่เลือก
7. หากไม่ต้องการกระทบโปรไฟล์เดิม ให้กด บันทึกเป็นโปรไฟล์ใหม่
8. กด ทดสอบบนมือถือ หลังเชื่อม WebADB แล้ว

8.1 เลือกแพลตฟอร์มและโปรไฟล์

1. ไปที่ Master Data → ADB Automation Templates
2. เลือกแพลตฟอร์ม Shopee หรือ TikTok
3. เชื่อมมือถือ แล้วกด Sync ขนาดจอจากมือถือ
4. สร้างโปรไฟล์ตามรุ่นมือถือ หรือเลือกโปรไฟล์ที่ตรงรุ่น
5. ตั้ง Default Profile เมื่อมีหลายโปรไฟล์และต้องการค่าเริ่มต้น

8.2 คำสั่ง JSON ที่รองรับ

8.3 ค่า source สำหรับคำสั่ง text

• caption — Caption ของสินค้า
• productUrl — Product URL เต็ม
• productId — ตัวเลข Product ID ที่แยกจาก TikTok URL

8.4 วิธีตั้งพิกัดให้ตรงเครื่อง

1. เปิด Developer options → Pointer location
2. แตะปุ่มเป้าหมายบนมือถือและอ่านค่า X/Y ด้านบนหน้าจอ
3. แก้ค่า x, y หรือพิกัด Swipe ใน JSON
4. ใส่ wait หลังขั้นที่โหลดช้า เช่น เปิดแอป อัปโหลดคลิป หรือเปิดหน้าสินค้า
5. หน้าจอที่อาจมีสองรูปแบบให้ใช้ if หรือ tap_text แทนพิกัดตายตัวเมื่อทำได้

8.5 ทดสอบอย่างปลอดภัย

1. ตรวจ JSON ว่าเปิด/ปิดวงเล็บครบ แล้วกด บันทึก ADB Templates
2. เชื่อมมือถือและเตรียมหน้าจอให้พร้อม
3. กด ทดสอบ Template หาก Template ใช้ Product URL ระบบจะถาม URL สำหรับทดสอบ
4. เฝ้าดูทุกขั้นและกดหยุดทันทีหากพิกัดผิด
5. โหมดทดสอบจะไม่บังคับปิดแอป หลังทดสอบให้แก้พิกัด/เวลารอแล้วทดสอบซ้ำ

9. ใช้งาน Full Workflow

9.1 เปิดหน้า Workflow

1. เปิดเมนู ⚡ Workflow
2. ตรวจสถานะมือถือให้เป็นสีเขียว
3. ตรวจ Checkbox Video Post อัตโนมัติหลังรวมเสียงพากย์กับวิดีโอเสร็จ ค่าเริ่มต้นจะถูกเลือกไว้
4. หากต้องการให้สินค้าใหม่จาก API เริ่มเอง ให้เปิด เริ่ม Workflow อัตโนมัติเมื่อมีสินค้าใหม่เข้าผ่าน API

9.2 รันทดสอบทีละสินค้า

1. ที่ช่อง เริ่มเฉพาะสินค้า เลือกสินค้าที่ตรวจข้อมูลครบแล้ว
2. กด รันเฉพาะสินค้านี้
3. ติดตาม Progress Bar และ Log ของสินค้านั้นจนจบ
4. กด ดูผลแต่ละขั้น เพื่อตรวจรูป บทพากย์ เสียง วิดีโอ วิดีโอรวม และ Caption

9.3 รันทั้งหมวด

1. ทดสอบสินค้าในหมวดสำเร็จอย่างน้อย 1 ชิ้นก่อน
2. เลือกหมวดที่ช่อง เริ่ม workflow ทั้งหมวด
3. กด เริ่มทั้งหมวด (เฉพาะที่ยังไม่เริ่ม)
4. ระบบสร้างทีละสินค้าแบบคิว FIFO สินค้ารายการใหม่จะรอต่อท้าย เมื่อรายการหนึ่งมีวิดีโอรวมเสร็จพร้อมโพส ระบบจะพักไว้ในคิว Video Post แล้วเริ่มสร้างสินค้าถัดไปได้ทันทีโดยไม่ต้องเสียบมือถือ
5. เมื่อเสียบมือถือและเชื่อม WebADB ระบบจะนำรายการพร้อมโพสที่สะสมไว้มาโพสเรียงทีละรายการอัตโนมัติ
6. ใช้ปุ่ม หยุด Workflow ทั้งหมดชั่วคราว เมื่อต้องการพักโดยไม่ลบคิว

9.4 ลำดับขั้นอัตโนมัติ

คัดรูป → สร้างภาพ → บท/เสียง/Caption → สร้างวิดีโอ → รวมเสียง/Subtitle → Auto Post

• หากขั้นใดผิดพลาด กด เริ่มใหม่ที่ขั้นที่ค้าง เพื่อไม่เสียเครดิตทำขั้นก่อนหน้าซ้ำ
• กด เริ่มใหม่ทั้งหมด เมื่อต้องการเริ่ม Workflow ใหม่แต่ยังอนุญาตให้ใช้ผลเดิมที่เหมาะสม
• กด เริ่มใหม่ทั้งหมด (ไม่ใช้ของเก่า) เมื่อต้องการ Gen รูป วิดีโอ บท และ Caption ใหม่จริง ๆ
• Log แต่ละขั้นมีเวลาและปุ่มย้อนเริ่มจากขั้นนั้นสำหรับรายการที่รองรับ

10. อ่านเงื่อนไข Auto Post

ใต้ Progress Bar ของแต่ละสินค้า หน้า Workflow จะแสดงเหตุผลที่ยังโพสไม่ได้โดยตรง ไม่ต้องเดาเอง

ปุ่มล้างคิวโพส

• ลบรายการวิดีโอทุกสถานะที่ยังไม่โพสออกจาก Video Post
• หยุด Workflow ของสินค้าที่รายการวิดีโอถูกลบ
• ปิด Checkbox Auto Post
• ไม่ลบรายการที่โพสแล้ว และไม่ลบข้อมูลสินค้า

11. โพสด้วยตนเองจากหน้า Video Post

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

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

ก่อนเริ่มงาน

1. เปิด ShopSpark ด้วย Chrome/Edge เครื่องเดิมและ Browser Profile เดิม
2. เปิดหน้า Workflow ตรวจว่า Workspace และรายการงานถูกต้อง
3. เสียบมือถือ ปลดล็อกจอ เปิดอินเทอร์เน็ต และเชื่อม USB ให้เป็นสีเขียว
4. ตรวจว่าล็อกอิน Shopee/TikTok ถูกบัญชี
5. ตรวจ Checkbox Auto Post
6. ตรวจสินค้าใหม่อย่างน้อยชื่อ รูป หมวด Product URL และข้อความขาย

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

• ดู Active Workflow และลำดับคิว
• ดู Log เมื่อ Progress ไม่ขยับ
• อย่าแตะมือถือระหว่าง Auto Post
• อย่าปิดแท็บ ShopSpark เพราะ WebADB และ Auto Post ทำงานผ่านหน้าเว็บ

หลังจบงาน

• ตรวจสถานะ “โพสสำเร็จแล้ว” และตรวจโพสต์จริงในแอป
• ตรวจ Gallery และ Video Post ว่าไม่มีงานผิดรายการ
• กดปิด Session มือถือก่อนถอดสายหากไม่ต้องการให้เชื่อมใหม่อัตโนมัติ

13. แก้ปัญหาอย่างละเอียด

เข้าเว็บหรือเห็นข้อมูลไม่ถูกต้อง

สร้างภาพ วิดีโอ หรือข้อความไม่สำเร็จ

เชื่อมมือถือไม่ได้

1. ยืนยันว่าใช้ Chrome/Edge และเปิดผ่านหน้าต่างปกติ
2. ปลดล็อกมือถือ เปิด USB Debugging และเลือก File transfer
3. เปลี่ยนสายหรือช่อง USB โดยเฉพาะเมื่อชาร์จได้แต่ไม่พบอุปกรณ์
4. ปิด Android Studio, scrcpy, Emulator และโปรแกรม ADB อื่น
5. หากเคยใช้ ADB บนคอม ให้เปิด Command Prompt แล้วสั่ง adb kill-server
6. ที่ Developer options เลือก Revoke USB debugging authorizations แล้วเชื่อมใหม่
7. กดเชื่อมต่อครั้งแรก เลือกมือถือ และยอมรับข้อความบนหน้าจอมือถือ

Auto Post ไม่ทำงานหรือกดผิดตำแหน่ง

1. อ่านบรรทัด Auto Post ใต้ Progress Bar แล้วแก้ทุกเงื่อนไขที่แสดง
2. ตรวจ Product URL ว่าเลือกแพลตฟอร์มถูก
3. ตรวจว่ามือถืออยู่หน้าเริ่มต้นตามที่ Template คาดไว้ และไม่มี Popup บัง
4. Sync ขนาดจอและเลือกโปรไฟล์ที่ตรงรุ่น
5. เปิด Pointer location ตรวจพิกัดที่ผิด แล้วแก้ JSON
6. เพิ่ม wait หลังหน้าที่โหลดช้า
7. ใช้ tap_text หรือ if สำหรับหน้าจอที่เปลี่ยนรูปแบบ
8. กดทดสอบ Template ทีละรอบจนผ่าน ก่อนเปิดรันทั้งหมวด

พิมพ์ Caption ภาษาไทยไม่ได้

1. ติดตั้ง ADBKeyboard และเปิดให้เป็น Keyboard ที่อนุญาตใน Android Settings
2. ตรวจว่า Caption ในข้อมูลสินค้ามีข้อความ
3. ตรวจ Template ว่ามี {"type":"text","source":"caption"}
4. เพิ่มเวลารอหลังแตะช่อง Caption ก่อนสั่ง text
5. หลังจบ Automation ระบบจะพยายามคืน Keyboard เดิมให้อัตโนมัติ