การตั้งค่า LINE Messaging API
คู่มือนี้จะแนะนำขั้นตอนการเชื่อมต่อ LINE Official Account กับ MorphX ตั้งแต่การสร้างบัญชี LINE Developers จนถึงการทดสอบการทำงาน
สิ่งที่ต้องเตรียม
| รายการ | รายละเอียด |
|---|---|
| บัญชี LINE | บัญชี LINE ส่วนตัวสำหรับเข้าสู่ระบบ LINE Business ID |
| LINE Official Account | บัญชี LINE สำหรับธุรกิจ (สร้างฟรี) |
| HTTPS Domain | โดเมนที่รองรับ SSL สำหรับ Webhook (ห้ามใช้ Self-signed Certificate) |
Credentials ที่ต้องใช้
MorphX ต้องการ Credentials 2 รายการจาก LINE:
| Credential | ที่มา | การใช้งาน |
|---|---|---|
| Channel Secret | LINE Developers Console → Basic settings | ใช้ตรวจสอบลายเซ็น Webhook |
| Channel Access Token | LINE Developers Console → Messaging API tab | ใช้ส่งข้อความตอบกลับ |
ขั้นตอนที่ 1: สร้างบัญชี LINE Business ID
LINE ใช้ระบบ Business ID สำหรับเข้าสู่ระบบทั้ง LINE Official Account Manager และ LINE Developers Console
- ไปที่ LINE Business ID
- เลือกวิธีสมัคร:
- บัญชี LINE — เข้าสู่ระบบด้วยบัญชี LINE ส่วนตัว (แนะนำ — สะดวกที่สุด)
- อีเมล — สร้างบัญชีใหม่ด้วยอีเมลและรหัสผ่าน
- หากสมัครด้วยอีเมล ต้องยืนยันอีเมลก่อนใช้งาน
เคล็ดลับ
แนะนำให้ใช้บัญชี LINE ส่วนตัวในการสมัคร เพราะสะดวกกว่าและไม่ต้องจำรหัสผ่านเพิ่มเติม
ขั้นตอนที่ 2: สร้าง LINE Official Account
LINE Official Account (OA) คือบัญชีที่ผู้ใช้จะเห็นและสามารถส่งข้อความถึงได้
- หลังเข้าสู่ระบบ Business ID จะมีหน้าจอให้สร้าง LINE Official Account
- กรอกข้อมูล:
- ชื่อบัญชี — ชื่อที่ผู้ใช้จะเห็น (เช่น ชื่อบริษัท หรือชื่อแบรนด์)
- บริษัท/องค์กร (ถ้ามี)
- หมวดหมู่ และ หมวดย่อย ของธุรกิจ
- อีเมล สำหรับรับการแจ้งเตือน
- คลิก สร้าง แล้วยอมรับเงื่อนไขการใช้งาน
- ตรวจสอบว่าบัญชีปรากฏใน LINE Official Account Manager
ขั้นตอนที่ 3: สร้าง Provider ใน LINE Developers Console
Provider คือหน่วยขององค์กรที่เป็นเจ้าของ Channel ต่างๆ
- ไปที่ LINE Developers Console
- เข้าสู่ระบบด้วย Business ID เดียวกับขั้นตอนที่ 1
- ที่หน้า Providers คลิกปุ่ม Create
- กรอก ชื่อ Provider:
- ใช้ชื่อบริษัทหรือองค์กรจริง (ชื่อนี้จะแสดงในหน้าจอขอความยินยอมของผู้ใช้)
- สามารถสร้างได้สูงสุด 10 Providers ต่อบัญชี
- คลิก Create เพื่อยืนยัน
ข้อควรระวัง
เมื่อสร้าง Channel ภายใต้ Provider แล้ว จะไม่สามารถย้ายไป Provider อื่นได้ ควรเลือก Provider ให้เหมาะสมตั้งแต่แรก
ขั้นตอนที่ 4: เปิดใช้งาน Messaging API
มี 2 วิธีในการสร้าง Messaging API Channel:
วิธี A: จาก LINE Official Account Manager (แนะนำ)
วิธีนี้เป็นวิธีที่ LINE แนะนำ เพราะจะสร้าง Channel อัตโนมัติ
- ไปที่ LINE Official Account Manager
- เลือก LINE Official Account ของคุณ
- ไปที่ ตั้งค่า → Messaging API
- คลิก เปิดใช้งาน Messaging API
- หากเป็นครั้งแรก จะมีหน้าจอลงทะเบียนนักพัฒนา — กรอกชื่อและอีเมล
- เลือก Provider ที่ต้องการเชื่อมต่อ (ไม่สามารถเปลี่ยนภายหลังได้)
- ยอมรับเงื่อนไขการใช้งาน
- Messaging API Channel จะถูกสร้างโดยอัตโนมัติ
วิธี B: จาก LINE Developers Console
- ใน LINE Developers Console เลือก Provider ของคุณ
- คลิก Create a new channel → เลือก Messaging API
- กรอกข้อมูล:
- Channel name (ห้ามมีคำว่า "LINE" อยู่ในชื่อ)
- Channel description
- Category และ Sub-category
- Email address
- ยอมรับเงื่อนไข แล้วคลิก Create
ขั้นตอนที่ 5: คัดลอก Credentials
Channel Secret
- ใน LINE Developers Console เลือก Messaging API Channel ของคุณ
- ไปที่แท็บ Basic settings
- หา Channel secret แล้วคลิกคัดลอก
Channel Access Token
- ใน Channel เดียวกัน ไปที่แท็บ Messaging API
- เลื่อนลงไปที่ Channel access token (long-lived)
- คลิก Issue เพื่อสร้าง Token ใหม่
- คัดลอก Token ทันที — เป็นสตริงยาว
ประเภท Token ที่มี
| ประเภท | อายุการใช้งาน | จำนวนสูงสุด | หมายเหตุ |
|---|---|---|---|
| Long-lived | ไม่มีวันหมดอายุ | 1 ต่อ Channel | ง่ายที่สุด การออก Token ใหม่จะทำให้ Token เก่าใช้งานไม่ได้ |
| v2.1 | สูงสุด 30 วัน | 30 | ปลอดภัยกว่า ใช้ JWT |
| Stateless | 15 นาที | ไม่จำกัด | ไม่สามารถเพิกถอนได้ |
สำหรับการใช้งานกับ MorphX แนะนำให้ใช้ Long-lived Token เพราะง่ายที่สุด
ขั้นตอนที่ 6: ตั้งค่าใน MorphX Dashboard
- เข้าสู่ระบบ MorphX Dashboard
- ไปที่เมนู แพลตฟอร์ม (
/dashboard/platforms) - คลิกที่การ์ด LINE → คลิก ตั้งค่า
- กรอก Credentials:
- Channel Secret — จากแท็บ Basic settings
- Channel Access Token — จากแท็บ Messaging API
- คลิก บันทึก
ฟีเจอร์อัตโนมัติของ MorphX
เมื่อบันทึก Credentials สำเร็จ MorphX จะ:
- ✅ ตรวจสอบ Credentials อัตโนมัติ
- ✅ ตั้งค่า Webhook URL อัตโนมัติผ่าน LINE Bot SDK
- ✅ ทดสอบการเชื่อมต่อ Webhook
- ✅ ดึงข้อมูล Bot (ชื่อ, รูปโปรไฟล์, Basic ID)
ขั้นตอนที่ 7: ตั้งค่า Webhook URL
MorphX ตั้งค่า Webhook ให้อัตโนมัติ
ในกรณีทั่วไป MorphX จะตั้งค่า Webhook URL ให้โดยอัตโนมัติเมื่อคุณบันทึก Credentials สำเร็จ คุณสามารถข้ามขั้นตอนนี้ได้ แต่หากต้องการตั้งค่าเอง ให้ทำตามขั้นตอนด้านล่าง
ตั้งค่าเองใน LINE Developers Console
- เลือก Messaging API Channel ของคุณ
- ไปที่แท็บ Messaging API
- ที่ Webhook URL คลิก Edit
- ใส่ URL ในรูปแบบ:
https://<โดเมน MorphX>/api/webhook/LINE?tenantId=<TENANT_ID>
- คลิก Update
- คลิก Verify เพื่อทดสอบ — LINE จะส่ง Request ทดสอบไปยังเซิร์ฟเวอร์
- เปิดสวิตช์ Use webhook ให้เป็น Enabled
ข้อกำหนดของ Webhook URL:
- ต้องใช้ HTTPS (ไม่รองรับ HTTP)
- ต้องมี SSL/TLS Certificate ที่ออกโดยหน่วยงานที่เชื่อถือได้ (ห้ามใช้ Self-signed Certificate)
- ต้องตอบกลับด้วย HTTP Status 200
ขั้นตอนที่ 8: ตั้งค่า LINE Official Account Manager
สำคัญมาก
ขั้นตอนนี้สำคัญมาก หากไม่ตั้งค่า ระบบ Auto-reply ของ LINE จะตอบกลับผู้ใช้แทน Bot ของคุณ ทำให้ผู้ใช้ได้รับข้อความซ้ำ
ปิดข้อความทักทาย (Greeting Message)
- ไปที่ LINE Official Account Manager
- เลือก LINE Official Account ของคุณ
- ไปที่ ตั้งค่า → การตอบกลับ (Response settings)
- หา ข้อความทักทาย (Greeting message) แล้วตั้งเป็น ปิด
ปิดข้อความตอบกลับอัตโนมัติ (Auto-reply)
- ในหน้า การตอบกลับ เดียวกัน
- หา ข้อความตอบกลับอัตโนมัติ (Auto-response messages) แล้วตั้งเป็น ปิด
ตรวจสอบการตั้งค่า Webhook
- ในหน้า การตอบกลับ ยืนยันว่า Webhooks ตั้งเป็น เปิด
- โหมดตอบกลับ (Response mode) ต้องเป็น Bot (ไม่ใช่ Chat)
ทำไมต้องตั้งค่านี้?
หากเปิด Greeting message หรือ Auto-reply ไว้ ผู้ใช้จะได้รับทั้งข้อความตอบกลับอัตโนมัติของ LINE และข้อความจาก Bot ของคุณ ทำให้สับสนและได้รับข้อความซ้ำ
ขั้นตอนที่ 9: เพิ่มบอทเป็นเพื่อน (ทดสอบ)
- ใน LINE Developers Console ไปที่ Messaging API Channel ของคุณ
- เปิดแท็บ Messaging API
- หา QR Code ที่แสดงบนหน้า
- เปิดแอป LINE บนโทรศัพท์ แล้วสแกน QR Code เพื่อเพิ่มบอทเป็นเพื่อน
- ส่งข้อความทดสอบเพื่อยืนยันว่า Webhook ทำงานถูกต้อง
วิธีทดสอบ Webhook
- ส่งข้อความไปที่บอท ควรได้รับข้อความตอบกลับจาก AI
- ลองบล็อกแล้วปลดบล็อกบอท — ตรวจสอบ Server log ว่ามี Event "unfollow" และ "follow" หรือไม่
- คลิก ทดสอบการเชื่อมต่อ ใน MorphX Dashboard เพื่อตรวจสอบสถานะ
ตั้งค่าเพิ่มเติม: แชทกลุ่ม
MorphX รองรับการใช้งานบอทในกลุ่ม LINE โดยเปิดใช้งานผ่าน MorphX Dashboard
เปิดใช้งานแชทกลุ่ม
- ไปที่ แพลตฟอร์ม → การ์ด LINE → คลิก ตั้งค่า
- เลื่อนลงไปที่ส่วน การตั้งค่าแชทกลุ่ม
- เปิดสวิตช์ เปิดใช้งานแชทกลุ่ม
- ตั้ง ระยะเวลาตอบกลับ (นาที) — ค่าเริ่มต้น 5 นาที
วิธีการทำงานของบอทในกลุ่ม
- บอทจะตอบกลับเฉพาะเมื่อถูก @mention ในกลุ่ม
- หลังถูก @mention บอทจะเปิดช่วงเวลาตอบกลับตามที่ตั้งค่า (ค่าเริ่มต้น 5 นาที)
- ในช่วงเวลานี้ บอทจะตอบกลับทุกข้อความในกลุ่มโดยไม่ต้อง @mention
- เมื่อหมดเวลา บอทจะหยุดตอบจนกว่าจะถูก @mention อีกครั้ง
ตั้งค่าใน LINE Developers Console
เพื่อให้บอททำงานในกลุ่มได้ ต้องตั้งค่าเพิ่มเติม:
- ไปที่ LINE Developers Console → Messaging API Channel
- ไปที่แท็บ Messaging API
- ที่ Allow bot to join group chats ตั้งเป็น Enabled
Checklist สรุป
| ขั้นตอน | สิ่งที่ต้องทำ | ตำแหน่ง |
|---|---|---|
| 1 | สมัคร LINE Business ID | https://account.line.biz/ |
| 2 | สร้าง LINE Official Account | LINE Business ID Portal |
| 3 | สร้าง Provider | LINE Developers Console |
| 4 | เปิดใช้งาน Messaging API | LINE Official Account Manager |
| 5 | คัดลอก Channel Secret | Developers Console → Basic settings |
| 6 | สร้างและคัดลอก Channel Access Token | Developers Console → Messaging API tab |
| 7 | กรอก Credentials ใน MorphX | MorphX Dashboard → แพลตฟอร์ม |
| 8 | ตรวจสอบ Webhook URL (อัตโนมัติ) | Developers Console → Messaging API tab |
| 9 | ปิด Greeting message | Official Account Manager → การตอบกลับ |
| 10 | ปิด Auto-reply message | Official Account Manager → การตอบกลับ |
| 11 | ตั้ง Response mode เป็น "Bot" | Official Account Manager → การตอบกลับ |
| 12 | เพิ่มบอทเป็นเพื่อนและทดสอบ | สแกน QR Code จาก Messaging API tab |
การแก้ปัญหา
บอทไม่ตอบกลับข้อความ
- ตรวจสอบว่า Use webhook เปิดอยู่ใน LINE Developers Console
- ตรวจสอบว่า Auto-reply ปิดอยู่ใน LINE Official Account Manager
- คลิก ทดสอบการเชื่อมต่อ ใน MorphX Dashboard
- ตรวจสอบว่า Webhook URL ถูกต้องและเซิร์ฟเวอร์ทำงานอยู่
ได้รับข้อความซ้ำ
- ปิด ข้อความทักทาย (Greeting message) ใน LINE Official Account Manager
- ปิด ข้อความตอบกลับอัตโนมัติ (Auto-reply) ใน LINE Official Account Manager
Webhook Verification ไม่ผ่าน
- ตรวจสอบว่า URL ใช้ HTTPS
- ตรวจสอบว่า SSL Certificate ถูกต้อง (ไม่ใช่ Self-signed)
- ตรวจสอบว่าเซิร์ฟเวอร์ตอบกลับ HTTP Status 200
- ตรวจสอบว่า Channel Secret ถูกต้อง
Channel Access Token ไม่ทำงาน
- ตรวจสอบว่าคัดลอก Token ครบถ้วน (Token มีความยาวมาก)
- หาก Issue Token ใหม่ Token เก่าจะถูกยกเลิกโดยอัตโนมัติ
- ต้องอัปเดต Token ใหม่ใน MorphX Dashboard ด้วย