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

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

12 อาการที่พบบ่อยฝั่ง Agent + วิธีแก้ทันที (อาการที่ Admin ต้องช่วย — ดู admin-issues)

🔐 Login / Logout←

Q1: Login ไม่ได้ — "อีเมลหรือรหัสผ่านไม่ถูกต้อง"←

สาเหตุที่พบ: 1. Username/email พิมพ์ผิด (case-sensitive) 2. Caps Lock เปิดอยู่ 3. Admin reset password ไปแล้วยังไม่บอก

วิธีแก้: - ตรวจ Caps Lock + แล้วลองใหม่ - ขอ Admin reset password (ดู จัดการ Agent)

Q2 — 🔴 403 "Admin only" ตอนกดสร้าง Agent (Stale Token)←

อาการ: - กด + สร้าง Agent หรือ admin action อื่น → alert ขึ้นว่า "Admin only" - console เห็น Failed to load resource: 403 ที่ /api/agents

สาเหตุ: บัญชีที่ login ค้างใน browser ถูกแก้ role / ถูกลบไปแล้วในฐานข้อมูล แต่ JWT เก่ายังอยู่ใน localStorage

วิธีแก้ (5 วินาที):

  1. กดปุ่ม ออก มุมล่างซ้ายของ Settings
  2. Login ใหม่ด้วย username/password — token ใหม่จะดึง role ล่าสุดจาก DB
  3. ลองกด + สร้าง Agent อีกครั้ง

ถ้ายังไม่หาย → ดูข้อ Q3 ด้านล่าง

Q3: ลบ token ใน localStorage แล้วยังไม่หาย←

สาเหตุที่ลึกกว่า: - บัญชีของคุณถูก downgrade เป็น agent แต่ในความจริงคุณต้องเป็น admin - ขัดกับ workflow ของทีม

วิธีแก้: ติดต่อ Admin หลักให้เช็ค DB:

-- (Admin ขออนุญาต DevOps ดู) Production DB = read-only
SELECT id, name, email, role FROM agents WHERE email = 'YOUR_EMAIL';

ถ้า role เป็น agent → ขอให้ Admin หลักแก้กลับเป็น admin

Q4: Auto-logout แม้กำลังตอบแชทอยู่←

สาเหตุ: JWT หมดอายุ (default 7 วัน) — ระบบ force logout

วิธีป้องกัน: Login ใหม่อย่างน้อยทุก 7 วัน หรือทุกต้นสัปดาห์

💬 Inbox / แชท←

Q5: WebSocket disconnect บ่อย — [WS] Disconnected — retrying in 3s←

สาเหตุ: - Network unstable - Server restart (deploy ceremony — ปกติ ~3-15 วินาที) - Caddy reload (เปลี่ยน config)

วิธีแก้: - ปกติระบบ retry อัตโนมัติทุก 3 วินาที — รอสักครู่ - ถ้า disconnect นานเกิน 30 วินาที → refresh หน้า

Q6: ส่งข้อความตอบลูกค้าแล้ว ไม่ขึ้นใน chat timeline←

สาเหตุ: 1. WebSocket ขาด → message ส่งสำเร็จที่ DB แต่ไม่ broadcast กลับมา UI 2. Network 5xx ที่ POST /api/messages

วิธีแก้: - Refresh หน้า → ข้อความที่ส่งไปก่อนหน้าจะกลับมา (ดึงจาก DB) - ถ้ายังไม่ขึ้น → ลองส่งใหม่อีกครั้ง

Q7: เปิดแชทใหม่จาก Inbox แล้วเห็น "ไม่พบข้อความ"←

สาเหตุ: Conversation ยังไม่มี message ใดเลย (ลูกค้าเพิ่งเริ่มส่ง LINE OA)

วิธีแก้: รอ 2-3 วินาที (real-time จะ push เข้ามา) หรือ refresh

⚡ Quick Replies←

Q8: Hotkey Alt+1..9 ไม่ทำงาน←

สาเหตุ: Browser ดักจับ Alt+ตัวเลขก่อน mergchat (เช่น Firefox = address bar)

วิธีแก้: - คลิกในช่องพิมพ์ตอบให้ focus อยู่ในช่องนั้น ก่อน กด hotkey - คลิก hint bar เลย (mouse) แทน — ทำงานเหมือนกัน

Q9: ส่ง Quick Reply ไปแล้วลูกค้าได้รับเป็น text เปล่า ไม่มี emoji←

สาเหตุ: Emoji ที่ Admin ตั้งใน Quick Reply อาจจะไม่ render บน LINE OA ของลูกค้า (มือถือเก่า / Web LINE)

วิธีแก้: หลีกเลี่ยง emoji หายาก ใช้แค่ emoji LINE/Unicode มาตรฐาน 😊 🙏 ✅

🏷 Tags / Notes←

Q10: ติด tag ลูกค้าแล้วหายไป←

สาเหตุ: Tag ที่ admin ลบในขณะที่คุณกำลังเปิดหน้านั้น → frontend cache ยังไม่ refresh

วิธีแก้: Refresh หน้า — tag list ใหม่จะแสดง

Q11: Note ภายใน (📝) ลูกค้าเห็นไหม?←

คำตอบ: ❌ ลูกค้าไม่เห็น Note ภายในแสดงเฉพาะ Agent ทุกคนในระบบ (broadcast real-time ผ่าน WebSocket) — ใช้สำหรับสื่อสารระหว่างทีม

🤖 AI Bot←

Q12: คำแนะนำของ AI Bot ผิดบ่อย←

สาเหตุ: AI Bot ใช้ FAQ Knowledge Base ที่ Admin ตั้งไว้ ถ้า FAQ ไม่ครอบคลุมคำถามนั้น Claude จะเดาคำตอบจาก context

วิธีช่วย: - กด 👎 เมื่อคำตอบผิด (Admin จะเห็น Bot Shadow Logs และนำมาปรับปรุง FAQ) - กด 👍 เมื่อตรงประเด็น (เก็บ stats สำหรับ accuracy metric) - ถ้าเห็น auto_send (Auto Mode) ผิด → กด ↗ ใช้ข้อความนี้ จะ ไม่ถูกส่ง จนกว่าจะ confirm

ที่อ้างอิง←