คู่มือเชื่อมเว็บและ LINE OA เข้ากล่อง Lead

เลือกตามสิ่งที่กิจการมี (มีทั้งคู่ก็เชื่อมได้ทั้งคู่ — แยกเป็นคนละช่องทางกัน):

• มีเว็บไซต์ WordPress (มีฟอร์มติดต่อ หรือระบบสั่งซื้อ) → ไปที่ เชื่อมเว็บ WordPress
• มี LINE Official Account (LINE OA) ของร้าน → ไปที่ เชื่อม LINE OA

1. เข้าเมนู ช่องทางขาย → ตั้งค่าช่องทาง
2. กดปุ่ม + เชื่อมช่องทางใหม่
3. กรอกข้อมูลในหน้าต่าง "เชื่อมช่องทางใหม่":
   • ชนิดช่องทาง — เลือก เว็บ WordPress
   • ชื่อช่องทาง — ตั้งให้รู้เรื่อง เช่น เว็บหลัก jshop.com
   • สาขาเริ่มต้น (ไม่บังคับ) — สาขาที่จะรับผิดชอบ lead จากเว็บนี้ (เปลี่ยนทีหลังได้ ที่ สาขาที่รับรายการ)
4. กด สร้างช่องทาง

ถ้าสำเร็จ จะมีหน้าต่างเด้งขึ้นมาแสดง รหัสช่องทาง (public id) และ กุญแจลายเซ็น (secret) — อ่านหัวข้อถัดไปก่อนปิดหน้าต่างนี้

• ค่านี้แสดง ครั้งเดียวเท่านั้น — ปิดหน้าต่างแล้วจะเปิดดูย้อนหลังไม่ได้อีก
• กด คัดลอก แล้วนำไปวางในปลั๊กอินฝั่งเว็บให้เสร็จก่อน แล้วติ๊ก บันทึกค่าไว้เรียบร้อยแล้ว จึงจะกด ปิด ได้
• ⚠️ อย่ารีเฟรชหน้า ปิดแท็บ หรือกดย้อนกลับ ก่อนคัดลอกค่าเสร็จ — ค่าอยู่บนหน้าจอ เท่านั้น ไม่ได้ถูกเก็บไว้ให้เปิดดูซ้ำ ถ้าหน้าถูกโหลดใหม่ค่าจะหายทันทีโดยไม่มีคำเตือน (ปุ่ม ปิด กันได้เฉพาะการกดปิด) · หายแล้วต้อง ออก secret ใหม่ อย่างเดียว
• ห้ามส่งค่านี้ทางแชท/อีเมลที่ไม่ปลอดภัย — ถ้าจำเป็นต้องส่งให้ทีมเว็บ ใช้ช่องทางที่ลบข้อความได้และลบทันทีหลังใช้งาน
• ถ้าค่าหาย ไม่ต้องตกใจ — ไปที่การ์ดช่องทางแล้วกด ออก secret ใหม่ (ดู ออก secret ใหม่ / ปลดตัวเก่า) ตัวเก่าจะยังใช้ได้ช่วงเปลี่ยนผ่าน จนกว่าจะกด ปลด

1. ที่การ์ดช่องทางในจอ ตั้งค่าช่องทาง จะเห็นช่อง "URL สำหรับตั้งค่าฝั่งเว็บ (webhook)" — กด คัดลอก
2. บนเว็บ WordPress: ติดตั้งปลั๊กอิน GORINY Lead Connector (ยังไม่มีไฟล์? โหลดได้จากในระบบ — ดู ดาวน์โหลดไฟล์ปลั๊กอิน) แล้วไปที่ Settings → GORINY Lead
3. วาง Webhook URL และ Secret ที่คัดลอกมา → กด บันทึก
   • ปลั๊กอินจะตรวจค่าให้: ถ้า URL ผิดรูปจะขึ้นกล่องแดงและไม่ทับค่าเดิม · ถ้าหน้าตา URL ไม่เหมือนค่าที่คัดลอกจากระบบจะขึ้นกล่องเหลืองเตือน
4. กด ส่งทดสอบ ในหน้าเดียวกัน — ใส่เบอร์โทรของคุณเอง
   • ⚠️ รายการทดสอบจะถูกส่งเข้าระบบจริง — ถ้าเบอร์ยังไม่เคยมี จะเกิดรายการใหม่ ในกล่อง Lead (ตั้งสถานะเป็น "ทิ้ง" ทีหลังได้) · ถ้าเบอร์ซ้ำกับรายการเดิม ระบบจะรวมเข้ารายการนั้น ไม่สร้างใบใหม่

ถ้าสำเร็จ: ฝั่งปลั๊กอินขึ้นกล่องเขียว "เชื่อมต่อสำเร็จ — ระบบ GORINY รับข้อมูลแล้ว…" และรายการโผล่ในจอ กล่อง Lead ขาเข้า ของ GORINY (ชื่อ "ทดสอบระบบ (จากหน้าตั้งค่า)" ถ้าเป็นเบอร์ใหม่ · หรือรวมอยู่ในรายการเดิมถ้าเบอร์ซ้ำ) · ถ้ากดส่งทดสอบซ้ำด้วยข้อมูลชุดเดิม จะขึ้นว่า "เชื่อมต่อสำเร็จ — ข้อมูลชุดนี้เคยส่ง เข้าระบบแล้ว (ไม่นับซ้ำ)" ซึ่งแปลว่าเชื่อมต่อได้ปกติ ระบบแค่ไม่บันทึกซ้ำ ถ้าขึ้นกล่องแดง/เหลือง ดู แก้ปัญหาที่พบบ่อย

รายละเอียดฝั่งเว็บที่เหลือ — ตั้ง cron ของเซิร์ฟเวอร์ (จำเป็น) · ตั้งฟอร์ม Contact Form 7 ให้เบอร์เป็นช่องบังคับ · เชื่อม WooCommerce — ทำตาม README-install-TH.md ที่มากับปลั๊กอิน (อย่าข้ามเรื่อง cron ไม่งั้นรายการที่ ส่งไม่สำเร็จจะไม่ถูกลองใหม่อัตโนมัติ)

• ดาวน์โหลดไฟล์ปลั๊กอิน (.zip) ได้จากในระบบ: เมนู ช่องทางขาย → ตั้งค่าช่องทาง → การ์ดช่องทางชนิด เว็บ WordPress → ปุ่ม ดาวน์โหลดปลั๊กอิน (.zip) (ในไฟล์มีคู่มือติดตั้ง README-install-TH.md ให้ด้วย)
• ⚠️ ปุ่มนี้อยู่บนการ์ดของช่องทาง — ถ้ายังไม่เคยสร้างช่องทางชนิดเว็บ WordPress จอตั้งค่าจะยังว่าง (ขึ้นว่า "ยังไม่มีช่องทางที่เชื่อมไว้" พร้อมลิงก์ วิธีเชื่อมช่องทางแรก) และจะยังไม่เห็นปุ่มดาวน์โหลด → สร้างช่องทางก่อน แล้วปุ่มจะโผล่บนการ์ดนั้น
• เลขรุ่นล่าสุดแสดงอยู่ข้างปุ่มดาวน์โหลดเสมอ — ไฟล์ที่ได้เป็นรุ่นเดียวกับเลขที่เห็น · ชื่อไฟล์ที่ดาวน์โหลดมาจะเป็น goriny-lead-connector-<เลขรุ่น>.zip (เลขรุ่นตามที่แสดงข้างปุ่ม)
• วิธีเช็คเวอร์ชันที่ติดตั้งอยู่บนเว็บ: ใน WordPress ไปที่ Settings → GORINY Lead — หัวหน้าจอแสดงชื่อปลั๊กอินพร้อมเลขรุ่น (ขึ้นเป็น v ตามด้วยเลขรุ่น) · หรือดูที่หน้า Plugins ของ WordPress ก็ได้
• ถ้ารุ่นบนเว็บเก่ากว่าเลขข้างปุ่มดาวน์โหลด แนะนำให้โหลดไฟล์ใหม่แล้วอัปโหลดทับ (การตั้งค่าเดิมไม่หาย)
• ℹ️ มีปลั๊กอินตัวที่สองชื่อ GORINY Mint Ref สำหรับทำปุ่มทักไลน์บนเว็บ พร้อมรหัสอ้างอิง — เป็นคนละตัวกับปลั๊กอินรับฟอร์ม/ออร์เดอร์ในหัวข้อนี้ ดาวน์โหลดและวิธีติดตั้งอยู่ที่ หัวข้อ 3.6

1. เปิด LINE Developers Console → เลือก channel ของร้าน → แท็บ Basic settings → คัดลอกค่า Channel secret ไว้ (★ ไม่ใช่ "Channel access token")
2. ในระบบ GORINY เข้าเมนู ช่องทางขาย → ตั้งค่าช่องทาง → กด + เชื่อมช่องทางใหม่
3. กรอก:
   • ชนิดช่องทาง — เลือก LINE OA
   • ชื่อช่องทาง — เช่น LINE ร้านหลัก
   • Channel secret จาก LINE — วางค่าที่คัดลอกมาจากข้อ 1
   • สาขาเริ่มต้น (ไม่บังคับ) — เปลี่ยนทีหลังได้
4. กด สร้างช่องทาง

ถ้าสำเร็จ: การ์ดช่องทางใหม่จะขึ้นในจอตั้งค่าทันที — ช่องทาง LINE ไม่มีหน้าต่างเด้ง (ต่างจากช่องทางเว็บ) เพราะไม่มี secret ให้จดเพิ่ม คุณเป็นคนถือต้นฉบับอยู่แล้วใน LINE Console · รหัสช่องทาง (public id) ดูได้จากท้าย Webhook URL บนการ์ดนั้น (หัวข้อถัดไป)

1. ที่การ์ดช่องทาง LINE ในจอ ตั้งค่าช่องทาง จะเห็นช่อง "Webhook URL (วางใน LINE Developers Console)" — กด คัดลอก
2. ใน LINE Developers Console → channel ของร้าน → แท็บ Messaging API → ช่อง Webhook URL → วางค่า → กด Update
3. เปิดสวิตช์ Use webhook
4. กดปุ่ม Verify ได้เลย — ระบบตอบรับให้อัตโนมัติ (LINE ยิงทดสอบมาแบบ ไม่มีข้อความเพื่อเช็คการเชื่อมต่อ)

ถ้าสำเร็จ: Verify ขึ้น Success และเมื่อมีคนทักแชท OA ด้วยข้อความ รายการจะโผล่ใน จอ กล่อง Lead ขาเข้า (lead จาก LINE มักขึ้น "ไม่ระบุชื่อ" — เป็นเรื่องปกติ ดู กล่อง Lead ขาเข้า)

1. จอ ตั้งค่าช่องทาง → การ์ดช่องทาง LINE → กด วาง Channel secret จาก LINE
2. วางค่าใหม่จาก LINE Console (Basic settings → Channel secret) → กด บันทึก
3. ค่าเดิมจะยังใช้ได้ต่ออีกระยะเพื่อไม่ให้ข้อความที่ค้างท่อหาย — เมื่อทุกอย่าง เข้าปกติแล้ว กลับมา ปลด ตัวเก่าในตารางกุญแจลายเซ็น (แถวที่เก่ากว่า — ดูวันที่ในคอลัมน์ "สร้างเมื่อ")

1. เข้าเมนู ช่องทางขาย → โค้ดแคมเปญ & QR
   • ถ้ายังไม่เคยสร้างช่องทาง LINE OA เลย จอนี้จะขึ้นแถบสีเหลือง "ยังไม่มีช่องทาง LINE ในกิจการ" พร้อมลิงก์ ไปเพิ่มที่หน้าตั้งค่าช่องทาง — ต้องสร้างช่องทาง LINE ก่อน เพราะ QR ทุกใบต้องพาไปที่ LINE OA
2. ที่การ์ด LINE OA id (ปลายทางของ QR) กด ตั้งค่า แล้วกรอก LINE OA id ของร้าน (ขึ้นต้นด้วย @ เช่น @477nfnbd — ดูได้ใน LINE Developers Console → Basic settings) → กด บันทึก

ถ้าสำเร็จ: ขึ้น "บันทึก LINE OA id แล้ว" และปุ่ม QR / ลิงก์ ในตารางโค้ด กดได้ตามปกติ · แก้ค่าทีหลังได้ด้วยปุ่ม แก้ไข บนการ์ดเดียวกัน

สร้างโค้ดต่อจุดติดตั้ง:

1. เข้าเมนู ช่องทางขาย → โค้ดแคมเปญ & QR → กด + สร้างโค้ดใหม่
2. กรอก สาขาของจุดติดตั้ง · จุดติดตั้ง (เช่น ป้ายหน้าประตู) · รหัสอ้างอิง (เช่น lp-front-door — กติกาตัวอักษรที่ใช้ได้แสดงอยู่ใต้ช่องกรอกในจอ · ⚠️ พิมพ์ลงป้ายแล้วแก้ย้อนหลังไม่ได้ ตั้งให้ดีตั้งแต่แรก) · ช่องทาง/UTM ใส่หรือไม่ก็ได้
3. กด สร้างโค้ด → ที่แถวโค้ดกด QR / ลิงก์ → ดาวน์โหลด PNG (หรือ SVG) ไปทำป้าย

ลูกค้าสแกน QR แล้วจะเปิดแชท LINE ของร้านพร้อมข้อความรอในช่องพิมพ์ — เมื่อลูกค้า กดส่ง ระบบจะจดให้ว่า lead คนนี้มาจากโค้ดไหน (ดูได้ในคอลัมน์ "ที่มา" ของกล่อง Lead)

เลิกใช้ป้ายไหนแล้ว กด ปิดใช้งาน ที่แถวโค้ดนั้น — การปิดแค่หยุดรับโค้ดนี้เพิ่ม ไม่ลบประวัติที่มาของ lead เก่า รายงานย้อนหลังไม่เปลี่ยน

สิ่งที่ต้องมีก่อน: ช่องทางเว็บ WordPress (หัวข้อ 2.1) · ช่องทาง LINE OA ที่เชื่อมแล้ว (หัวข้อ 3.1) และ ตั้ง LINE OA id แล้ว

ดาวน์โหลดปลั๊กอิน: ดาวน์โหลด goriny-mint-ref (.zip) (ต้องเข้าระบบอยู่)

ขั้นตอนโดยย่อ (ฉบับเต็มอยู่ในไฟล์ README-install-TH.md ข้างในไฟล์ zip — รวมตารางแก้ปัญหาและวิธีดู error_log):

1. อัปโหลดไฟล์ zip เข้า WordPress → เปิดใช้งาน (จะไม่มีเมนูตั้งค่าใหม่ — เป็นเรื่องปกติ)
2. เพิ่มค่า 3 ตัวใน wp-config.php — ทั้งหมดอ่าน/แปลงได้จาก Webhook URL และ secret ของช่องทางเว็บ บนการ์ดในจอตั้งค่าช่องทาง (วิธีแปลงอยู่ใน README ข้อ 2)
3. ทำปุ่มบนหน้าเว็บให้มี class="goriny-line-cta" + attribute ตามตารางใน README ข้อ 3 — ไม่ต้องแปะ JavaScript เอง ปลั๊กอินฉีดให้อัตโนมัติ
4. ทดสอบ: เปิดหน้าเว็บด้วย ?utm_source=test แล้วกดปุ่ม → ต้องเข้า LINE พร้อม [ref:...] ในช่องพิมพ์ → กดส่ง → รายการโผล่ในกล่อง Lead ขาเข้า พร้อมคอลัมน์ "ที่มา"

ℹ️ ถ้าออกรหัสไม่ได้ (ตั้งค่าผิด/ระบบไม่ว่าง) ปุ่มยังพาลูกค้าเข้า LINE ได้เสมอ แค่ไม่มีรหัสอ้างอิงติดไป — เป็นการออกแบบโดยตั้งใจ ไม่ใช่ความผิดพลาด

1. ที่การ์ดช่องทาง หัวข้อ "สาขาที่รับรายการจากช่องทางนี้" เลือกสาขาจากรายการ (เลือก — ไม่ระบุ — ได้ถ้าไม่อยากผูกสาขา)
2. กด บันทึก ที่โผล่ขึ้นข้างช่องเลือก

ถ้าสำเร็จ: ขึ้นข้อความ "บันทึกสาขาแล้ว — มีผลกับรายการใหม่ตั้งแต่ตอนนี้"

⚠️ การเปลี่ยนสาขามีผลกับลูกค้า/ข้อความที่เข้ามาหลังจากนี้เท่านั้น — รายการที่เคยเข้ามาแล้วยังอยู่สาขาเดิม ไม่ถูกย้ายตาม

1. ที่การ์ดช่องทาง หัวข้อ "เพดานข้อความต่อนาที" แก้ตัวเลข (ช่วงที่รับได้แสดงอยู่ที่ช่องกรอกในจอ · ช่องทางที่สร้างใหม่เริ่มต้นให้อัตโนมัติ)
2. กด บันทึก ที่โผล่ขึ้นข้างช่อง — ถ้าสำเร็จขึ้น "บันทึกเพดานแล้ว"

ยิงเกินเพดาน ระบบจะปฏิเสธข้อความนั้นด้วยรหัส 429 (ฝั่งเว็บ ปลั๊กอินจะเข้าคิวลองใหม่ให้เอง) — ความหมายของรหัสอื่น ๆ ดู ความหมายของรหัส error

⚠️ สำหรับช่องทาง LINE: ระบบนับเป็นจำนวนข้อความต่อนาที และถ้าชนเพดาน ติดต่อกันนาน ๆ LINE จะเลิกส่งซ้ำและข้อความนั้นหายถาวร — ตั้งให้สูงพอไว้ก่อนดีกว่า (จอมีคำเตือนนี้กำกับอยู่แล้ว)

• กดปุ่ม พักช่องทาง มุมขวาบนของการ์ด → ป้ายสถานะเปลี่ยนเป็น พักไว้
• ระหว่างพัก รายการที่ยิงเข้ามา ไม่หายไปไหน — ระบบเก็บไว้ในจอ Quarantine พร้อมเหตุผล "ช่องทางถูกพัก (paused)" (ทั้งฝั่งเว็บและฝั่ง LINE ใช้กฎเดียวกัน) แต่ไม่นับเป็น lead
• ⚠️ รายการที่เข้า Quarantine ไปแล้ว กู้กลับเป็น lead เองไม่ได้ — จอนั้นดูได้อย่างเดียว การกดเปิดช่องทางกลับ ไม่ได้ดึงของเก่าเข้ามาให้ มีผลกับรายการที่เข้ามาหลังจากนั้นเท่านั้น ถ้าเป็นรายการสำคัญ ให้ดูข้อมูลในจอ Quarantine แล้วติดต่อกลับ/กรอกเข้าระบบเอง
• กด เปิดใช้งาน ปุ่มเดิมเพื่อกลับมารับตามปกติ — รายการใหม่จะเข้ากล่อง Lead เหมือนเดิม

ช่องทาง เว็บ WordPress:

1. ที่การ์ดช่องทาง หัวข้อ "กุญแจลายเซ็น (secret)" กด ออก secret ใหม่
2. ระบบสุ่มค่าใหม่และแสดงครั้งเดียว — ทำตาม กุญแจลายเซ็น (secret) แสดงครั้งเดียว แล้วเอาไปวางใน ปลั๊กอินฝั่งเว็บ (Settings → GORINY Lead → ช่อง Secret → บันทึก)
   • ช่อง Secret ในปลั๊กอินจะว่างเสมอทุกครั้งที่เปิดหน้า (ไม่โชว์ค่าเดิมด้วยเหตุผล ด้านความปลอดภัย) — เว้นว่างไว้ = ใช้ค่าเดิมต่อ · กรอกเมื่อจะเปลี่ยนเท่านั้น
3. ตัวเก่ายังใช้ได้ช่วงเปลี่ยนผ่าน — เมื่อฝั่งเว็บวางค่าใหม่แล้ว กลับมากด ปลด ที่แถวตัวเก่าในตาราง (ถ้าสำเร็จขึ้น "ปลด secret แล้ว")

ช่องทาง LINE OA: ไม่มีปุ่มออกใหม่ — ต้องไปออกที่ LINE Console แล้วเอามาวาง ตาม วาง Channel secret ใหม่

หมายเหตุ: ระบบไม่ยอมให้ ปลด ตัวสุดท้ายที่เหลืออยู่ (ช่องทางจะรับข้อความไม่ได้ทันที) — ถ้าเหลือตัวเดียวปุ่มปลดจะไม่ขึ้น และถึงจะเรียกคำสั่งตรง ๆ ระบบหลังบ้านก็ปฏิเสธให้อีกชั้น

1. ที่หัวการ์ดช่องทาง กด แก้ชื่อ ข้างชื่อ → พิมพ์ชื่อใหม่ → กด บันทึก (หรือ ยกเลิก ถ้าเปลี่ยนใจ)

ถ้าสำเร็จ: ขึ้น "บันทึกชื่อช่องทางแล้ว" — การแก้ชื่อเป็นแค่ป้ายเรียก ไม่กระทบ Webhook URL, secret, สาขา, เพดาน หรือประวัติ lead ใด ๆ

เปลี่ยนสถานะได้จากช่องเลือกในคอลัมน์ "สถานะ" ของแถวนั้น (ยกเว้น "แปลงแล้ว" ซึ่งเป็นสถานะปลายทาง แก้ไม่ได้)

1. กดปุ่ม แปลงเป็นลูกค้า ท้ายแถว
2. หน้าต่างที่เปิดมามี 3 ทางให้เลือกเอง (แท็บด้านบน) — ระบบไม่ผูกให้อัตโนมัติ:
   • เบอร์ตรงกัน (n) — ลูกค้าเดิมที่เบอร์ตรงกับ lead นี้ (ถ้าไม่มีเลย แท็บนี้กดไม่ได้)
   • ค้นหาลูกค้าเดิม — ค้นด้วยชื่อ/เบอร์เอง (ใช้กรณี lead ไม่มีเบอร์ เช่นมาจาก LINE)
   • สร้างลูกค้าใหม่ — สร้างจากข้อมูล lead ที่มี
3. จะเปิด ดีล พร้อมกันเลยก็ได้ (ติ๊กตัวเลือกในหน้าต่างเดียวกัน ตั้งชื่อดีล และมูลค่าคาดหวัง)
4. กดยืนยัน — ถ้าสำเร็จ สถานะ lead เปลี่ยนเป็น แปลงแล้ว และปุ่มท้ายแถว เปลี่ยนเป็น ดูลูกค้า

การแปลงผูกได้กับลูกค้า 1 ราย และย้อนกลับไม่ได้ — ถ้าเบอร์เดียวมีลูกค้าหลายราย (เช่น เบอร์ออฟฟิศ) ระบบจะให้เลือกเองเสมอ ไม่ผูกให้อัตโนมัติ

ไล่ตามลำดับ:

1. จอ ตั้งค่าช่องทาง — ป้ายสถานะช่องทางเป็น เปิดใช้งาน อยู่ไหม (ถ้า พักไว้ ให้กด เปิดใช้งาน — ดู พักช่องทาง)
2. เช็กจอ Quarantine — ถ้ารายการไปโผล่ที่นั่น แปลว่าข้อมูลส่งมาไม่ครบ (ดู Quarantine)
3. ฝั่งเว็บ: เปิดหน้า Settings → GORINY Lead ดูกล่องเตือนสีแดงและตารางประวัติ — แล้วเทียบรหัสกับตารางด้านล่าง · เบอร์โทรต้องเป็นช่องบังคับในฟอร์ม (รายการที่ไม่มีเบอร์จะถูกข้าม ไม่ส่ง)
4. ฝั่ง LINE: เข้า LINE Developers Console เช็คว่า Use webhook ยังเปิดอยู่ และ Webhook URL ตรงกับค่าในจอตั้งค่าช่องทาง (ดู ตั้ง Webhook ฝั่ง LINE)

ปลั๊กอินรุ่นปัจจุบันแสดงผลการทดสอบเป็นกล่องสีพร้อมคำอธิบายภาษาไทย (ถ้าของคุณไม่แสดงแบบนี้ แปลว่ารุ่นเก่า — ดู ดาวน์โหลดไฟล์ปลั๊กอิน) — ตารางนี้ช่วยตอนต้องแจ้งทีมเว็บหรือทีม GORINY:

จอตั้งค่าทุกจอ (สร้างช่องทาง · secret · สาขา · เพดาน · โค้ด) เปิดให้เฉพาะบัญชี เจ้าของกิจการ — ถ้าเห็นข้อความ "คุณดูข้อมูลช่องทางได้ แต่การตั้งค่า… ต้องเป็นเจ้าของกิจการ" ให้ล็อกอินด้วยบัญชีเจ้าของ หรือให้เจ้าของเป็นคนตั้งค่า