Teams Connectors وWebhooks: حالة الإيقاف وكيفية استبدالها بسير العمل (Workflows)
By Mirko Peters ·
توقفت Office 365 connectors وconnector-based incoming webhooks في Teams عن العمل في مايو 2026. يغطي هذا الدليل ما توقف عن العمل، وما الذي يحل محله، وكيفية الترحيل، وأوجه الاختلاف التي لا تزال قائمة في Workflows.
Automatically translated with AI from the original post. Read the English original
لم تعد موصلات Teams، بما في ذلك موصل Incoming Webhook، متاحة. تنص Microsoft Learn على أن Office 365 connectors في Teams أُوقفت في مايو 2026، وأن الطريقة الحالية لاستقبال طلبات webhook والنشر في Teams هي تطبيق Workflows. يحل سير عمل مبني على المشغّل When a Teams webhook request is received محل عنوان URL القديم للموصل.
النقاط الرئيسية
- وفقًا لـ Microsoft Learn، أُوقفت Office 365 connectors في Teams، بما في ذلك incoming webhooks المعتمدة على connector، في مايو 2026. وكانت نافذة الطرح النهائية في مدونة المطورين من 18 إلى 22 مايو 2026.
- البديل هو تطبيق Workflows في Teams، وهو مبني على Power Automate. استخدم المشغّل When a Teams webhook request is received أو قالبًا جاهزًا.
- لكل سير عمل عنوان webhook خاص به، لذا يجب تحويل كل نظام مُرسِل إليه، لأن عنوان URL القديم للموصل لم يعد يعمل.
- تُعرض حمولات MessageCard، لكن أزرار HttpPost الخاصة بها لا تعمل. استخدم Adaptive Cards للمحتوى التفاعلي.
- تتبع سير العمل مالكًا محددًا، لا قناةً. أضف مالكين مشاركين حتى لا يصبح سير العمل بلا مالك عند مغادرة مالكه.
يشرح هذا المقال ما الذي أُوقف، وما الذي يحل محله، وكيفية الانتقال، وأي الفروق ما زالت قد تسبب مشكلات.
ما الذي أُوقف ومتى
استمر إيقاف الموصلات لما يقارب عامين، وتغير التاريخ عدة مرات. توثق مدونة Microsoft 365 للمطورين التسلسل الزمني:
- يوليو 2024: الخطة الأولى لحظر الموصلات الجديدة اعتبارًا من 15 أغسطس 2024، وإيقاف جميع الموصلات في 1 أكتوبر 2024.
- يوليو 2024: تأجيل الإيقاف إلى ديسمبر 2025.
- أكتوبر 2025: نُقل الموعد النهائي للترحيل إلى 31 مارس 2026.
- فبراير 2026: أُضيف دعم Message Card إلى Workflows، وأصبح بإمكان روبوت Workflows النشر في القنوات المشتركة. ونُقل الموعد النهائي إلى 30 أبريل 2026.
- 14 أبريل 2026 (التحديث الأخير): يبدأ الطرح في 18 مايو 2026 ويكتمل في 22 مايو 2026. بعد ذلك لن تعمل الموصلات.
تشمل العناصر المتأثرة Office 365 connectors في Teams، بما فيها الموصلات المعتمدة على webhook مثل Incoming Webhook والموصلات الخارجية التي تنشر إلى عنوان URL. وتشير المدونة إلى أن تغيير عنوان webhook ينطبق على الموصلات المعتمدة على webhook، وليس على الموصلات القائمة على الاستطلاع (polling) مثل RSS.
إذا كان هناك شيء ما زال ينشر عبر موصل قديم، فاعتبره معطلًا أو على وشك التعطل، وخطط للترحيل الآن.
ما الذي يحل محل الموصلات
تسمي Microsoft ثلاثة مسارات في Learn:
- تطبيق Workflows (Power Automate) لـ incoming webhooks. استخدم قالبًا جاهزًا أو المشغّل When a Teams webhook request is received.
- موصّل Power Automate لمزوّدي البرامج المستقلين (ISVs) وفرق المنتجات. تصفه Learn بأنه الطريقة القابلة للتوسع والآمنة لنقل البيانات إلى Teams ومنه برمجيًا.
- تطبيق Teams مع رسائل استباقية، بحيث يمكن للمستخدمين إعداد رسائل استنادًا إلى أحداث الإطلاق في نظامك.
بالنسبة لمعظم مسؤولي النظام وكاتبي النصوص البرمجية، يُعد المسار 1 الاستبدال المباشر.
كيفية ترحيل Webhook إلى Workflows
تعذّر الوصول إلى صفحة الدعم الخاصة بـ Microsoft حول Webhooks الواردة وقت إعداد هذه المقالة، لذا تتبع الخطوات التالية مدونة المطورين ومرجع موصّل Learn.
- اسرد كل موصّل قيد الاستخدام. تحقّق من القنوات التي استخدمت إدارة القناة > الموصّلات، والأنظمة التي ترسل التنبيهات، مثل أدوات المراقبة أو البناء أو التذاكر.
- في Teams، افتح تطبيق Workflows. تذكر مدونة المطورين أنه يمكنك فتحه أيضًا من محادثة أو قناة عبر خيارات إضافية (...).
- اختر قالب Webhook محدّدًا مسبقًا، أو ابدأ من الصفر بالمشغّل عند استلام طلب Webhook من Teams.
- اختر الفريق والقناة، ثم احفظ، وانسخ عنوان URL للمشغّل من سير العمل في Power Automate.
- استبدل عنوان URL للموصّل القديم في النظام المرسِل بالعنوان الجديد.
- سمِّ سير العمل وصِفه واختبره، وأضف المالكين المشاركين.
- أرسل طلب POST تجريبيًا وتحقّق من ظهور الرسالة.
يقبل المشغّل طلبات POST فقط. يذكر مرجع موصّل Learn أن طلبات GET غير مدعومة.
تنسيق الحمولة والبطاقات
يمكن أن يحتوي نص المشغّل على مصفوفة من البطاقات التكيفية (Adaptive Cards). يوضح المرجع رسالة تحتوي على مصفوفة attachments حيث تكون قيمة contentType هي application/vnd.microsoft.card.adaptive. كما يُقبل نص Message Card منفرد.
ضع في اعتبارك النقاط التالية:
- البطاقات التكيفية هي الطريقة المدعومة لبناء المحتوى التفاعلي.
- تُعرض حمولات MessageCard، لكن الأزرار التي تستخدم HttpPost لا تعمل. تنص مدونة المطورين على الانتقال إلى البطاقات التكيفية إذا كنت تستخدم عناصر بطاقات تفاعلية.
التحكم في الوصول
تحسين حقيقي واحد: يملك المشغّل إعداد مصادقة. تسرد Learn ثلاثة خيارات.
| الإعداد | ما يجب على المرسِل فعله | |---|---| | أي شخص | عدم إرسال ترويسة رمز المصادقة، وإلا يفشل الطلب | | أي مستخدم في مستأجري | إرسال رمز مصادقة | | مستخدمون محددون في مستأجري | إرسال رمز مصادقة، ويجب أن يكون المستخدم في قائمة المسموح لهم |
بالنسبة لخيارات المستأجر، تُحيل Learn إلى دليلها حول مصادقة OAuth لمشغّلات طلبات HTTP. إذا كانت الأداة لا تستطيع سوى إرسال طلب POST عادي إلى عنوان URL، فإنها تحتاج إلى الإعداد "أي شخص". عندئذٍ تعامل مع عنوان URL كسر.
الفروق عن الموصّل القديم
خطّط لهذه النقاط قبل التحويل النهائي.
- هوية المرسِل. يذكر تحديث مدونة المطورين الصادر في أبريل 2026 أن تخصيص أيقونة الروبوت واسمه غير متاح لرسائل Webhook. تظهر الرسائل بهوية الروبوت الافتراضية لـ Workflows.
- الملكية. تذكر Learn أن سير العمل مرتبط بالمالكين، وليس بفريق أو قناة. إذا غادر المالك ولم يكن هناك مالك مشارك، فقد يصبح التدفق بلا مالك. أضف مالكين مشاركين بصلاحيات كاملة.
- الحدود. يذكر مرجع Learn نحو 1,000 استدعاء وارد متزامن للمشغّل، وحدًا قدره 28 كيلوبايت لإجراء نشر البطاقة التكيفية في محادثة أو قناة. الحمولات الأكبر تُرجع خطأ "Request Entity too large".
- القنوات الخاصة. المصادر غير متفقة. تقول مدونة المطورين إن اختيار القنوات الخاصة في تطبيق Workflows كان مقررًا لطرحه بالكامل بحلول 20 أبريل 2026، وتذكر إحدى صفحات Learn أن Webhooks الخاصة بـ Workflows تدعم القنوات الخاصة، بينما تصف صفحة Learn أخرى دعم القنوات الخاصة بأنه قيد التطوير. ولا يزال مرجع موصّل Microsoft Teams يذكر أن نشر رسالة أو بطاقة في قناة خاصة غير مدعوم حاليًا. اختبر القناة المستهدفة قبل الاعتماد عليها.
الأخطاء الشائعة
- ترحيل القناة فقط ونسيان تغيير عنوان URL في النظام المرسِل.
- ترك شخص واحد كمالك وحيد لسير العمل.
- إرسال رمز مصادقة إلى مشغّل مضبوط على "أي شخص".
- الإبقاء على أزرار MessageCard وتوقّع أن تعمل عمليات الاستدعاء.
- الافتراض بأن اسم الروبوت القديم وأيقونته سينتقلان تلقائيًا.
ذات صلة
المصادر
- إيقاف موصّلات Office 365 داخل Microsoft Teams (مدونة مطوّري Microsoft 365)
- إنشاء موصلات Office 365 لـ Teams (Microsoft Learn)
- إيقاف موصلات Microsoft 365 والموصلات المخصصة في Teams (Microsoft Learn)
- مرجع موصل Microsoft Teams لـ Power Automate (Microsoft Learn)
FAQ
هل ما زالت موصلات Teams تعمل؟
لا. تنص وثائق Microsoft Learn على أن Office 365 connectors في Teams، بما في ذلك incoming webhooks المعتمدة على connector، أُوقفت في مايو 2026. وذكرت مدونة Microsoft 365 للمطورين أن نافذة الطرح النهائية كانت من 18 مايو إلى 22 مايو 2026، وأنه كان يجب ترحيل الـ webhooks قبل بدء هذه النافذة.
ما الذي يحل محل موصل Incoming Webhook في Teams؟
تطبيق Workflows، الذي يعمل على Power Automate. وفقًا لوثائق Microsoft Learn، يمكنك إما استخدام قالب جاهز ينشر في دردشة أو قناة عند استلام طلب webhook، أو بناء تدفق من الصفر باستخدام المشغّل When a Teams webhook request is received.
هل أحتاج إلى عنوان URL جديد لأداة المراقبة أو للبرنامج النصي الخاص بي؟
نعم. لكل سير عمل عنوان URL خاص بالمشغّل، ويصف مرجع الموصل المشغّل بأنه يبدأ عند إرسال طلب POST إلى هذه النقطة. الصفحات التي اطلعت عليها لا توضح أين يُعرض عنوان URL، لذا افتح مشغّل سير العمل في Power Automate لنسخه. ثم الصقه في النظام الذي يرسل طلب POST.
هل يمكن لـ webhook الخاص بـ Workflows أن ينشر أزرارًا تستدعي نظامي مرة أخرى؟
ليس باستخدام MessageCard. تقول مدونة المطورين إن MessageCard يعرض المحتوى لكنه لا يدعم أزرار الإجراء HttpPost. وللعناصر التفاعلية، توصي Microsoft باستخدام Adaptive Cards، وتنص Learn على أن عليك ضبط سير العمل للتعامل مع الردود.
من يمكنه إرسال طلبات إلى webhook سير العمل؟
أنت تختار. يسرد مرجع موصل Microsoft Teams في Learn ثلاثة خيارات: أي شخص، أو أي مستخدم في المستأجر، أو مستخدمون محددون في المستأجر. بالنسبة لخيارات المستأجر، يجب أن تحمل الطلبات رمز مصادقة. أما بالنسبة لخيار Anyone، فلا يجب إرسال أي رمز.