การเชื่อมต่อแพลตฟอร์ม
ปรับปรุงล่าสุด: 20 ตุลาคม 2569 · ผู้ให้บริการ: ห้างหุ้นส่วนจำกัด เอแอล เนสซี่ ช็อป (AL Nessy Shop Limited Partnership) เลขทะเบียนนิติบุคคล 0603568001009 · 54/1 หมู่ที่ 7 ตำบลบางม่วง อำเภอเมืองนครสวรรค์ จังหวัดนครสวรรค์ 60000 · ติดต่อ: support@sellhubth.com
หน้านี้อธิบายอย่างโปร่งใสว่า SellHub เชื่อมต่อกับแต่ละแพลตฟอร์มอย่างไร เข้าถึงข้อมูลอะไร ขอสิทธิ์ใดบ้างและเพราะเหตุใด และร้านยกเลิกได้อย่างไร เพื่อให้ร้านตัดสินใจก่อนกดอนุญาต และเพื่อประกอบการตรวจสอบแอปของแพลตฟอร์ม
| ช่องทาง | สถานะ |
|---|---|
| Facebook Messenger (Meta) | ช่องทางหลัก — อยู่ระหว่างพัฒนา · เปิดให้ร้านทั่วไปเมื่อ Meta อนุมัติ App Review |
| LINE Official Account | ช่องทางหลัก — อยู่ระหว่างพัฒนา · เริ่มกับร้านนำร่องที่ได้รับเชิญ |
| Shopee / Lazada / TikTok Shop — ซิงค์ออเดอร์ สินค้า สต๊อก | ระยะถัดไป (หลังเปิดบริการ) · เปิดเมื่อแพลตฟอร์มอนุมัติแอป |
| Shopee / Lazada / TikTok Shop — ตอบแชทผู้ซื้อ | ระยะถัดไป · ต้องได้รับสิทธิ์แชทแยกจากแอปซิงค์ — ยังไม่เปิดใช้ |
หลักการร่วมทุกแพลตฟอร์ม
- เชื่อมผ่านหน้าอนุญาตอย่างเป็นทางการของแพลตฟอร์มเท่านั้น (หรือ Channel ID/secret ที่ร้านวางเองสำหรับ LINE) — เราไม่ขอรหัสผ่านบัญชีใด ๆ
- ขอเฉพาะสิทธิ์ที่จำเป็นต่อฟีเจอร์ที่ใช้ ไม่ขอสิทธิ์โฆษณา การเงินของแพลตฟอร์ม หรือการโพสต์ในนามร้าน
- token/secret เก็บแบบเข้ารหัส (AES-256-GCM) ไม่แสดงใน log และถูกลบทันทีเมื่อร้านยกเลิกการเชื่อมต่อ หรือเมื่อแพลตฟอร์มแจ้งการเพิกถอน
- ทุก webhook ตรวจลายเซ็น (HMAC) กับข้อมูลดิบก่อนประมวลผล ตอบรับทันทีและประมวลผลเบื้องหลัง
- ข้อความขาออกทุกข้อความผ่านคิวที่บันทึกสถานะ ไม่ส่งซ้ำเองเมื่อไม่แน่ใจว่าถึงหรือไม่ (แอดมินกดส่งซ้ำได้)
- ผู้ช่วย AI แจ้งลูกค้าว่าเป็นผู้ช่วย AI ที่ต้นทุกการสนทนา — ค่าเริ่มต้นเปิด ร้านเลือกปิดคำนำหน้าได้ แต่ AI ไม่อ้างว่าเป็นมนุษย์ และเมื่อถูกถามจะตอบว่าเป็นผู้ช่วย AI ของร้านเสมอ (ดู ข้อกำหนดการใช้งาน ข้อ 3)
- ข้อมูลจากแพลตฟอร์มใช้เพื่อให้บริการแก่ร้านเจ้าของข้อมูลนั้นเท่านั้น ไม่ใช้ข้ามร้าน ไม่ขาย ไม่ใช้ทำการตลาดของ SellHub (นโยบายความเป็นส่วนตัว)
Facebook Messenger (Meta)
| แอป | “SellHub” (ประเภท Business) ของ ห้างหุ้นส่วนจำกัด เอแอล เนสซี่ ช็อป |
|---|---|
| วิธีเชื่อม | Facebook Login for Business → ร้านเลือกเพจที่จะเชื่อม → ระบบรับ page access token และสมัครรับ webhook ของเพจนั้น |
| OAuth redirect | https://app.sellhubth.com/api/oauth/meta/callback |
| Webhook | https://app.sellhubth.com/api/hooks/meta |
| Data deletion callback | https://app.sellhubth.com/api/hooks/meta/data-deletion |
| คำแนะนำการลบข้อมูล | https://sellhubth.com/data-deletion |
สิทธิ์ที่ขอและเหตุผล
| สิทธิ์ / ฟีเจอร์ | ใช้ทำอะไร |
|---|---|
pages_show_list | แสดงรายชื่อเพจที่ผู้ใช้ดูแล ให้เลือกเพจที่จะเชื่อมกับ SellHub และรับ page access token ของเพจที่เลือก |
pages_messaging | รับข้อความที่ลูกค้าส่งถึงเพจ และส่งคำตอบ — ทั้งคำตอบของผู้ช่วย AI (ภายใน 24 ชั่วโมงหลังข้อความล่าสุดของลูกค้า) และข้อความที่แอดมินพิมพ์ใน inbox ของ SellHub |
pages_manage_metadata | สมัคร/ตรวจ/ยกเลิกการรับ webhook ของเพจ (/{page-id}/subscribed_apps) ตอนเชื่อม ตรวจสุขภาพการเชื่อมต่อ และถอนเมื่อร้านยกเลิก |
pages_read_engagement | อ่านข้อมูลพื้นฐานของเพจ (ชื่อ รูปโปรไฟล์) เพื่อแสดงว่าเชื่อมเพจใดอยู่ — ระยะนี้ไม่อ่านโพสต์ คอมเมนต์ หรือ insights |
business_management | เข้าถึงเพจที่อยู่ภายใต้ Business Portfolio ของร้านผ่าน Facebook Login for Business — ไม่สร้าง/แก้ไขการตั้งค่าธุรกิจ บัญชีโฆษณา หรือสิทธิ์ของบุคคลอื่น |
Human Agent | ให้แอดมินที่เป็นคนตอบลูกค้าได้หลังพ้น 24 ชั่วโมง (ไม่เกิน 7 วัน) ด้วย tag HUMAN_AGENT — ข้อความของ AI ไม่ใช้ tag นี้เด็ดขาด |
Business Asset User Profile Access | ดึงชื่อและรูปโปรไฟล์ของลูกค้าที่ทักเพจ (จาก PSID) เพื่อแสดงใน inbox ให้แอดมินรู้ว่าคุยกับใคร |
สิทธิ์จัดการคอมเมนต์ (ตอบคอมเมนต์/ส่งข้อความหลังคอมเมนต์) ยังไม่ขอในระยะนี้ — จะเพิ่มในหน้านี้ก่อนเปิดใช้
Webhook ที่สมัครรับ
| Field | ใช้ทำอะไร |
|---|---|
messages | ข้อความ/รูป/ไฟล์ที่ลูกค้าส่ง |
messaging_postbacks | ปุ่มที่ลูกค้ากด (เช่น ยืนยันสรุปออเดอร์) |
message_echoes | ข้อความที่เพจส่งออก — ใช้แยกว่าแอดมินตอบเองจาก Meta Business Suite เพื่อให้ AI หยุดตอบชั่วคราว |
message_reads | สถานะอ่านแล้ว แสดงใน inbox |
messaging_referrals | ลิงก์ m.me ที่มีรหัสอ้างอิงสินค้า เพื่อให้ AI รู้ว่าลูกค้าสนใจสินค้าใด |
standby | ตรวจว่ามีแอปอื่นคุมบทสนทนาของเพจอยู่ (Conversation routing) เพื่อเตือนร้าน |
ข้อมูลที่เข้าถึง
- เพจ: page id ชื่อ รูปโปรไฟล์ และ page access token (เข้ารหัส)
- ลูกค้าที่ทักเพจ: PSID ชื่อและรูปโปรไฟล์ ข้อความ รูป ไฟล์แนบ ปุ่มที่กด รหัสอ้างอิงจากลิงก์
- ไฟล์แนบถูกดาวน์โหลดเก็บในที่เก็บของ SellHub ทันที (URL ของ Meta หมดอายุ)
สิ่งที่เราไม่ทำ
- ไม่ส่งข้อความอัตโนมัติหลังพ้น 24 ชั่วโมง ไม่ส่ง broadcast/ข้อความโฆษณา ไม่ใช้ message tag กับข้อความของ AI
- ไม่โพสต์ ไม่แก้ไขเพจ ไม่เข้าถึงโฆษณาหรือ insights
ยกเลิกการเชื่อมต่อ
- ใน SellHub: เมนู ช่องทาง → Facebook → ยกเลิกการเชื่อมต่อ — ระบบถอนการสมัคร webhook ของเพจและลบ token ทันที
- จากฝั่ง Facebook: การตั้งค่าและความเป็นส่วนตัว → การตั้งค่า → การผสานการทำงานทางธุรกิจ (Business Integrations) → SellHub → ลบ — token จะใช้ไม่ได้ทันที (ชื่อเมนูอาจต่างกันตามเวอร์ชันของ Facebook)
- ขอลบข้อมูลที่เกี่ยวกับแอปผ่าน Facebook ได้ ระบบรับคำขอผ่าน data deletion callback ด้านบน
LINE Official Account
| วิธีเชื่อม | ร้านเปิด Messaging API ใน LINE Official Account Manager แล้ววาง Channel ID + Channel secret ใน SellHub และวาง Webhook URL ที่ SellHub สร้างให้ใน LINE Developers |
|---|---|
| Webhook | https://app.sellhubth.com/api/hooks/line/{webhook_key} (แยกต่อร้าน — key เป็นความลับ ไม่เผยแพร่) |
| token | SellHub ออก channel access token ชั่วคราว (อายุประมาณ 15 นาที) จาก Channel ID + secret เมื่อจำเป็น ไม่เขียน token ลงฐานข้อมูล |
ข้อมูลที่เข้าถึง
- LINE userId ของผู้ที่ทัก OA ชื่อที่แสดงและรูปโปรไฟล์ (เฉพาะผู้ที่เป็นเพื่อนกับ OA)
- ข้อความ รูป สติกเกอร์ ไฟล์ที่ลูกค้าส่ง (ดาวน์โหลดเก็บทันที) และ postback จากปุ่ม
- โควตาข้อความคงเหลือของ OA (เพื่อตัดสินว่าจะส่งข้อความแบบ push ได้หรือไม่)
การส่งข้อความ
- AI ตอบด้วย reply message (ไม่นับโควตาข้อความของร้าน) · ใช้ push message เฉพาะกรณีจำเป็น (เช่น ตอบไม่ทันเวลาของ reply token) และเมื่อ OA ยังมีโควตาเท่านั้น — ค่าข้อความ push เป็นไปตามแพ็กเกจ LINE OA ของร้าน
- ไม่ตอบข้อความในกลุ่มหรือห้องแชทรวม (group/room)
- แอดมินที่ตอบใน LINE Official Account Manager โดยตรง ระบบจะไม่เห็น (LINE ไม่ส่งข้อความนั้นกลับมา) จึงควรตอบผ่าน inbox ของ SellHub หรือปิด AI รายแชท
- ร้านต้องปิด “ข้อความตอบกลับอัตโนมัติ” และ “ข้อความทักทาย” ของ OA เพื่อไม่ให้ตอบซ้อน — ยกเว้นร้านที่ปิดคำนำหน้าแจ้งว่าเป็น AI: แนะนำให้เปิด “ข้อความทักทาย” (ส่งตอนลูกค้าเพิ่มเพื่อน) ที่มีคำแจ้งว่าร้านใช้ผู้ช่วย AI
ยกเลิกการเชื่อมต่อ
- ใน SellHub: เมนู ช่องทาง → LINE → ยกเลิกการเชื่อมต่อ — ลบ Channel secret ทันที
- จากฝั่ง LINE: LINE Developers → channel ของ OA → Messaging API → ปิด Use webhook หรือเปลี่ยน Webhook URL และ/หรือ Basic settings → ออก Channel secret ใหม่ (secret เดิมที่ SellHub มีจะใช้ไม่ได้) — ชื่อเมนูอาจต่างกันตามเวอร์ชันของ LINE
Shopee, Lazada และ TikTok Shop (ระยะถัดไป)
ซิงค์ออเดอร์ สินค้า และสต๊อกระหว่างร้านบน marketplace กับระบบหลังร้านของ SellHub (แอปประเภท ERP/Connector) จะเปิดหลังเปิดบริการ รายละเอียดด้านล่างคือสิ่งที่แอปซิงค์จะขอและใช้
Shopee
| คอนโซลนักพัฒนา | Shopee Open Platform |
|---|---|
| Redirect URL (Authorization) | https://app.sellhubth.com/api/oauth/shopee/callback |
| Push mechanism callback URL | https://hooks.sellhubth.com/shopee |
| Scope / API group | ใช้ทำอะไร |
|---|---|
| App type: ERP System — Shop module (v2.shop.get_shop_info, v2.auth.token/get, access_token/get) | ระบุร้านที่เชื่อมต่อ ขอและต่ออายุโทเค็น |
| Product module (v2.product.get_item_list, get_item_base_info, update_stock) | ดึงรายการสินค้าเพื่อจับคู่ SKU และอัปเดตสต๊อกกลับ |
| Order module (v2.order.get_order_list, get_order_detail) | ดึงออเดอร์และรายละเอียดผู้รับเพื่อสร้างใบสั่งขาย/ใบส่งของ |
| Logistics module (v2.logistics.*) — เมื่อเปิดใช้ฟีเจอร์จัดส่ง | ดึงเลขพัสดุ/สถานะจัดส่ง และพิมพ์ใบปะหน้า |
ข้อมูลที่เข้าถึง: ข้อมูลร้าน: shop_id, ชื่อร้าน, ภูมิภาค, สถานะและวันหมดอายุการอนุญาต · สินค้า: item_id, SKU, ชื่อ, ราคา, รูป, จำนวนคงเหลือ · ออเดอร์: order_sn, สถานะ, รายการสินค้า, ยอดเงิน, ข้อมูลผู้รับ (ชื่อ เบอร์ ที่อยู่) เพื่อการจัดส่ง — เก็บไม่เกิน 90 วันตาม Shopee Data Protection Policy
Webhook ที่รับ: Push code 3: order_status_push · Push code 1: shop_authorization_push (แจ้งเมื่อร้านยกเลิกการอนุญาต → ลบโทเค็นทันที) · Push code 4: tracking_no_push (เมื่อเปิดใช้ฟีเจอร์จัดส่ง)
ยกเลิกการอนุญาตจากฝั่ง Shopee: Shopee Seller Centre → บัญชี (Account) → พาร์ทเนอร์แพลตฟอร์ม (Platform Partner) → SellHub → ยกเลิกการเชื่อมต่อ (Separate / Deactivate) — คู่มือ Shopee: https://seller.shopee.co.th/edu/article/5884 — ชื่อเมนูอาจต่างกันตามเวอร์ชันของ Seller Centre
Lazada
| คอนโซลนักพัฒนา | Lazada Open Platform |
|---|---|
| Callback URL | https://app.sellhubth.com/api/oauth/lazada/callback |
| Message Service callback URL | https://hooks.sellhubth.com/lazada |
| Scope / API group | ใช้ทำอะไร |
|---|---|
| Seller API group (GET /seller/get) | ระบุร้านและประเทศของร้านที่เชื่อมต่อ |
| Product API group (GET /products/get, POST /product/price_quantity/update) | ดึงรายการสินค้าเพื่อจับคู่ SKU และอัปเดตสต๊อก/ราคากลับ |
| Order API group (GET /orders/get, GET /orders/items/get) | ดึงออเดอร์และรายการสินค้าในออเดอร์เพื่อสร้างใบสั่งขาย |
| Logistics API group — เมื่อเปิดใช้ฟีเจอร์จัดส่ง | ดึงสถานะจัดส่งและเลขพัสดุ |
ข้อมูลที่เข้าถึง: ข้อมูลร้าน: seller_id, ชื่อร้าน, ประเทศ (country_user_info) · สินค้า: item_id, SKU, ชื่อ, ราคา, รูป, จำนวนคงเหลือ · ออเดอร์: order_id, สถานะ, รายการสินค้า, ยอดเงิน, ข้อมูลผู้รับแบบปิดบัง (masked) ตามค่าเริ่มต้นของ Lazada เพื่อการจัดส่ง — เราไม่ขอสิทธิ์ Unmask
Webhook ที่รับ: Trade order status (Message Service) · Reverse order status · Token expiry alert
ยกเลิกการอนุญาตจากฝั่ง Lazada: Lazada Seller Center → Settings → Third Party App → Connected → Deauthorize (แอปประเภท ERP ที่สมัครผ่าน Service Marketplace: My Service → ยกเลิกการสมัคร) — ชื่อเมนูอาจต่างกันตามเวอร์ชันของ Seller Center
TikTok Shop
| คอนโซลนักพัฒนา | TikTok Shop Partner Center |
|---|---|
| Redirect URL | https://app.sellhubth.com/api/oauth/tiktok/callback |
| Webhook URL | https://hooks.sellhubth.com/tiktok |
| Scope / API group | ใช้ทำอะไร |
|---|---|
| Shop Authorized Information — seller.shop.info (GET /authorization/202309/shops) | ระบุร้าน ภูมิภาค และ shop_cipher ที่ใช้เรียก API |
| Product Basic + Product Modify (inventory) — seller.product.* (POST /product/202309/products/search, /inventory/update) | ดึงรายการสินค้าเพื่อจับคู่ SKU และอัปเดตสต๊อกกลับ |
| Order Information — seller.order.info (POST /order/202309/orders/search) | ดึงออเดอร์และรายละเอียดผู้รับเพื่อสร้างใบสั่งขาย/ใบส่งของ |
| Fulfillment Basic / Logistics Basic — เมื่อเปิดใช้ฟีเจอร์จัดส่ง | ดึงข้อมูลพัสดุ เลขพัสดุ และสถานะจัดส่ง |
ข้อมูลที่เข้าถึง: ข้อมูลร้าน: shop_id, ชื่อร้าน, ภูมิภาค, shop_cipher, granted_scopes · สินค้า: product_id, SKU, ชื่อ, ราคา, รูป, จำนวนคงเหลือ · ออเดอร์: order_id, สถานะ, รายการสินค้า, ยอดเงิน, ข้อมูลผู้รับ (ชื่อ เบอร์ ที่อยู่) เพื่อการจัดส่ง
Webhook ที่รับ: ORDER_STATUS_CHANGE · SELLER_DEAUTHORIZATION (แจ้งเมื่อร้านยกเลิกการอนุญาต → ลบโทเค็นทันที) · UPCOMING_AUTHORIZATION_EXPIRATION (แจ้งล่วงหน้า 30 วันก่อนสิทธิ์หมดอายุ)
ยกเลิกการอนุญาตจากฝั่ง TikTok Shop: TikTok Shop Seller Center → App Store → My apps and incidents → SellHub → Cancel authorization — TikTok Shop จะส่ง webhook SELLER_DEAUTHORIZATION มายัง SellHub เพื่อให้ลบโทเค็นอัตโนมัติ
ข้อมูลผู้ซื้อที่ได้จากออเดอร์ (ชื่อ เบอร์ ที่อยู่) ใช้เพื่อการจัดส่งและเอกสารการขายของร้านนั้นเท่านั้น และถูกปิดบังภายใน 90 วันหลังออเดอร์เสร็จสิ้น (หรือสั้นกว่าตามที่แพลตฟอร์มกำหนด) · token ลบทันทีเมื่อร้านยกเลิก หรือแพลตฟอร์มแจ้งการเพิกถอน · ยกเลิกจากใน SellHub ได้ที่เมนู ช่องทาง เช่นกัน
ตอบแชทผู้ซื้อบน marketplace — ยังไม่เปิดใช้
แอปซิงค์ประเภท ERP ของ Shopee ไม่ได้รับสิทธิ์ Chat API การตอบแชทผู้ซื้อบน marketplace จึงต้องได้รับอนุมัติแยก:
- Shopee: แอปแยกประเภทที่ได้รับ Chat API
- Lazada: สิทธิ์ IM API (whitelist)
- TikTok Shop: scope Customer Service
เมื่อได้รับอนุมัติ หน้านี้จะระบุสิทธิ์ ข้อมูลที่เข้าถึง (เช่น ข้อความและชื่อผู้ใช้ของผู้ซื้อ) และ URL ก่อนเปิดใช้
วิธียกเลิกและลบข้อมูลทั้งหมดอยู่ที่ การขอลบข้อมูล · ข้อมูลแอปสำหรับผู้ตรวจสอบที่ ข้อมูลแอป
English summary
SellHub connects only through each platform's official authorization (Facebook Login for Business; LINE Messaging API channel credentials entered by the shop; marketplace OAuth), never asks for account passwords, requests only the permissions its features need, encrypts tokens and secrets (AES-256-GCM), verifies every webhook signature against the raw body, and deletes tokens as soon as a shop disconnects or the platform reports a revocation. By default the AI assistant tells customers it is an AI assistant at the start of every chat session; shops may turn this automatic notice off, but the assistant never claims to be human and says it is the shop's AI assistant when asked.
Facebook Messenger — app “SellHub” (Business type) of AL Nessy Shop Limited Partnership. OAuth redirect https://app.sellhubth.com/api/oauth/meta/callback; webhook https://app.sellhubth.com/api/hooks/meta; data deletion callback https://app.sellhubth.com/api/hooks/meta/data-deletion. Permissions: pages_show_list (list the merchant's Pages so they pick one and we obtain its Page token), pages_messaging (receive customer messages and reply — AI replies only inside the 24-hour standard messaging window, plus replies typed by the shop's human admins in the SellHub inbox), pages_manage_metadata (subscribe, verify and remove the app's webhook subscription on the Page), pages_read_engagement (read the Page's name and picture to show which Page is connected; no posts, comments or insights in this release), business_management (access Pages owned by the merchant's business portfolio through Facebook Login for Business; we never change business settings, ad accounts or roles), Human Agent (human admins only may reply up to 7 days after the last customer message with the HUMAN_AGENT tag; never used for AI messages) and Business Asset User Profile Access (customer name and profile picture shown in the inbox). Webhook fields: messages, messaging_postbacks, message_echoes (detect replies typed in Meta Business Suite so the AI pauses), message_reads, messaging_referrals, standby. We do not send broadcasts, ads or automated messages outside the 24-hour window, and we do not post on the Page. Shops disconnect in SellHub (Channels → Facebook → Disconnect: webhook subscription removed and token deleted immediately) or from Facebook's Business Integrations settings.
LINE Official Account — the shop enables the Messaging API and enters its Channel ID and secret; SellHub issues short-lived (about 15-minute) channel access tokens when needed and does not store them. Webhook https://app.sellhubth.com/api/hooks/line/{webhook_key} (one secret key per shop). We access the user ID, display name and picture (friends only), messages and attachments. Replies use reply messages (free); push messages are used only when needed and only if the OA still has message quota (billed by LINE to the shop). Group and room chats are ignored. Shops disconnect in SellHub (secret deleted immediately) or by turning off the webhook / reissuing the channel secret in LINE Developers.
Shopee, Lazada, TikTok Shop — store sync (orders, products, stock) is a later phase: OAuth callbacks https://app.sellhubth.com/api/oauth/<platform>/callback and push URLs https://hooks.sellhubth.com/<platform>; scopes are limited to shop info, products/inventory, orders and (when enabled) logistics; buyer data is used only for that shop's fulfilment and masked within 90 days of order completion. Marketplace chat needs separate approvals (a chat-type app on Shopee, IM API whitelist on Lazada, the Customer Service scope on TikTok Shop) and is not enabled; this page will list those permissions before the feature is enabled.