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

เปิดเมนู ช่องทางขาย แล้วเลือก ตั้งค่าช่องทาง ครั้งแรกจอจะว่าง มีปุ่ม เชื่อมช่องทางใหม่ มุมขวาบน

เลือกตามสิ่งที่ร้านมี ถ้ามีทั้งสองอย่างก็เชื่อมได้ทั้งสองอย่าง โดยสร้างแยกเป็นคนละช่องทาง

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

1. เปิดเมนู ช่องทางขาย แล้วเลือก ตั้งค่าช่องทาง
2. กดปุ่ม เชื่อมช่องทางใหม่ มุมขวาบน
3. ในหน้าต่างที่เปิดขึ้น กรอก 3 ช่อง:
   • ชนิดช่องทาง เลือก เว็บ WordPress
   • ชื่อช่องทาง ตั้งให้จำง่าย เช่น เว็บหลักของร้าน
   • สาขาเริ่มต้น ไม่บังคับ เลือกสาขาที่จะดูแลลูกค้าจากเว็บนี้ เปลี่ยนทีหลังได้
4. กดปุ่ม สร้างช่องทาง

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

กุญแจลายเซ็นคือรหัสลับที่ปลั๊กอินใช้ยืนยันว่าข้อมูลส่งมาจากเว็บของร้านจริง เพื่อความปลอดภัย ระบบจะแสดงค่านี้ให้เห็น ครั้งเดียวเท่านั้น

1. กดปุ่ม คัดลอก ข้างช่อง กุญแจลายเซ็น (secret)
2. วางค่าในปลั๊กอินบนเว็บให้เสร็จ (หัวข้อ 2.3) หรือจดไว้ในที่ปลอดภัยก่อน
3. ติ๊ก บันทึกค่าไว้เรียบร้อยแล้ว ปุ่ม ปิด จึงจะกดได้

ข้อควรระวัง:

• อย่ารีเฟรชหน้า ปิดแท็บ หรือกดย้อนกลับ ก่อนคัดลอกเสร็จ ค่าจะหายทันทีและเปิดดูซ้ำไม่ได้
• อย่าส่งค่านี้ทางแชทหรืออีเมลที่คนอื่นเห็นได้ ถ้าจำเป็นต้องส่งให้ทีมทำเว็บ ให้ลบข้อความทิ้งหลังใช้งาน
• ถ้าค่าหาย ไม่ต้องกังวล กด ออก secret ใหม่ ที่การ์ดช่องทางได้เลย (หัวข้อ 4.4)

หลังปิดหน้าต่างกุญแจ จอตั้งค่าช่องทางจะมีการ์ดของเว็บนี้ ด้านบนสุดคือช่อง URL สำหรับตั้งค่าฝั่งเว็บ (webhook)

1. กดปุ่ม คัดลอก ข้างช่อง URL
2. เข้าหลังบ้าน WordPress ไปที่เมนู Settings แล้วเลือก GORINY Lead
3. วาง URL ในช่อง Webhook URL และวางกุญแจลายเซ็นในช่อง Secret แล้วกด บันทึก
4. กดปุ่ม ส่งทดสอบ ในหน้าเดียวกัน ใส่เบอร์โทรของคุณเอง

ถ้าเชื่อมสำเร็จ ปลั๊กอินจะขึ้นกล่องสีเขียว "เชื่อมต่อสำเร็จ ระบบ GORINY รับข้อมูลแล้ว" และจะมีรายการชื่อ "ทดสอบระบบ (จากหน้าตั้งค่า)" เข้ามาในกล่อง Lead ภายในไม่กี่วินาที

ข้อควรรู้:

• รายการทดสอบเข้าระบบจริง ถ้าไม่อยากเก็บไว้ ให้เปลี่ยนสถานะเป็น ทิ้ง ทีหลัง
• ถ้าเบอร์ทดสอบซ้ำกับรายการเดิม ระบบจะรวมเข้ารายการนั้นแทนการสร้างใหม่
• กดส่งทดสอบซ้ำด้วยข้อมูลเดิม จะขึ้นว่า "ข้อมูลชุดนี้เคยส่งเข้าระบบแล้ว (ไม่นับซ้ำ)" แปลว่าเชื่อมต่อได้ปกติ
• ถ้าขึ้นกล่องแดงหรือเหลือง ดูความหมายที่ รหัส error จากปุ่มส่งทดสอบ
• ปลั๊กอินช่วยตรวจค่าให้ ถ้า URL ผิดรูปจะขึ้นกล่องแดงและไม่บันทึกทับค่าเดิม
• บรรทัดเล็ก "ส่ง POST + header" ใต้ URL เป็นข้อมูลสำหรับนักพัฒนา ร้านที่ใช้ปลั๊กอินข้ามได้เลย

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

1. สร้างช่องทางเว็บก่อน (หัวข้อ 2.1) ปุ่มดาวน์โหลดอยู่บนการ์ดของช่องทางนั้น
2. ที่การ์ดช่องทางเว็บ กดปุ่ม ดาวน์โหลดปลั๊กอิน (.zip) ข้าง ๆ มีเลขรุ่นล่าสุดบอกไว้
3. ในหลังบ้าน WordPress ไปที่ Plugins กด Add New แล้ว Upload Plugin เลือกไฟล์ .zip ที่ได้ แล้วกดเปิดใช้งาน

ข้อควรรู้:

• ไฟล์ที่ได้ชื่อ goriny-lead-connector-<เลขรุ่น>.zip ข้างในมีคู่มือติดตั้ง README-install-TH.md ให้ด้วย
• ดูรุ่นที่ติดตั้งบนเว็บได้ที่ WordPress เมนู Settings หน้า GORINY Lead หัวหน้าจอบอกเลขรุ่นไว้ หรือดูที่หน้า Plugins
• ถ้ารุ่นบนเว็บเก่ากว่าเลขข้างปุ่มดาวน์โหลด ให้โหลดไฟล์ใหม่แล้วอัปโหลดทับ การตั้งค่าเดิมไม่หาย
• ยังมีปลั๊กอินอีกตัวชื่อ GORINY Mint Ref สำหรับทำปุ่มทักไลน์บนเว็บ เป็นคนละตัวกับปลั๊กอินนี้ ดู หัวข้อ 3.6

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

การ์ดช่องทาง LINE จะขึ้นในจอทันที ช่องทาง LINE ไม่มีหน้าต่างกุญแจเด้งขึ้นมา เพราะร้านถือค่าต้นฉบับอยู่แล้วใน LINE Developers Console ขั้นต่อไปคือตั้ง Webhook ฝั่ง LINE

ที่การ์ดช่องทาง LINE ด้านบนสุดคือช่อง Webhook URL (วางใน LINE Developers Console)

1. กดปุ่ม คัดลอก ข้างช่อง Webhook URL
2. ใน LINE Developers Console เลือก channel ของร้าน ไปที่แท็บ Messaging API
3. ที่ช่อง Webhook URL วางค่าที่คัดลอกมา แล้วกด Update
4. เปิดสวิตช์ Use webhook
5. กดปุ่ม Verify ควรขึ้นว่า Success

ลองให้ใครสักคนทักแชท LINE ของร้าน รายการจะเข้ามาในกล่อง Lead lead จาก LINE มักขึ้นว่า ไม่ระบุชื่อ เป็นเรื่องปกติ เพราะ LINE ไม่ส่งชื่อมาให้ ติดต่อกลับทางแชทได้ตามปกติ

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

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

บันทึกแล้วจะขึ้น "บันทึก LINE OA id แล้ว" แก้ทีหลังได้ด้วยปุ่ม แก้ไข ในแถวเดียวกัน

ลูกค้าสแกน QR แล้ว LINE ของร้านจะเปิดพร้อมข้อความรอในช่องพิมพ์ พอลูกค้ากดส่ง ระบบจะจดให้ว่าคนนี้มาจากป้ายไหน

1. เปิดเมนู ช่องทางขาย เลือก โค้ด & QR แล้วกด สร้างโค้ดใหม่
2. กรอก:
   • สาขาของจุดติดตั้ง
   • จุดติดตั้ง เช่น ป้ายหน้าร้าน
   • รหัสอ้างอิง เช่น front-sign ใช้ตัวอังกฤษพิมพ์เล็ก ตัวเลข และขีด พิมพ์ลงป้ายแล้วแก้ย้อนหลังไม่ได้ ตั้งให้ดีตั้งแต่แรก
   • ช่องทางและ UTM ใส่หรือไม่ก็ได้
3. กดปุ่ม สร้างโค้ด

1. ที่แถวของโค้ดในตาราง กดปุ่ม QR / ลิงก์

1. กด ดาวน์โหลด PNG (หรือ SVG ถ้าจะส่งโรงพิมพ์) แล้วนำไปทำป้าย

ในกล่อง Lead คอลัมน์ ที่มา จะบอกชื่อจุดติดตั้ง เช่น ป้ายหน้าร้าน เลิกใช้ป้ายไหนแล้ว กด ปิดใช้งาน ที่แถวนั้น ประวัติที่มาของลูกค้าเก่ายังอยู่ครบ รายงานย้อนหลังไม่เปลี่ยน

หลักการเหมือนโค้ดแคมเปญและ QR ต่างกันที่จุดที่ลูกค้ากดคือปุ่มบนเว็บ แทนป้ายหน้าร้าน ลูกค้ากดปุ่มแล้ว LINE จะเปิดพร้อมข้อความที่มีรหัสอ้างอิง [ref:...] รอในช่องพิมพ์

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

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

ขั้นตอนโดยย่อ ส่งให้ทีมทำเว็บทำตามคู่มือ README-install-TH.md ที่อยู่ในไฟล์ zip:

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

ถ้าออกรหัสอ้างอิงไม่ได้ในบางครั้ง ปุ่มยังพาลูกค้าเข้า LINE ได้ตามปกติ แค่ไม่มีรหัสติดไป ลูกค้าไม่เสียโอกาสทักร้าน

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

บันทึกแล้วจะขึ้น "บันทึกสาขาแล้ว" การเปลี่ยนสาขามีผลกับรายการที่เข้ามาหลังจากนี้เท่านั้น รายการเก่ายังอยู่สาขาเดิม

1. ที่การ์ดช่องทาง หัวข้อ เพดานข้อความต่อนาที แก้ตัวเลข (ช่องทางใหม่ตั้งไว้ให้ 300)
2. กดปุ่ม บันทึก ที่ขึ้นข้างช่อง

ข้อความที่เกินเพดานจะถูกปฏิเสธด้วยรหัส 429 ฝั่งเว็บไม่ต้องกังวล ปลั๊กอินเก็บเข้าคิวแล้วส่งใหม่ให้เอง

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

• กดปุ่ม พักช่องทาง มุมขวาบนของการ์ด ป้ายสถานะจะเปลี่ยนเป็น พักไว้
• ระหว่างพัก รายการที่ส่งมาไม่หายไปไหน ระบบเก็บไว้ในจอ Quarantine พร้อมเหตุผล "ช่องทางถูกพัก (paused)" แต่ไม่นับเป็น lead
• กดปุ่ม เปิดใช้งาน ปุ่มเดิม เพื่อกลับมารับตามปกติ

ข้อควรรู้: รายการที่เข้า Quarantine ระหว่างพัก จะไม่ถูกดึงกลับเป็น lead เองเมื่อเปิดช่องทาง ถ้าเป็นลูกค้าสำคัญ ให้ดูชื่อและเบอร์ในจอ Quarantine แล้วติดต่อกลับ

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

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

ช่องทาง LINE OA: ไม่มีปุ่มออกกุญแจใหม่ใน GORINY ให้ออกใหม่ใน LINE Developers Console แล้วนำมาวางตามหัวข้อ 3.3

ระบบไม่ให้ปลดกุญแจตัวสุดท้ายที่เหลืออยู่ เพราะช่องทางจะรับข้อความไม่ได้ทันที ถ้าเหลือตัวเดียวจะไม่มีปุ่มปลด

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

การเปลี่ยนชื่อเป็นแค่ป้ายเรียก ไม่กระทบ URL กุญแจ สาขา เพดาน หรือประวัติลูกค้าใด ๆ

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

1. ที่แถวของผู้สนใจ กดปุ่ม สามจุด ท้ายแถว (ชื่อปุ่ม ดำเนินการ) แล้วเลือก แปลงเป็นลูกค้า

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

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

ไล่ตรวจตามลำดับนี้:

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

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

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