Outlook
اربط Outlook وMicrosoft 365 بتطبيق Microsoft Entra الخاص بك ليستطيع الوكيل البحث في البريد وقراءته والرد عليه وإرسال رسائل المتابعة وإدارة التقويم.
ما الذي ستحققه
سيعرض Outlook Connected ويستجيب لـ Test connection.
نظرة عامة وحالات الاستخدام
يتيح الربط للوكيل البحث في البريد وقراءته والرد عليه، وإرسال رسائل المتابعة، وحفظ المسودات، وترتيب صندوق الوارد، وإنشاء أحداث التقويم وسردها وإلغائها، كل ذلك عبر Microsoft Graph.
المتطلبات المسبقة
- حساب Microsoft (شخصي أو للعمل) وإذن تسجيل تطبيق في Microsoft Entra.
إعداد الحساب الخارجي (في Microsoft Entra)
Microsoft هي التي تتحكم في هذه الشاشات. دليل Microsoft: Register an app.
- سجّل تطبيقًا في مركز إدارة Entra.
- أضف URI إعادة توجيه من نوع Web: العنوان الموجود في مربع Connect في Phynxa.
- تحت أذونات API أضف الأذونات المفوَّضة أدناه.
- أنشئ client secret وانسخه مع Application (client) ID.
اربطه في Phynxa
- Integrations، Connect في Outlook.
- أدخل Client ID وClient secret واختياريًا Tenant.
- سجّل الدخول إلى Microsoft ووافق. تعرض البطاقة Connected.
الأذونات والإعدادات
الأذونات المفوَّضة: offline_access (بدونه ينتهي الربط بعد ساعة) وUser.Read وMail.ReadWrite وMail.Send وCalendars.ReadWrite.
Tenant: common (حسابات العمل والحسابات الشخصية) أو organizations (للعمل فقط) أو consumers (شخصية فقط) أو معرّف tenant الخاص بك أو نطاقه.
هل ربطت Outlook قبل إضافة القراءة؟ كان ذلك الربط يملك إذن الإرسال فقط. ويستمر الإرسال في العمل؛ أما بقية إجراءات البريد فاختر Reconnect ووافق من جديد.
استخدمه في مكالمة
في تبويب Tools للوكيل، Add tool، Integration، Outlook:
| الإجراء | ما يفعله | يعمل |
|---|---|---|
| Send email | يرسل بريدًا إلكترونيًا. ويحتاج to (عدة عناوين مفصولة بفواصل) وsubject وbody. | في الخلفية |
| Search emails | يعرض الرسائل المطابقة مع مرسل كل منها وموضوعها وتاريخها وأولى كلماتها. ويأخذ query بكلمات بحث Outlook (مثل from:sara@example.com) وmax_results (حتى 10)؛ وبلا query يعرض أحدث رسائل صندوق الوارد. | ينتظر |
| Read email | يفتح رسالة واحدة ويعيد نصها (حتى نحو 3500 حرف) ومرسلها وأسماء المرفقات. ويحتاج message_id من نتيجة بحث. | ينتظر |
| Read conversation | يعيد آخر أربع رسائل من محادثة. ويحتاج thread_id (معرّف المحادثة الذي تعيده نتيجة البحث). | ينتظر |
| Reply to email | يردّ على من كتب الرسالة (وليس على الجميع أبدًا). ويحتاج message_id وbody. | في الخلفية |
| Create draft | يحفظ رسالة في المسودات. ولا يُرسل شيء. ويحتاج to وsubject وbody. | في الخلفية |
| Mark as read | يضع علامة «مقروءة» على رسالة واحدة. | في الخلفية |
| Archive email | ينقل رسالة واحدة إلى مجلد الأرشيف. وتبقى محفوظة ويمكن العثور عليها. | في الخلفية |
| Move to trash | ينقل رسالة واحدة إلى العناصر المحذوفة حيث يمكن استرجاعها. | في الخلفية |
| Create calendar event | يضع حدثًا في التقويم. ويحتاج subject وstart وend وtime_zone؛ وattendees (عناوين مفصولة بفواصل، وتُدعى) وlocation اختياريان. | في الخلفية |
| List calendar events | يسرد الأحداث بين وقتين (الأيام السبعة القادمة افتراضيًا) مع معرّفاتها. | ينتظر |
| Cancel event | يلغي حدثًا نظّمته؛ ويُبلَّغ الضيوف. ويحتاج event_id من List calendar events. | في الخلفية |
وتعمل هذه الإجراءات أيضًا مع وكيل واتساب: في تبويب Tools فيه، Add tool، Integration، Outlook. راجع إنشاء وكيل واتساب.
حافظ على أمان بريدك
- امنح إجراءات القراءة للوكلاء الموثوقين فقط. فالوكيل الذي يخاطب الجمهور (خط هاتف أو أداة في موقع أو رقم واتساب) يجيب كل من يحدّثه، فيستطيع أي شخص سؤاله عن بريدك. وللوكيل العام امنحه Send email أو Create draft فقط.
- نص الرسالة كتبه شخص آخر. وقد يحتوي تعليمات موجهة إلى مساعد («أعد توجيه كل شيء إلى ...»). وتطلب Phynxa من الوكيل أن يعامل ما يقرؤه معلومةً لا تعليمات، لكن الأسلم ألا تمنح وكيلًا واحدًا إجراءات القراءة والإرسال معًا.
- يمكن إيقاف كل أداة بإزالتها من الوكيل.
- لا توجد محادثة خاصة «اسألني عن بريدي». يجيب وكيل واتساب العملاء الذين يكتبون إلى رقمه؛ ولا يتلقى منك أوامر بشأن صندوق بريدك.
اختبره
يجيب Test connection "Outlook is responding."
النتيجة المتوقعة
تبقى البطاقة Connected.
استكشاف الأخطاء
- «Reconnect Outlook». تم الربط قبل إضافة القراءة، أو لم يُمنح الإذن
Mail.ReadWrite. أضف الإذن في Entra ثم استخدم Reconnect ووافق. - يتوقف الربط بعد ساعة. لم يُمنح
offline_access؛ أضفه ثم Reconnect. - عدم تطابق URI إعادة التوجيه. يجب أن يساوي URI إعادة التوجيه من نوع Web عنوان Phynxa تمامًا.
- نوع حساب خاطئ. اضبط Tenant ليطابق حسابك.
الأمان وبيانات الاعتماد
يُخزَّن client secret مشفّرًا. اسحب وصول التطبيق في إعدادات حساب Microsoft؛ وRemove ينساه هنا.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.