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

FAQ — ปัญหาที่ Admin เจอบ่อย←

10 อาการที่ admin เจอ + วิธีแก้ทันที (อาการ agent ดู agent-issues)

OA / Webhook←

Q1: เพิ่ม OA แล้ว Webhook Verify FAIL ที่ LINE Console←

สาเหตุที่พบ:

  1. Channel Secret ใน mergchat ไม่ตรงกับ LINE Console (พิมพ์ผิด)
  2. Webhook URL ผิด (พิมพ์ https://chat... ผิด domain)
  3. mergchat backend down — curl https://chat.<domain>/health ไม่ใช่ 200

วิธีแก้:

  • ตรวจ Channel Secret ทั้ง 2 ฝั่ง
  • ตรวจ URL: https://chat.<your-domain>/webhook/<channelId> (path-prefix /webhook/)
  • ติดต่อ DevOps ตรวจ container: docker ps | grep inbox_backend

Q2: OA Active แต่ลูกค้าทักไม่เข้า←

สาเหตุ:

  1. LINE Console: Use webhook = OFF (ปิดอยู่)
  2. LINE Console: Auto-response ON อยู่ (block webhook)
  3. Webhook signature failure — backend ปฏิเสธทุก message
  4. mergchat OA toggle = OFF

วิธีแก้:

  • LINE Console → Use webhook = ON, Auto-response = OFF, Greeting = OFF
  • mergchat → จัดการ OA → toggle เปิด
  • ดู logs: ssh root@<chat-server> 'docker logs inbox_backend | grep webhook'

Agent / Permissions←

Q3: Agent คนหนึ่งเห็น OA ที่ไม่ควรเห็น←

ตรวจ:

  • Settings → 🔐 จัดการสิทธิ์ → row ของ agent
  • ถ้า ✓ ทุก OA หรือไม่ ✓ อะไรเลย → agent เห็นทุก OA
  • แก้: ติ๊ก ✓ เฉพาะ OA ที่อนุญาต → กด บันทึก

Q4: Agent โดน 403 หลังเปลี่ยน Permission←

JWT cache permission ตอน login — agent ต้อง logout + login ใหม่

ดู stale-token UX bug

Q5: ลบ admin คนเดียวเลย — เข้าไม่ได้←

⚠️ ระบบไม่อนุญาตลบ admin ตัวเองโดยตรง — แต่ถ้ามี 2 admin และคนหนึ่งลบอีกคนทิ้ง...

วิธีกู้: ติดต่อ DevOps แก้ DB:

-- ระวัง: write operation = ขออนุญาตจาก Dev/DevOps lead ก่อน
UPDATE agents SET role = 'admin' WHERE email = 'YOUR_EMAIL';

AI Bot←

Q6: Bot ไม่ตอบ / Bot Shadow Logs ว่างเปล่า←

ตรวจ:

  1. Settings → 🤖 AI Bot → mode = Shadow (ไม่ใช่ Off)
  2. FAQ Knowledge Base ไม่ว่างเปล่า
  3. Backend Claude API key valid (DevOps task)

Q7: Bot ตอบช้ามาก (>10 วินาที)←

ปกติ Claude API ~1-3 วินาที ถ้าเกิน:

  1. Network ฝั่ง backend ไป Claude (anthropic.com) มีปัญหา
  2. Claude API rate limit hit
  3. ดู: docker logs inbox_backend | grep claude

Reports / Dashboard←

Q8: Reports ตัวเลขไม่ตรงกับที่ agent คาดหวัง←

ตรวจ:

  • Period ที่เลือก (7/30/90 วัน) — boundary ใช้ rolling 7×24h ไม่ใช่ปฏิทิน
  • Timezone (UTC ใน DB → display Bangkok)
  • Refresh page (data cache 1 นาที)

Q9: Dashboard chart ว่างเปล่า←

Period ที่เลือกยังไม่มี traffic → ลองขยาย 90 วัน

Backup / DB←

Q10: ต้องการ export ข้อมูลทั้ง tenant←

mergchat ปัจจุบัน v1.0 ไม่มี UI export — DevOps ทำผ่าน Postgres dump:

ssh root@<chat-server> 'docker exec inbox_postgres pg_dump -U lineinbox lineinbox' > tenant-backup.sql

(เป็น operation read-only ปลอดภัย — แต่ไฟล์มี customer data ระมัดระวัง storage + retention)

ที่อ้างอิง←