Webhook URLs (🔗)←
URL ที่ต้องนำไปวางใน LINE Developers Console — เพื่อให้ LINE ส่ง webhook มาที่ mergchat
ภาพรวม←

หมายเลขในรูป:
- หัวข้อ + คำอธิบาย "คัดลอก URL ไปวางใน Line Developers Console"
- กล่องวิธีตั้งค่า 5 ขั้นตอน — guide ละเอียดอยู่ใน LINE OA Setup
- Webhook URL ต่อ OA — pattern:
https://chat.<domain>/api/webhook/<channelId> - ปุ่ม "คัดลอก" — copy ไปวางใน LINE Developers Console → Messaging API tab
หลังเพิ่ม OA ใน จัดการ OA — ระบบจะ generate webhook URL สำหรับ OA นั้น
URL Format:
ตัวอย่าง:
ตั้งค่าใน LINE Developers Console←
1. คัดลอก URL จาก mergchat←
Settings → tab 🔗 Webhook URLs → หา OA → กดปุ่ม copy
2. วางใน LINE Developers Console←
- ไปที่ https://developers.line.biz/console/
- เลือก provider → channel ของ OA นี้
- tab Messaging API → Webhook URL → วาง URL
- กด Update
3. เปิด Use webhook → ON←
ใต้ช่อง Webhook URL:
- toggle Use webhook = ON
4. กด Verify←
LINE จะส่ง test request ไปที่ webhook URL → ต้องได้ HTTP 200 จาก mergchat:
- ถ้า ✅ Success → connect สำเร็จ ลูกค้าทักได้
- ถ้า ❌ Failed → ตรวจ:
- URL ถูกหรือไม่
- Channel Secret ใน mergchat ตรงกับ LINE Console
- mergchat backend running + Caddy proxy OK
กระแสข้อมูลหลัง Webhook ตั้งสำเร็จ←
ลูกค้า → ส่งข้อความใน LINE
↓
LINE Messaging API → POST https://chat.<domain>/webhook/<channelId>
↓ (HMAC-SHA256 verify ด้วย channel_secret)
mergchat backend → INSERT message + WS broadcast
↓
agent UI → push event → conversation list อัพเดต
คำถามที่พบบ่อย←
Verify ล้มเหลว
ตรวจ:
- mergchat backend running:
curl https://chat.<domain>/health= 200 - Channel Secret ใน mergchat ตรงกับ LINE Console (เป็นค่าเดิม)
- Caddy reverse-proxy:
curl https://chat.<domain>/webhook/<channelId>= 401 หรือ 500 (ไม่ใช่ 404) - Firewall + DNS: domain resolve + port 443 เปิด
URL ผิดต้องแก้ที่ไหน
ที่ LINE Developers Console เท่านั้น — mergchat รับ URL ตามที่ LINE ส่งมา
ใช้ HTTP (ไม่ใช่ HTTPS) ได้ไหม
ไม่ได้ — LINE require HTTPS เท่านั้น (TLS valid cert)
ที่อ้างอิง←
- Backend: POST
/webhook/:channelIdhandler - LINE doc: https://developers.line.biz/en/docs/messaging-api/receiving-messages/
- Quick start: LINE OA Setup