ข้ามไปที่เนื้อหา

Webhook URLs (🔗)

URL ที่ต้องนำไปวางใน LINE Developers Console — เพื่อให้ LINE ส่ง webhook มาที่ mergchat

ภาพรวม

หมายเลขในรูป:

  1. หัวข้อ + คำอธิบาย "คัดลอก URL ไปวางใน Line Developers Console"
  2. กล่องวิธีตั้งค่า 5 ขั้นตอน — guide ละเอียดอยู่ใน LINE OA Setup
  3. Webhook URL ต่อ OA — pattern: https://chat.<domain>/api/webhook/<channelId>
  4. ปุ่ม "คัดลอก" — copy ไปวางใน LINE Developers Console → Messaging API tab

หลังเพิ่ม OA ใน จัดการ OA — ระบบจะ generate webhook URL สำหรับ OA นั้น

URL Format:

https://chat.<your-domain>/webhook/<channelId>

ตัวอย่าง:

https://chat.aurora1688.vip/webhook/2008926200

ตั้งค่าใน LINE Developers Console

1. คัดลอก URL จาก mergchat

Settings → tab 🔗 Webhook URLs → หา OA → กดปุ่ม copy

2. วางใน LINE Developers Console

  1. ไปที่ https://developers.line.biz/console/
  2. เลือก provider → channel ของ OA นี้
  3. tab Messaging APIWebhook URL → วาง URL
  4. กด 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 ล้มเหลว

ตรวจ:

  1. mergchat backend running: curl https://chat.<domain>/health = 200
  2. Channel Secret ใน mergchat ตรงกับ LINE Console (เป็นค่าเดิม)
  3. Caddy reverse-proxy: curl https://chat.<domain>/webhook/<channelId> = 401 หรือ 500 (ไม่ใช่ 404)
  4. Firewall + DNS: domain resolve + port 443 เปิด
URL ผิดต้องแก้ที่ไหน

ที่ LINE Developers Console เท่านั้น — mergchat รับ URL ตามที่ LINE ส่งมา

ใช้ HTTP (ไม่ใช่ HTTPS) ได้ไหม

ไม่ได้ — LINE require HTTPS เท่านั้น (TLS valid cert)

ที่อ้างอิง