CORTEX · คู่มือการตั้งค่า

เชื่อมอีเมลเข้าหน้ารวมแชท

เชื่อมกล่องอีเมล (Gmail, Outlook หรือ SMTP ของบริษัท) เข้ากับ CORTEX เพื่อให้อีเมลลูกค้าเข้ามาอยู่ในหน้ารวมแชทเดียวกับ LINE และ Facebook ตอบได้จากที่เดียว และให้ AI ช่วยตอบได้ด้วยความรู้ชุดเดิมของแชทบอท

1. เตรียมรหัสผ่านสำหรับแอป (App Password)

  • ผู้ให้บริการอีเมลแทบทุกเจ้าไม่ยอมให้แอปภายนอกล็อกอินด้วยรหัสผ่านปกติอีกแล้ว ต้องสร้าง "App Password" ขึ้นมาเฉพาะ
  • Gmail: เปิด 2-Step Verification ก่อน แล้วเข้า myaccount.google.com/apppasswords เพื่อสร้างรหัส 16 ตัวอักษร คัดลอกเก็บไว้ (ดูได้ครั้งเดียว)
  • ถ้าเป็นอีเมลบริษัท (@ชื่อบริษัท.com) ให้ขอ IMAP/SMTP host, port และรหัสผ่านจากผู้ดูแลระบบหรือผู้ให้บริการโฮสต์

2. เพิ่ม Email Channel ใน CORTEX

  • ไปที่เมนู “ตั้งค่าแชทบอท” (Chatbot Settings) → เลือกแชทบอทที่ต้องการ → ส่วน Channels → กด “Add Channel”
  • เลือกประเภทเป็น Email แล้วเลือกวิธีเชื่อมต่อ: “เชื่อมต่อ Gmail ด้วย App Password” หรือ “เชื่อมต่อ Email อื่น / SMTP ของบริษัท”
  • พิมพ์ที่อยู่อีเมลลงไป ระบบจะเติม IMAP/SMTP host และ port ให้อัตโนมัติถ้าเป็นผู้ให้บริการที่รู้จัก (แก้เองได้ตลอด)
  • ช่อง Username ของทั้ง IMAP และ SMTP ให้ใส่อีเมลเต็ม ส่วน Password ให้ใส่ App Password ที่สร้างไว้ในขั้นตอนที่ 1

3. กดทดสอบการเชื่อมต่อ

  • หลังกด Add Channel แล้ว ในรายการ Channel จะมีปุ่มรูปหลอดทดลอง (🧪) — กดเพื่อให้ระบบลองล็อกอิน IMAP และ SMTP จริง
  • ถ้าขึ้นข้อความสีแดง ส่วนใหญ่มาจาก 3 เรื่อง: ใส่รหัสผ่านปกติแทน App Password, ยังไม่ได้เปิด IMAP ในกล่องอีเมล, หรือ port ผิด

4. อีเมลจะเข้าหน้ารวมแชทเอง

  • ระบบจะเช็คกล่องอีเมลทุก ๆ 2 นาที อีเมลใหม่จะกลายเป็นห้องแชทในหน้า “แชทรวม” (/chat-inbox) พร้อมป้ายกำกับสีม่วงว่า Email
  • กรองเฉพาะอีเมลได้จากตัวกรองช่องทาง → เลือก “Email”
  • ตอบกลับจากหน้าแชทได้เลย ระบบจะส่งเป็นอีเมลจริงกลับไปหาลูกค้า พร้อมแนบไฟล์/รูปได้ตามปกติ

5. ให้ AI ตอบอีเมลอัตโนมัติ (ถ้าต้องการ)

  • Email เป็น channel ของแชทบอทตัวเดียวกับ LINE/Facebook จึงใช้ความรู้ (Knowledge Base), สินค้า และบุคลิกเดิมทั้งหมด ไม่ต้องตั้งค่าใหม่
  • ถ้าเปิด AI ไว้ บอทจะร่างและส่งอีเมลตอบกลับให้เอง พร้อมตัดข้อความที่ถูกอ้างอิงซ้ำ (quoted reply) ออกก่อนอ่าน
  • ถ้าปิด AI ไว้ อีเมลจะยังเข้าหน้ารวมแชทเหมือนเดิม เพียงแต่รอให้แอดมินตอบเอง

ค่า IMAP / SMTP ของผู้ให้บริการยอดนิยม

CORTEX เติมค่าเหล่านี้ให้อัตโนมัติเมื่อพิมพ์อีเมล — ตารางนี้ไว้ตรวจทานหรือกรอกเอง

ผู้ให้บริการIMAP (รับ)SMTP (ส่ง)รหัสผ่านที่ต้องใช้
Gmail / Google Workspaceimap.gmail.com:993smtp.gmail.com:587ต้องเปิด 2-Step Verification แล้วสร้าง "App Password" (16 ตัวอักษร) มาใส่แทนรหัสผ่านปกติ
Outlook / Microsoft 365outlook.office365.com:993smtp.office365.com:587บัญชีที่เปิด MFA ต้องสร้าง App Password และผู้ดูแล Microsoft 365 ต้องเปิด IMAP/SMTP AUTH ให้กล่องนี้ก่อน
Yahoo Mailimap.mail.yahoo.com:993smtp.mail.yahoo.com:587ต้องสร้าง App Password จากหน้า Account Security ของ Yahoo
Zoho Mailimap.zoho.com:993smtp.zoho.com:587เปิด IMAP Access ใน Zoho Mail Settings ก่อน แล้วใช้ App Password ถ้าเปิด 2FA ไว้
iCloud Mailimap.mail.me.com:993smtp.mail.me.com:587iCloud บังคับใช้ App-Specific Password เท่านั้น สร้างได้ที่ appleid.apple.com

หมายเหตุ: SMTP port 587 ต้องปิดสวิตช์ “ใช้ TLS/SSL” (เป็นการเข้ารหัสแบบ STARTTLS ซึ่งจะเปิดเองระหว่างเชื่อมต่อ) ส่วน port 465 ให้เปิดสวิตช์ — ตั้งผิดข้อนี้จะค้างจนหมดเวลา และดูเหมือนรหัสผ่านผิดทั้งที่ถูก

รับอีเมลทันทีผ่าน Webhook (ไม่ต้องรอ 2 นาที)

ปกติ CORTEX จะเข้าไปตรวจกล่องจดหมายให้ทุก ๆ 2 นาที ถ้าอยากให้อีเมลเข้าหน้ารวมแชท ทันทีที่ลูกค้ากดส่ง ให้เปิด Webhook รับอีเมล แล้วตั้งให้กล่องจดหมายของคุณส่งต่อ (forward) มาที่ URL นั้น

  1. ไปที่ ตั้งค่าแชทบอท → ช่องทาง แล้วหาการ์ด “รับอีเมลทันทีผ่าน Webhook” ใต้ช่องทางอีเมลของคุณ
  2. กด “สร้าง URL” แล้วคัดลอก URL ที่ได้ (หน้าตาแบบ https://api.cortex-ai.net/api/webhook/email/ewh_…)
  3. เลือกวิธีส่งต่อที่สะดวกจากในการ์ด — มีปุ่มคัดลอกโค้ดสำเร็จรูปให้ทั้ง Cloudflare Email Worker และ Google Apps Script โดยใส่ URL ให้เรียบร้อยแล้ว หรือจะใช้ SendGrid Inbound Parse / Mailgun Routes ก็ได้
  4. ส่งอีเมลทดสอบเข้ามาหนึ่งฉบับ แล้วกลับมาดูสถานะบนการ์ด — ถ้าขึ้นว่า “รับอีเมลได้ปกติ” แปลว่าเชื่อมสำเร็จ และข้อความจะไปโผล่ที่หน้ารวมแชทเหมือน LINE / Facebook ทุกประการ

ข้อควรระวัง: URL นี้คือกุญแจ — ใครถือก็ส่งอีเมลเข้าระบบคุณได้ อย่าเผยแพร่ต่อสาธารณะ ถ้าเผลอหลุดให้กด “สร้าง URL ใหม่” URL เดิมจะใช้ไม่ได้ทันที

CORTEX จะข้ามอีเมลที่ระบบส่งออกไปเอง อีเมลตอบกลับอัตโนมัติ จดหมายข่าว และอีเมลจาก no-reply ให้อัตโนมัติ เพื่อไม่ให้บอทตอบวนกับตัวเอง

แก้ปัญหาที่พบบ่อย

กดทดสอบแล้วขึ้น Invalid credentials
เกือบทุกครั้งคือใส่รหัสผ่านปกติแทน App Password ให้สร้าง App Password ใหม่แล้ววางแบบไม่มีเว้นวรรค
อีเมลเข้ามาแล้วแต่ไม่เห็นในหน้ารวมแชท
รออย่างน้อย 2 นาที (ระบบดึงเป็นรอบ) และตรวจว่า Channel ยังเปิดใช้งาน (Active) อยู่ — อีเมลที่ถูกกรองไปโฟลเดอร์อื่นหรือ Spam จะไม่ถูกดึง
บอทตอบอีเมลตัวเอง / ตอบวนซ้ำ
ระบบอ่านเฉพาะอีเมลที่อยู่ใน INBOX และตัดข้อความที่ถูกอ้างถึงออกก่อนเสมอ ถ้ายังวน ให้ตรวจว่าไม่ได้ตั้ง auto-forward กลับเข้ากล่องเดิม
ปุ่ม “เชื่อมต่อด้วย Gmail (ล็อกอิน Google)” ไม่ขึ้น
แปลว่าเซิร์ฟเวอร์นี้ยังไม่ได้ตั้งค่า Google OAuth ใช้วิธี App Password แทนได้เลย ผลลัพธ์เหมือนกันทุกอย่าง (ผู้ดูแลระบบดูวิธีเปิดได้ที่ docs/email-channel-setup.md)