قاعدة المعرفة
الموصّلات
اربط التطبيقات التي تعمل عليها، ليتمكن المساعد من البحث فيها والتصرف داخلها.
التفاصيل
- الموصّل يربط تطبيقًا خارجيًا بالمساعد، ليتمكن من البحث فيه والتصرف داخله. يمكن ربط Slack وNotion وGoogle Drive وHubSpot ونحو ألف تطبيق آخر. «ابحث عن العرض في Drive وأخبرني بما يقوله عن الأسعار.» «انشر هذا التحديث في قناة المبيعات.» تجد الموصّلات تحت الموصّلات في الشريط الجانبي.
- لربط تطبيق، اختره من القائمة، وحدّد لمن هو وما يُسمح للمساعد بفعله، ثم أكمل الربط في صفحة تسجيل الدخول الخاصة بالتطبيق، أو الصق هناك مفتاحًا من التطبيق. لا تمرّ كلمة المرور أو المفتاح أبدًا عبر محادثة OpenEmail أو API الخاصة به أو المساعد. يبقى الموصّل معلّقًا حتى تنتهي، ثم يصبح نشطًا.
- الموصّل يكون لك وحدك أو لمساحة العمل كلها، ويُسمح للمساعد إما بالبحث عبره فقط أو بإجراء تغييرات أيضًا. يمكنك تغيير ذلك لاحقًا، وإيقاف الموصّل مؤقتًا ثم استئنافه. والفصل يُلغي الوصول داخل التطبيق الخارجي أيضًا. وإذا توقف التطبيق عن قبول الاتصال، يطلب الموصّل إعادة ربطه، ويعيده رابط جديد بوصفه الموصّل نفسه.
- في المحادثة يرى المساعد ما هو مرتبط، ويجد الإجراء المناسب في التطبيق، ويقرأ فورًا. أما كل ما يغيّر شيئًا في التطبيق، مثل إرسال رسالة أو إنشاء سجل أو تحديثه أو الحذف، فيعرض له أولًا بطاقة لتوافق عليها، حتى لو طلبته أنت مباشرة. والموصّل المخصص للبحث فقط يرفض التغييرات، وما يعيده التطبيق يُعامَل بوصفه معلومات، لا بوصفه تعليمات أبدًا.
- لا تستخدم المهمة الموصّلات إلا إذا كان خيار الموصّلات مفعّلًا تحت «أدوات إضافية» الخاصة بها، ولا تستخدم إلا الموصّلات المرتبطة لمساحة العمل، لا موصّلًا يخص شخصًا واحدًا أبدًا. تقرأ بمفردها. وكل تغيير في تطبيق ينتظر تحت «بانتظارك»، أيًّا كان ما يحق للمهمة فعله بمفردها في غير ذلك، والمهمة التي تستخدم الموصّلات لا ترد على البريد بمفردها أبدًا: كل رد ينتظر موافقتك.
- كل طلب يُجرى عبر موصّل يُسجَّل لمدة 90 يومًا: متى، وأي تطبيق وأي إجراء، وهل قرأ أم غيّر شيئًا، وهل نجح، وهل جاء من محادثة أم مهمة أم API أم وكيل. أما ما أُرسل إلى التطبيق وما عاد منه فلا يحتفظ بهما OpenEmail أبدًا.
- ثلاث صلاحيات تحدد من يفعل ماذا: واحدة لرؤية الموصّلات وما جرى عبرها، وواحدة لجعل المساعد يستخدمها، وواحدة لربط التطبيقات وإيقافها مؤقتًا وفصلها وتحديد ما يُسمح للمساعد بفعله. يملك المالكون والمشرفون الصلاحيات الثلاث كلها، ويملك Member الأولى والثانية، ويملك Viewer الأولى. ومن يحق له ربط تطبيق يستطيع ربطه لنفسه أو لمساحة العمل.
- تتسع الخطة لموصّلين اثنين في Free، و10 في Starter، و50 في Business للحساب، ولعدد مماثل لمساحة العمل. ولا تضع Enterprise حدًّا خاصًّا بها، ولا يتسع أي حساب أو مساحة عمل لأكثر من 200. وعندما تنتقل مساحة العمل إلى خطة أصغر، تُوقَف مؤقتًا أحدث الموصّلات التي تتجاوز الحد، ولا تُزال.
- الاتصالات يحتفظ بها مزوّد خارجي، وهو يحتفظ أيضًا بسجل لما يرسله المساعد إلى التطبيق وما يجيب به التطبيق، مدة تصل إلى سنة. وهو مذكور في صفحة سياسة الخصوصية.
- الموصّلات متاحة في REST API تحت /connectors و/connector-apps و/connector-categories و/connector-calls، وفي كل SDK باسم connectors، وفي سطر الأوامر باسم openemail connectors، وعلى خادم MCP. عبر API يُنفَّذ التغيير فورًا دون سؤال أحد، فالقرار للمستدعي. وثلاثة أحداث webhook تُعلم أنظمتك عندما يُربط موصّل تابع لمساحة العمل أو يُفصل أو يحتاج إلى إعادة الربط.
ربط تطبيق
يستغرق الربط دقيقة، ويجري تسجيل الدخول في صفحة التطبيق نفسه.
- افتح الموصّلات في الشريط الجانبي وابحث عن التطبيق تحت تبويب تصفّح، باسمه أو بحسب الفئة.
- اختر لمن يكون الموصّل: أنت فقط، أو مساحة العمل كلها.
- اختر ما يُسمح للمساعد بفعله عبره: البحث فقط، أو إجراء تغييرات أيضًا.
- أكمل الربط في صفحة تسجيل الدخول الخاصة بالتطبيق، أو الصق هناك مفتاحًا من التطبيق. يبقى الموصّل معلّقًا حتى تنتهي، ثم يصبح نشطًا.
- لا تمرّ كلمة مرورك أو مفتاحك للتطبيق أبدًا عبر محادثة OpenEmail أو API الخاصة به أو المساعد.
- عندما يتوقف تطبيق عن قبول الاتصال، يذكر الموصّل أنه يحتاج إلى إعادة الربط. ويعيده رابط جديد بوصفه الموصّل نفسه، فتواصل المهام التي تستخدمه عملها.
- أوقف الموصّل مؤقتًا لتمنع المساعد من استخدامه، واستأنفه عندما تريده من جديد.
- الفصل يزيل الموصّل ويُلغي أيضًا الوصول الذي كان له داخل التطبيق الخارجي.
- يمكن إيقاف الموصّلات للخدمة كلها. وعندئذ تُخفى الصفحة.
من يستطيع فعل ماذا
| الصلاحية | ما تتيحه |
|---|---|
| connectors:read | رؤية الموصّلات وما جرى عبرها |
| connectors:use | جعل المساعد يبحث ويُجري تغييرات عبرها |
| connectors:write | ربط التطبيقات وإيقافها مؤقتًا وفصلها، وتحديد ما يجوز للمساعد فعله فيها |
- يملك المالكون والمشرفون الصلاحيات الثلاث كلها. ويملك الدور المدمج Member الصلاحيتين
connectors:readوconnectors:use، ويملك Viewer الصلاحيةconnectors:read. - الصلاحية نفسها تشمل نوعَي الموصّلات كليهما: من يحق له ربط تطبيق يستطيع ربطه لنفسه أو لمساحة العمل.
من الشيفرة والطرفية والوكلاء
الموصّلات متاحة في REST API تحت /connectors و/connector-apps و/connector-categories و/connector-calls، وفي كل SDK وفي CLI تحت connectors، وفي أدوات MCP التي يستخدمها المساعد أيضًا.