[คำแนะนำทีละขั้นตอน] เข้าสู่ระบบด้วย LINE เพียงคลิกเดียว และผลการทดสอบ OOOPEN Lab จะ “แนบ” ไปยังรายชื่อเพื่อนของคุณโดยอัตโนมัติ!

คุณดูแลบัญชี LINE อย่างเป็นทางการและต้องการโต้ตอบกับสมาชิกผ่านเนื้อหาแบบอินเทอร์แอ็กทีฟ เช่น แบบทดสอบทางจิตวิทยาและแบบทดสอบความถนัดหรือไม่? หลังจากผู้เล่นทำแบบทดสอบเสร็จสิ้น คุณต้องการส่งข้อมูลที่เสร็จสมบูรณ์ (รวมถึงรหัสประจำตัวสมาชิก LINE) กลับไปยังระบบของคุณโดยอัตโนมัติผ่าน Webhook เปรียบเทียบกับข้อมูลเพื่อนในบัญชี LINE อย่างเป็นทางการของคุณ และจัดหมวดหมู่เพื่อการตลาดหรือบริการลูกค้าในภายหลังหรือไม่?

บทความนี้จะอธิบายวิธีการใช้ฟีเจอร์ "Custom OAuth Login" ของ OOOPEN Lab เพื่อเชื่อมต่อกับช่องทางการเข้าสู่ระบบ LINE ของคุณเอง ซึ่งจะช่วยให้ webhook สามารถรับ userId ของ LINE ที่เหมือนกับ friend ID ของบัญชี LINE อย่างเป็นทางการได้โดยตรง ช่วยลดขั้นตอนการเปรียบเทียบและการแปลงข้อมูลในฝั่งเซิร์ฟเวอร์ บทความนี้ถือว่าคุณเข้าใจ แนวคิดพื้นฐานของการเข้าสู่ระบบ OAuth และ วิธีการตั้งค่า webhook แล้ว และจะเน้นเฉพาะส่วนพิเศษของการเชื่อมต่อกับ LINE เท่านั้น

สารบัญ

• ทำไมเราไม่ใช้ฟังก์ชัน "เข้าสู่ระบบสมาชิกชุมชน → LINE" ที่มีอยู่ในแพลตฟอร์มเพื่อทำเช่นนี้ล่ะ?
• ขั้นตอนที่ 1: ตั้งค่าช่องทางใน LINE Developers
• ขั้นตอนที่ 2: กำหนดค่าในโปรแกรมแก้ไข OOOPEN Lab
• ขั้นตอนที่ 3: คุณจะได้รับรหัสผู้ใช้ LINE ประเภทใด?
• ขั้นตอนที่ 4: Webhook รับข้อมูลอะไรบ้าง?
• รายการตรวจสอบการทดสอบแบบครบวงจร
• ปัญหาที่พบได้ทั่วไปและวิธีแก้ไขปัญหา

ทำไมเราไม่ใช้ฟังก์ชัน "เข้าสู่ระบบสมาชิกชุมชน → LINE" ที่มีอยู่ในแพลตฟอร์มเพื่อทำเช่นนี้ล่ะ?

OOOPEN Lab มีวิธีการเข้าสู่ระบบสองวิธีโดยใช้ LINE ในส่วน "การตั้งค่าการเข้าสู่ระบบ/สิทธิ์อนุญาต" และรหัสผู้ใช้ LINE ที่ได้รับจากสองวิธีนี้แตกต่างกันโดยสิ้นเชิง :

หากเป้าหมายของคุณคือการจับคู่ผู้ตอบแบบสอบถามกับเพื่อนในบัญชี LINE อย่างเป็นทางการของคุณ (เช่น เพื่อค้นหาว่า "ผู้ตอบแบบสอบถามคนนี้คือเพื่อนคนนี้" ใน CRM/MA) คุณ ต้อง ใช้วิธีการ "เข้าสู่ระบบ OAuth แบบกำหนดเอง" บทความนี้จะแนะนำคุณตลอดขั้นตอนการตั้งค่าทีละขั้นตอน

โปรดตรวจสอบข้อมูลต่อไปนี้ก่อนเริ่มงานก่อสร้าง:

• บัญชี OOOPEN Lab ของคุณต้องมีสิทธิ์ "การเข้าสู่ระบบ OAuth แบบกำหนดเอง" (ขึ้นอยู่กับแพ็กเกจ หากคุณไม่มีสิทธิ์นี้ ตัวเลือกนี้จะถูกล็อกไว้ในตัวแก้ไข โปรดดู คำแนะนำในแพ็กเกจ )
• คุณมีช่องทางการเข้าสู่ระบบ LINE อยู่แล้ว หรือสามารถสมัครขอช่องทางการเข้าสู่ระบบ LINE ผ่านทางนักพัฒนา LINE ได้ (หมายเหตุ: นี่คือ ช่องทางการเข้าสู่ระบบ LINE ไม่ใช่ช่องทาง API การส่งข้อความ)
• ข้อกำหนดสำคัญ : ช่องทางการเข้าสู่ระบบ LINE นี้ต้อง อยู่บนผู้ให้บริการนักพัฒนา LINE เดียวกัน กับช่องทาง API การส่งข้อความของบัญชี LINE อย่างเป็นทางการของคุณ มิเช่นนั้น รหัสผู้ใช้และรหัสเพื่อนที่ได้รับจะอยู่ในเนมสเปซที่แตกต่างกันและไม่สามารถจับคู่กันได้

ขั้นตอนที่ 1: ตั้งค่าช่องทางใน LINE Developers

1.1 สร้างช่องทางการเข้าสู่ระบบ LINE

ไปที่ LINE Developers Console เลือกผู้ให้บริการ ( โปรดเลือกผู้ให้บริการเดียวกับบัญชี LINE อย่างเป็นทางการของคุณ ) คลิก " สร้างช่องใหม่ " และเลือก "LINE Login " หากคุณมีช่อง LINE Login อยู่แล้วที่สามารถนำมาใช้ซ้ำได้ โปรดตรวจสอบให้แน่ใจว่าช่องนี้และช่อง Messaging API ของบัญชีอย่างเป็นทางการของคุณอยู่ภายใต้ผู้ให้บริการเดียวกัน

1.2 การรับรหัสช่อง (Channel ID) และรหัสลับช่อง (Channel Secret)

ค้นหาได้ใน การตั้งค่าพื้นฐาน ของช่อง :

• รหัสช่อง (ข้อมูลสาธารณะ)
• รหัสลับของช่อง (โปรดเก็บเป็นความลับ)

ค่าทั้งสองนี้จะถูกนำไปใช้ในโปรแกรมแก้ไข OOOPEN Lab ในภายหลัง

1.3 ลงทะเบียน URL การเรียกกลับ

เพิ่ม URL การเรียกกลับ (Callback URL) สำหรับแบบทดสอบนี้ลงใน LINE Login → Callback URL เพิ่ม URL นี้สำหรับแบบทดสอบแต่ละรายการแยกกัน รูปแบบคือ:

https://ooopenlab.cc/auth/{quizId}/callback

{quizId} คือรหัสของแบบทดสอบ (ส่วนใน URL ของตัวแก้ไข /editor/{quizId}/... ) เพื่อความปลอดภัยยิ่งขึ้น : เปิด "การตั้งค่าการเข้าสู่ระบบ/สิทธิ์" ของตัวแก้ไขแบบทดสอบ และคำอธิบายในช่อง "URL การเข้าสู่ระบบ OAuth" จะแสดง redirect_uri ที่แบบทดสอบนี้ใช้จริง เพียงคัดลอกและวางลงใน LINE Developers

1.4 (ไม่บังคับ) ขอสิทธิ์เข้าถึงอีเมล

โดยปกติ LINE จะไม่ส่งอีเมล หากคุณต้องการรับอีเมล:

• ในการตั้งค่าช่องทาง ให้ค้นหา การอนุญาตที่อยู่อีเมล และขอสิทธิ์การเข้าถึงอีเมล รอการอนุมัติ
• เพิ่ม email ลงในขอบเขตของ URL การเข้าสู่ระบบ OAuth (อธิบายไว้ในขั้นตอนที่ 2.2)

1.5 เปลี่ยนช่องเป็น "เผยแพร่"

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

ขั้นตอนที่ 2: กำหนดค่าในโปรแกรมแก้ไข OOOPEN Lab

ไปที่หน้าแก้ไขโปรเจ็กต์ทดสอบ → แผงการตั้งค่าด้านขวา → การตั้งค่าการเข้าสู่ระบบ/สิทธิ์ → เลือก การเข้าสู่ระบบ OAuth แบบกำหนดเองเป็น วิธีการเข้าสู่ระบบ และกรอกข้อมูลในแต่ละช่องตามคำแนะนำต่อไปนี้

2.1 ฟิลด์แสดงผล

2.2 URL สำหรับเข้าสู่ระบบ OAuth

ระบุเอนด์พอยต์การอนุญาตของ LINE พร้อมด้วย Channel ID และ scope ของคุณ ไม่จำเป็น ต้องใส่ redirect_uri และ state ด้วยตนเอง แพลตฟอร์มจะเพิ่มข้อมูลเหล่านั้นให้โดยอัตโนมัติ

https://access.line.me/oauth2/v2.1/authorize?response_type=code&client_id={Channel ID ของคุณ}&scope=profile%20openid

พารามิเตอร์เสริม:

• หากต้องการรับที่อยู่อีเมล : เปลี่ยนขอบเขตเป็น profile%20openid%20email (ต้องได้รับการอนุมัติจาก LINE)
• เพิ่มเพื่อนโดยอัตโนมัติหลังจากเข้าสู่ระบบ : เพิ่ม &bot_prompt=normal (ต้องใช้ช่องทางการเข้าสู่ระบบและช่องทาง API การส่งข้อความของบัญชีทางการอยู่บนผู้ให้บริการเดียวกันและเชื่อมโยงกันแล้ว)

2.3 ประเภทการอนุมัติการคืนสินค้า

เลือกใช้ รหัสการอนุญาต (แนะนำ) LINE ไม่แนะนำให้ใช้ Implicit Flow

2.4 เว็บไซต์แลกเปลี่ยนโทเค็น

จุดเชื่อมต่อโทเค็นของ LINE เขียน grant_type , client_id และ client_secret ลงในสตริงคำค้นหาโดยตรง:

https://api.line.me/oauth2/v2.1/token?grant_type=authorization_code&client_id={Channel ID ของคุณ}&client_secret={Channel secret ของคุณ}

⚠️ รหัสลับช่องของคุณจะถูกเก็บไว้ในการตั้งค่าเบื้องหลังของแบบทดสอบ แม้ว่าจะมีเพียงเบื้องหลังเท่านั้นที่สามารถอ่านได้ แต่นั่นหมายความว่าคุณได้อนุญาตให้แพลตฟอร์ม OOOPEN Lab จัดเก็บข้อมูลดังกล่าวแล้ว หากช่องของคุณถูกใช้งานโดยระบบอื่น ๆ หรือหากคุณมีข้อกำหนดด้านความปลอดภัยที่สูงกว่า ขอแนะนำให้คุณสมัครช่องล็อกอิน LINE แยกต่างหากสำหรับ OOOPEN Lab

2.5 วิธีการเก็บรวบรวมข้อมูลผู้ใช้

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

• เลือก OpenID Connect เป็นวิธีการเชื่อมต่อ
• URL ของ OpenID Connect (OIDC) :
  https://api.line.me/oauth2/v2.1/verify?client_id={Channel ID ของคุณ}
• แพลตฟอร์มจะส่ง id_token ไปยังเอนด์พอยต์นี้ผ่านคำขอ POST เพื่อตรวจสอบและแยกข้อมูล ซึ่งจะถูกส่งกลับมาในรูปแบบดังต่อไปนี้:
  • sub → รหัสผู้ใช้ LINE (เช่น รหัสสมาชิก)
  • name → ชื่อที่แสดง
  • email → อีเมล (ต้องได้รับการอนุมัติขอบเขตการใช้งานอีเมลและรวมอยู่ในขอบเขตการใช้งานข้อ 2.2)

⚠️ โหมดนี้ต้องการให้ openid อยู่ในขอบเขตของเวอร์ชัน 2.2 (ดังที่ได้รวมอยู่ในตัวอย่างก่อนหน้านี้แล้ว) มิเช่นนั้น LINE จะไม่ส่งคืน id_token และการเข้าสู่ระบบจะล้มเหลว

เมื่อกรอกข้อมูลเสร็จแล้ว ให้คลิก "บันทึก"

ขั้นตอนที่ 3: คุณจะได้รับรหัสผู้ใช้ LINE ประเภทใด?

ช่องรหัสสมาชิกที่แสดงใน แบบฟอร์ม "การจัดการคำตอบ" การส่งออก CSV และข้อมูล Webhook ของ OOOPEN Lab เป็น รหัสผู้ใช้ LINE ( Uxxxxxxxxxxxxxxxx... ) ซึ่ง เหมือนกับ userId ที่ได้รับจาก Webhook ของ Messaging Account บัญชี LINE อย่างเป็นทางการของคุณทุกประการ ไม่จำเป็นต้องมีการประมวลผลสตริงใดๆ เพื่อการเปรียบเทียบ

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

💡 หากคุณเปลี่ยนไปใช้ "การเข้าสู่ระบบสมาชิกชุมชน → LINE" ที่มีอยู่ในแพลตฟอร์ม (ไม่ใช่วิธีที่อธิบายไว้ในบทความนี้) รหัสสมาชิกจะยังคงแสดงในรูปแบบ Uxxxx... แต่ Uxxxx นี้มาจากช่อง LINE ของ OOOPEN Lab เอง และ ไม่ตรงกับรหัสเพื่อนในบัญชีทางการของคุณ นี่คือเหตุผลหลักที่คุณต้องใช้ "การเข้าสู่ระบบ OAuth แบบกำหนดเอง"

ขั้นตอนที่ 4: Webhook รับข้อมูลอะไรบ้าง?

เมื่อผู้เล่นทำแบบทดสอบเสร็จสิ้น OOOPEN Lab จะส่งข้อมูล (payload) ไปยัง URL ของ webhook ที่คุณตั้งไว้ (สำหรับคำแนะนำในการตั้งค่า webhook โปรดดูที่ วิธีใช้ webhook เพื่อเชื่อมต่อข้อมูลแบบทดสอบของ OOOPEN Lab ) หากแบบทดสอบมีการเข้าสู่ระบบด้วย OAuth ฟิลด์ data.oauthUser ในข้อมูลที่ส่งมาจะประกอบด้วยข้อมูลสมาชิกของผู้เล่น

ตัวอย่างข้อมูลเพย์โหลดที่สมบูรณ์ (เหตุการณ์การทดสอบเสร็จสิ้น):

{ "type": "finish", "timestamp": "2026-06-01T12:34:56.789Z", "data": { "answerId": "abc...", "quizId": "abc123", "quizName": "แบบทดสอบบุคลิกภาพของคุณ", "startedAt": "2026-06-01T12:30:00.000Z", "finishedAt": "2026-06-01T12:34:56.000Z", "duration": 296000, "result": { "id": "result-A", "label": "นักคิดเชิงเหตุผล" }, "oauthUser": { "id": "U1234567890abcdef...", "email": "...", "provider": "custom" }, "answers": [ { "id": "q1", "title": "...", "value": "...", "duration": 1234 } ] } }

data.oauthUser.id คือ userId ของผู้เล่นใน LINE ซึ่งสามารถนำไปเปรียบเทียบกับ userId ที่ได้รับจาก Messaging API ของบัญชี LINE อย่างเป็นทางการ ได้โดยตรง โดยไม่ต้องผ่านกระบวนการเพิ่มเติมใดๆ

const lineUserId = payload.data.oauthUser.id; // "U1234567890abcdef..." // ใช้กับ GET /v2/bot/profile/{userId} โดยตรง // หรือเปรียบเทียบกับรายชื่อเพื่อนในฐานข้อมูล

รายการตรวจสอบการทดสอบแบบครบวงจร

แนะนำให้ดำเนินการตามขั้นตอนต่อไปนี้ก่อนการติดตั้งใช้งาน:

1. บันทึกการตั้งค่าในโปรแกรมแก้ไข → เปิดเว็บไซต์ทดสอบในโหมดไม่ระบุตัวตน
2. คลิก "เข้าสู่ระบบด้วย {ชื่อแพลตฟอร์มของคุณ}" → หน้าต่างป๊อปอัพจะนำคุณไปยัง access.line.me
3. เข้าสู่ระบบ LINE ให้เสร็จสมบูรณ์ → หน้าต่างป๊อปอัพจะปิดโดยอัตโนมัติ และคุณสามารถทำแบบทดสอบต่อในหน้าต่างเดิมได้
4. ทำแบบทดสอบให้เสร็จสมบูรณ์ → ค้นหาบันทึกในส่วน "การจัดการคำตอบ" ของระบบหลังบ้าน OOOPEN Lab และตรวจสอบว่าช่องรหัสสมาชิกแสดงเป็น Uxxxx... (รูปแบบเดียวกับรหัสเพื่อนบัญชี LINE Official Account ของคุณ)
5. ตรวจสอบให้แน่ใจว่า Webhook Server ของคุณได้รับคำขอ POST แล้ว และ data.oauthUser.id ใน payload มี userId จากขั้นตอนก่อนหน้า
6. เปรียบเทียบ Uxxxx... กับบันทึก webhook ของบัญชี LINE อย่างเป็นทางการ (หรือ GET /v2/bot/profile/{userId} ) แล้วคุณจะพบว่าข้อมูลนั้นเป็นของบุคคลเดียวกัน

ปัญหาที่พบได้ทั่วไปและวิธีแก้ไขปัญหา

Q1: หน้าต่างป๊อปอัพแสดงข้อความว่า "เกิดข้อผิดพลาดขณะเข้าสู่ระบบ"

เมื่อเปิดคอนโซลของเบราว์เซอร์ แพลตฟอร์มจะ postMessage ข้อความตอบกลับข้อผิดพลาดจาก LINE ในหน้าต่างเดิม สาเหตุทั่วไป:

คำถามที่ 2: ฉันจะหาที่อยู่อีเมลได้อย่างไร?

LINE ไม่ส่งอีเมลโดยอัตโนมัติ ต้องทำตามขั้นตอนสองขั้นตอนดังนี้:

• สมัครขอสิทธิ์การใช้งานอีเมลภายใน LINE Developers และรอการอนุมัติ
• เปลี่ยนขอบเขตในเวอร์ชัน 2.2 profile%20openid%20email

Q3: สามารถใช้ช่อง LINE เดียวสำหรับแบบทดสอบหลายรายการได้หรือไม่?

ใช่ LINE อนุญาตให้ใช้ URL การเรียกกลับได้หลายรายการต่อช่อง โปรดเพิ่ม /auth/{quizId}/callback สำหรับแต่ละแบบทดสอบ การตั้งค่า OAuth จะต้องกรอกแยกกันสำหรับแต่ละแบบทดสอบ แต่การใช้ Channel ID และ secret เดียวกันจะช่วยให้มั่นใจได้ว่าหลายช่องข้อมูลจะเหมือนกัน

คำถามที่ 4: จะกำหนดผู้ใช้ใหม่ข้ามหมวดหมู่การทดสอบต่างๆ ได้อย่างไร?

เมื่อผู้ใช้ LINE คนเดียวกันทำแบบทดสอบต่าง ๆ บนแพลตฟอร์มของคุณ data.oauthUser.id ที่ได้รับจาก Webhook จะเป็นรหัสผู้ใช้ LINE เดียวกัน (โดยที่แบบทดสอบทั้งหมดใช้ช่องทางการเข้าสู่ระบบ LINE เดียวกัน) เซิร์ฟเวอร์ Webhook ของคุณสามารถใช้ oauthUser.id เป็นคีย์หลักในการเชื่อมโยงข้อมูลระหว่างแบบทดสอบได้โดยตรง

Q5: ฉันควรทำอย่างไรหากต้องการปิดใช้งานหรือเปลี่ยนช่องของฉัน?

กลับไปที่แผงการตั้งค่าเดิมในโปรแกรมแก้ไข แล้วแก้ไข Channel ID และ secret ใน OAuth login URL/Token exchange URL/OIDC URL ข้อมูลการตอบกลับของผู้เล่นที่มีอยู่จะไม่ได้รับผลกระทบ แต่ หลังจากเปลี่ยนช่อง (โดยเฉพาะอย่างยิ่งระหว่างผู้ให้บริการ) userId ของ LINE ที่เข้าสู่ระบบใหม่จะไม่ตรงกับข้อมูลเก่า (userId ของ LINE ระหว่างผู้ให้บริการใช้ namespace ที่แตกต่างกัน) ขอแนะนำให้เปลี่ยนช่องก่อนเริ่มรวบรวมรายชื่อผู้ใช้เท่านั้น

บทความที่เกี่ยวข้อง

• ฉันจะใช้ OAuth เพื่อผสานรวมการตรวจสอบการเข้าสู่ระบบสำหรับโครงการ OOOPEN Lab ได้อย่างไร?
• ฉันจะใช้ Webhook เพื่อเชื่อมต่อข้อมูลการทดสอบของ OOOPEN Lab ได้อย่างไร?

การอ้างอิงภายนอก

• เอกสารทางการสำหรับการเข้าสู่ระบบ LINE
• เอกสารอ้างอิง API การเข้าสู่ระบบ LINE