Integrations · Shopee / TikTok API

เชื่อมต่อ API โดยตรง — ให้ระบบดึงออเดอร์อัตโนมัติแทนการ export manual
สถานะปัจจุบัน: Scaffold + setup guide

การเชื่อม API จริงต้องสมัคร Partner account กับ Shopee / TikTok ก่อน (อนุมัติประมาณ 1-2 สัปดาห์) และต้องเก็บ API keys ในไฟล์ .env.local

ตอนนี้ทำได้: ดูคู่มือ setup ด้านล่าง · สมัคร partner account · ใส่ keys · ระบบจะ enable การ sync ออเดอร์อัตโนมัติทุก 4 ชั่วโมง

ในระหว่างนี้ ใช้ Manual import — โหลด CSV จาก Shopee/TikTok แล้ว upload ทุกสัปดาห์/เดือนก็พอ

Shopee Open Platform

ยังไม่ active
  1. 1สมัคร Shopee Partner account ที่ open.shopee.com — ใช้ business account
  2. 2สร้าง app ใน partner portal → ขอ permission "Order" + "Item"
  3. 3ได้ partner_id + partner_key + auth URL
  4. 4Owner ของ Shopee shop เปิด auth URL → กด Authorize → ระบบจะได้ shop_id + access_token
  5. 5Save 4 ค่าใน .env.local:
    SHOPEE_PARTNER_ID=...
    SHOPEE_PARTNER_KEY=...
    SHOPEE_SHOP_ID=...
    SHOPEE_ACCESS_TOKEN=...
  6. 6Restart app — Sync จะ active ทุก 4 ชั่วโมง

Endpoint scaffold พร้อมแล้ว

  • app/_actions/shopee.ts — getOrderList signed request
  • app/api/cron/shopee-sync/route.ts — endpoint สำหรับ scheduled trigger
  • scripts/shopee-sync.ts — manual sync command

TikTok Shop Open API

ยังไม่ active
  1. 1สมัคร TikTok Shop Partner ที่ partner.tiktokshop.com
  2. 2สร้าง app → ขอ scope "order.read" + "product.read"
  3. 3ได้ app_key + app_secret + auth URL
  4. 4Authorize ผ่าน owner account → ได้ shop_id + access_token (อายุ 7 วัน — จะ refresh อัตโนมัติ)
  5. 5Save 4 ค่าใน .env.local:
    TIKTOK_APP_KEY=...
    TIKTOK_APP_SECRET=...
    TIKTOK_SHOP_ID=...
    TIKTOK_ACCESS_TOKEN=...
  6. 6Restart app

หลังต่อ API แล้วจะทำอะไรได้บ้าง

Auto-import orders

ทุก 4 ชั่วโมง ระบบจะดึงออเดอร์ใหม่จาก Shopee/TikTok เข้า Glamhagan สร้างเป็น sales rows อัตโนมัติ

Stock sync ป้องกัน oversell

เมื่อขายที่ ASAP/ZOS ระบบจะ update Shopee+TikTok ให้ลด stock ตาม → ป้องกันขายเกิน

Real-time alert

เมื่อมีออเดอร์ใหม่ → Line notify (ต้อง Line developer token เพิ่ม)

🔒 API keys ทั้งหมดเก็บใน .env.local ที่อยู่ในเครื่อง Jiggy เท่านั้น — ไม่ส่งออกที่ไหน