اربط SuperMailbox بنظام CRM لديك
يحصل كل مستخدم في CRM على اتصال OAuth آمن بصناديق البريد التي يختارها. يستطيع CRM العثور على محادثات العملاء وعرض سياق البريد المتحقق منه وإعداد الردود أو إرسالها عبر خادم MCP الخاص بـ SuperMailbox.
طريقة عمل الاتصال
اربط صندوق البريد
يربط المستخدم Gmail أو Outlook أو صندوق بريد آخر مدعوماً بـ SuperMailbox. تسجيل الدخول لدى مزود البريد منفصل عن تفويض CRM.
فوّض CRM
يفتح CRM صفحة OAuth الخاصة بـ SuperMailbox في المتصفح. يسجل المستخدم الدخول ويراجع اسم العميل والصلاحيات المطلوبة ثم يوافق على الاتصال.
استخدم أدوات MCP
يستدعي CRM خادم MCP البعيد باستخدام رمز وصول المستخدم. يختار المستخدم صندوق بريد مصرّحاً به ويعمل CRM ضمن ذلك التفويض.
إعدادات الاتصال
استخدم عميل MCP أو SDK يدعم Streamable HTTP البعيد واكتشاف OAuth. يجب أن يدير تفويض المتصفح ويرسل رمز الوصول مع طلبات MCP.
- عنوان خادم MCP
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. يعيد البحث حسب المستلم بيانات وصفية فقط؛ اجلب المحادثة المختارة وتحقق منها قبل ربطها بسجل CRM.
- قد تكون النتائج محدودة أو غير مكتملة. راعِ حقلي coverage وcompleteness؛ فالنتيجة الفارغة غير المكتملة لا تثبت عدم وجود رسالة.
- معرفات الحسابات والرسائل والمحادثات مبهمة ومرتبطة بتفويض المستخدم الحالي. ابحث عنها وتحقق منها ضمن اتصال المستخدم نفسه.
أعد الردود وأرسلها بأمان
- اعرض صندوق البريد والمستلم ونص الرد المختار في CRM قبل تأكيد الإرسال.
- يعيد send_email وreply_to_email عملية في قائمة الانتظار. استعلم عن get_mail_action باستخدام معرّف العملية نفسه والصلاحيات اللازمة حتى ظهور حالة نهائية.
- إشعار الإدراج في القائمة لا يثبت التسليم. عند غموض الإرسال، تحقق من العملية نفسها ولا تعاود الإرسال تلقائياً بمعرّف جديد.
الأمان والتحكم في الوصول
- استخدم تدفق OAuth authorization-code مع PKCE S256 عبر اكتشاف عميل MCP المدعوم. خزّن الأسرار والرموز على الخادم ولا تكشفها في كود المتصفح أو السجلات.
- أنشئ اتصالاً مستقلاً لكل مستخدم CRM. لا تشارك رمز أو معرف صندوق بريد مستخدم مع مستخدم آخر.
- اطلب mail.send فقط إذا كان CRM يحتاج إلى إرسال البريد. يمكن للمستخدم إلغاء اتصال CRM من إعدادات التطبيقات المتصلة في SuperMailbox.

