تنبيهات وتقارير Microsoft Teams

ينشر AutoPSEO الرسائل في Microsoft Teams عبر webhook من Workflows. يمنحك Teams عنوان URL ينشر في قناة واحدة، وتضيف هذا العنوان إلى AutoPSEO بوصفه قناة Teams. بعد ذلك تصلك التنبيهات والتقارير المجدولة ورسائل الاختبار وملخصات التقارير الفردية في صورة Adaptive Cards، بعنوان ملوّن بحسب درجة الخطورة وزر يقودك إلى التقرير. لا تحتاج إلى مساحة عمل Slack، ولا يوجد تطبيق AutoPSEO لتثبيته في Teams.

الحصول على عنوان webhook من Teams

يبني دليل Microsoft لـ incoming webhook العنوان باستخدام تطبيق Workflows:

1. في Teams، انتقل إلى القناة التي ينبغي أن تستقبل البطاقات واختر More options (...) بجوارها.
2. اختر Workflows ثم حدّد قالب webhook. تسمّيه Microsoft حاليًا Send webhook alerts to a channel؛ أما التلميح الظاهر في صفحة إعدادات AutoPSEO فما زال يستخدم الاسم الأقدم: Post to a channel when a webhook request is received.
3. تحقّق من الفريق والقناة اللذين ملأهما القالب، ثم انقر Save.
4. انسخ رابط webhook الذي يعرضه سير العمل.

ما زال العنوان الصادر عن موصّل Incoming Webhook القديم (على webhook.office.com) مقبولًا. وتعمل Microsoft على إيقاف موصّلات Microsoft 365 وستمنع إنشاء موصّلات جديدة، لذا استخدم Workflows في أي إعداد جديد.

إضافة القناة في AutoPSEO

1. في قسم Microsoft Teams ضمن Slack, Teams & Webhooks، انقر New Teams channel. يُفتح النموذج وقد حُدِّدت Microsoft Teams وجهةً.
2. أدخل Name تتعرّف عليه بسهولة والصق العنوان. بالنسبة إلى إدخال Teams، يقبل AutoPSEO عناوين Workflows والموصّلات (مضيفين مثل logic.azure.com وpowerautomate.com وazure-api.net وwebhook.office.com) ويرفض المضيفين الآخرين.
3. انقر Add channel، ثم Send test في صف القناة. ينبغي أن تظهر في القناة بطاقة يحمل عنوانها اسم الإدخال.
4. أنشئ تقريرًا مجدولًا أو تنبيهًا واختر هذه القناة.

ترسل القاعدة الواحدة إلى قناة واحدة. وإذا أردت وصول التنبيه نفسه إلى Slack وTeams، فأنشئ القاعدة مرتين، مرة لكل منهما.

تخطيط البطاقة

تتحول كل رسالة إلى Adaptive Card واحدة (الإصدار 1.4، بعرض كامل)، مُغلَّفة داخل غلاف message مع مرفق application/vnd.microsoft.card.adaptive الذي تستخدمه أمثلة Microsoft نفسها.

• العنوان بخط كبير غامق. تأخذ التنبيهات لون Attention في البطاقة عند الخطورة الحرجة والعالية، ولون Warning عند المتوسطة، واللون الافتراضي عند المنخفضة؛ أما التقارير والاختبارات فتستخدم لون Accent.
• الملخص: الجملة نفسها التي تحملها رسالة Slack، مع النطاق الزمني.
• الحقائق: حتى 12 قيمة موسومة، مثل النقرات ونسبة تغيّرها، أو القيمة الحالية للتنبيه مقابل خط الأساس.
• الجدول: في التقارير وملخصات التقارير، حتى عشرة صفوف بخط ثابت العرض.
• التذييل: الموقع، وتذكير بأن بيانات Search Console تتأخر نحو يوم وبأن الأيام المستقرة وحدها هي التي تُحتسب، ثم المُرسِل.
• Open report: زر يقود إلى التقرير المطابق في AutoPSEO.

أسباب عدم وصول البطاقة

يبلّغ Send test عن الفشل فورًا؛ أما الرسائل المجدولة فيحتفظ Delivery history بالرد الذي أعاده Teams.

لا يُعاد إرسال التقرير المجدول الفاشل ضمن الفترة نفسها: عالج السبب ثم استخدم Send now.

متى تستخدم webhook بدلًا من ذلك

يمكن لـ Teams وwebhooks الصادرة أن تحملا القواعد نفسها، لكنهما تخدمان قارئَين مختلفين. قناة Teams مخصصة للأشخاص: بطاقة منسّقة دون أي بناء. أما webhook فمخصص للبرمجيات: الحدث الخام في صورة JSON موقَّع إلى Zapier أو Make أو n8n أو خدمتك الخاصة. يتوقع Teams بطاقة لا JSON الحدث الخاص بـ AutoPSEO، لذا يندرج عنوان Teams دائمًا تحت Microsoft Teams.

تجد نظرة عامة على ما يحصل عليه مستخدمو Teams في صفحة Microsoft Teams.