SuperMailbox · คู่มือเชื่อมต่อ CRM

เชื่อมต่อ SuperMailbox กับ CRM ของคุณ

ผู้ใช้ CRM แต่ละคนสามารถเชื่อมต่ออย่างปลอดภัยด้วย OAuth กับกล่องจดหมายที่เลือก CRM ค้นหาการสนทนากับลูกค้า แสดงบริบทอีเมลที่ตรวจสอบแล้ว และร่างหรือส่งคำตอบผ่าน MCP server ของ SuperMailbox ได้

วิธีการเชื่อมต่อ

01

เชื่อมต่อกล่องจดหมาย

ผู้ใช้เชื่อม Gmail, Outlook หรือกล่องจดหมายอื่นที่รองรับเข้ากับ SuperMailbox การเข้าสู่ระบบผู้ให้บริการอีเมลแยกจากการอนุญาต CRM

02

อนุญาต CRM

CRM เปิด OAuth ของ SuperMailbox ในเบราว์เซอร์ ผู้ใช้เข้าสู่ระบบ ตรวจชื่อไคลเอนต์และสิทธิ์ที่ร้องขอ แล้วอนุมัติการเชื่อมต่อ

03

ใช้เครื่องมือ MCP

CRM เรียก MCP server ระยะไกลด้วย access token ของผู้ใช้ ผู้ใช้เลือกกล่องจดหมายที่อนุญาต แล้ว CRM ทำงานภายในสิทธิ์นั้น

การตั้งค่าการเชื่อมต่อ

ใช้ MCP client หรือ SDK ที่รองรับ Streamable HTTP ระยะไกลและการค้นหาข้อมูล OAuth โดยไคลเอนต์จะจัดการการอนุญาตผ่านเบราว์เซอร์และส่ง access token ไปกับคำขอ MCP

URL ของ MCP server
https://api.supermailbox.app/mcp
การอนุญาต
OAuth 2.0 · Authorization Code · PKCE S256
สิทธิ์ที่ร้องขอ
openid email mail.accounts.read mail.messages.read mail.send

ขอเฉพาะสิทธิ์ที่เวิร์กโฟลว์ต้องใช้ CRM ที่อ่านอีเมลลูกค้าและส่งคำตอบอาจร้องขอ:

ค้นหาและตรวจสอบการสนทนา

  • เรียก list_mail_accounts เพื่อให้ผู้ใช้เลือกกล่องจดหมายที่ใช้ได้ canSend เป็นเพียงข้อมูลแนะนำ ระบบตรวจสิทธิ์ส่งอีกครั้งเมื่อดำเนินการจริง
  • ค้นหาด้วย search_emails หรือ search_threads_by_recipient การค้นหาตามผู้รับส่งคืนเฉพาะ metadata ให้ดึงและตรวจสอบ thread ที่เลือกก่อนผูกกับระเบียน CRM
  • ผลการค้นหาอาจมีขอบเขตจำกัดหรือไม่ครบถ้วน ตรวจดู coverage และ completeness ผลว่างที่ไม่ครบถ้วนไม่ได้ยืนยันว่าไม่มีอีเมล
  • ID ของกล่องจดหมาย ข้อความ และ thread เป็นรหัสที่อ่านความหมายไม่ได้และผูกกับสิทธิ์ของผู้ใช้ปัจจุบัน ค้นหาและตรวจสอบผ่านการเชื่อมต่อของผู้ใช้คนเดิม

เตรียมและส่งคำตอบอย่างปลอดภัย

  • ก่อนยืนยันส่ง ให้แสดงกล่องจดหมาย ผู้รับ และเนื้อหาคำตอบที่เลือกใน CRM
  • send_email และ reply_to_email จะคืนงานที่เข้าคิว ตรวจสอบ get_mail_action ด้วย operation ID เดิมและสิทธิ์ที่ต้องใช้จนกว่าจะได้สถานะสุดท้าย
  • การตอบรับเข้าคิวไม่ได้ยืนยันการส่งสำเร็จ หากสถานะไม่แน่ชัดให้ตรวจงานเดิม และอย่าส่งซ้ำอัตโนมัติด้วย ID ใหม่

ความปลอดภัยและการควบคุมการเข้าถึง

  • ใช้ OAuth authorization-code พร้อม PKCE S256 ผ่านการค้นหาที่ MCP client รองรับ เก็บ secret และ token ไว้บนเซิร์ฟเวอร์ ห้ามเปิดเผยในโค้ดเบราว์เซอร์หรือ log
  • สร้างการเชื่อมต่อแยกสำหรับผู้ใช้ CRM แต่ละคน ห้ามแชร์ token หรือ ID กล่องจดหมายของผู้ใช้หนึ่งให้ผู้ใช้อื่น
  • ขอ mail.send เฉพาะเมื่อ CRM จำเป็นต้องส่งอีเมล ผู้ใช้เพิกถอนการเชื่อมต่อ CRM ได้จากการตั้งค่าแอปที่เชื่อมต่อใน SuperMailbox