دليل خطوة بخطوة: إنشاء أول Adaptive Card في MS Teams

By Mirko Peters · 2026-08-12 · Updated 2026-08-29

مرحبًا بعودتكم إلى المدونة! إذا شعرتم يومًا بالإرهاق الشديد من التنبيهات المستمرة للدردشة، ورسائل القنوات، والتحذيرات الآلية، فأنتم على الأرجح…

Automatically translated with AI from the original post. Read the English original

أهلاً بعودتك إلى المدونة! إذا سبق لك أن شعرت بالإرهاق من التنبيهات المستمرة للدردشة والرسائل في القنوات والتحذيرات الآلية، فأنت بالتأكيد لست وحدك. يتعامل العاملون في المعرفة اليوم مع حجم هائل من المعلومات، وقد يتلقون عشرات التنبيهات في كل ساعة. هذا التدفق المتواصل يشتت تركيزنا، ويفرض علينا التنقل المستمر بين المهام، ويتركنا مرهقين ذهنياً في نهاية اليوم. وفي حلقتنا البودكاست، Build Actionable Teams Notifications with Adaptive Cards، استكشفنا كيف يمكنك تغيير طريقة تواصلك بالكامل، وذلك بالتخلي عن التنبيهات الثابتة غير المجدية واستبدالها برسائل ذكية وتفاعلية.

نواصل اليوم هذا الحديث بأسلوب عملي. سيرشدك هذا الدليل خلال خطوات بناء أول Adaptive Card لك في Microsoft Teams. سواء كنت تسعى إلى تسريع الموافقات الداخلية، أو بث تنبيهات الحوادث الحرجة، أو ببساطة جعل سير العمل اليومي لفريقك أكثر سلاسة، فإن إتقان Adaptive Cards يُعد من أكثر المهارات أثراً التي يمكنك تطويرها في منظومة Microsoft 365. هيا نبدأ مباشرة ونستعرض ما يلزم للبدء.

فهم الأساسيات: لماذا تفشل الإشعارات التقليدية

قبل الشروع في البناء، من المفيد أن نفهم المشكلة الجوهرية التي نسعى إلى حلها. تخبرك معظم الإشعارات القياسية في Microsoft Teams بأن شيئاً ما قد حدث، لكنها لا تمنحك طريقة مباشرة للرد. تخيّل أنك تلقيت تنبيهاً يفيد بأن أمر شراء جديداً يتطلب موافقتك. مع إشعار نصي عادي، عليك قراءة التنبيه، ثم فتح متصفح الويب، وتسجيل الدخول إلى تطبيق أعمال منفصل، والانتقال إلى السجل المحدد، وأخيراً النقر على "Approve".

هذه الرحلة متعددة الخطوات تُفقدك تركيزك وتستهلك دقائق ثمينة. اضرب هذا الانقطاع في ستين مرة كل ساعة، وستجد إنتاجيتك تتلاشى. تحل Adaptive Cards هذه المشكلة بنقل واجهة التطبيق مباشرة داخل نافذة الدردشة. فهي تتيح لك قراءة البيانات، وملء حقول النماذج، والنقر على أزرار الإجراءات دون مغادرة عميل Teams. لكن لتنفيذ هذه البطاقات بنجاح، تحتاج إلى فهم الأدوات والمتطلبات الأساسية التي تجعلها تعمل.

المتطلبات الأساسية والأدوات

لا يتطلب بناء Adaptive Cards خلفية واسعة في تطوير البرمجيات، لكن عليك التعرف على مجموعة أدوات التأليف القياسية التي توفرها Microsoft. فوجود الأدوات المناسبة في متناول يدك يضمن أن تسير عملية التصميم بسلاسة من الفكرة حتى النشر.

الموارد الأساسية لمصممي البطاقات

• Adaptive Card Designer: ملعب مرئي يعمل في المتصفح، يمكنك من خلاله سحب العناصر وإفلاتها، ومعاينة البطاقة على أجهزة مختلفة مباشرةً، وإنشاء مخطط JSON الأساسي فوراً.
• Microsoft Teams UI Kit (Figma): مورد لا غنى عنه لإرشادات التصميم، والسمات، ومعايير إمكانية الوصول، والأحجام المتجاوبة عبر تطبيقات العملاء المختلفة.
• Official Documentation Hub: مرجعك الموثوق للتحقق من إصدارات المخطط المدعومة، وإجراءات البطاقات، والقيود الخاصة بعرض البطاقات في Teams.
• Sample Templates: قوالب JSON جاهزة من مجتمع المصادر المفتوحة، تمنحك انطلاقة سريعة في الأنماط الشائعة مثل الموافقات والاستطلاعات وتنبيهات الوسائط الغنية.

بعد إعداد بيئة التصميم، ستكون جاهزاً للبدء في تجميع التخطيط المرئي وبنية البيانات الخاصة ببطاقتك.

إنشاء Adaptive Card

إنشاء Adaptive Card تمرين في الأساس على تكوين التخطيط وبنية JSON. ولأن Adaptive Cards تعتمد على مخطط مستقل عن المنصة، يمكن لتعريف بطاقة واحد أن يُعرض بشكل أصلي عبر أنظمة Windows وmacOS وiOS وAndroid وعملاء الويب.

استخدام Adaptive Card Designer

أسهل طريقة لبناء أول بطاقة لك هي استخدام أداة التصميم القائمة على الويب. إليك سير عمل بسيط تتبعه:

1. انتقل إلى Adaptive Card Designer الرسمية في متصفح الويب لديك.
2. اختر قالباً مبدئياً، مثل إشعار أساسي أو نموذج إدخال، لتمنح نفسك أساساً متيناً.
3. اسحب العناصر المرئية مثل TextBlocks وFactSets والصور وActionSets وأفلتها على مساحة العمل الخاصة بك.
4. اضبط الخصائص مثل أحجام الخطوط والمسافات وعناوين الأزرار لتتوافق مع أسلوب التواصل في مؤسستك.
5. بدّل هدف المعاينة إلى "Microsoft Teams" للتحقق من شكل البطاقة كما سيراها مستخدموك النهائيون.
6. انسخ كود JSON المُنشأ تلقائياً من لوحة عرض الكود.

أساسيات فهم بنية JSON

تعتمد كل بطاقة Adaptive في النهاية على حمولة JSON منظمة. فيما يلي مثال بسيط يسهل فهمه للمبتدئين لمخطط JSON لبطاقة Adaptive يحدد تحية أساسية وزر إجراء:

{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    {
      "type": "TextBlock",
      "text": "Welcome to your first adaptive card!",
      "size": "Medium",
      "weight": "Bolder"
    }
  ],
  "actions": [
    {
      "type": "Action.Submit",
      "title": "Acknowledge"
    }
  ]
}

في هذا المقتطف، يحدد الكائن الجذري نوع البطاقة وإصدار المخطط. تحتوي المصفوفة body على العناصر المرئية مثل كتل النصوص، بينما تحدد المصفوفة actions الأزرار التفاعلية، مثل Action.Submit أو Action.OpenUrl، التي تتيح للمستخدمين تشغيل مسارات العمل في الخلفية.

إرسال البطاقات عبر Bots أو Graph API

بعد أن تنتهي من حمولة JSON وتختبرها في المصمم، تكون الخطوة التالية هي تسليم البطاقة مباشرة إلى مستخدميك داخل Microsoft Teams. تتوفر لديك عدة خيارات قوية للنشر، بحسب بنيتك التقنية.

يمكنك الاستفادة من Power Automate لتكاملات سير العمل منخفضة الشيفرة، أو استخدام بوتات مخصصة وMicrosoft Graph API لآليات تسليم متقدمة على مستوى المؤسسات. يتيح استخدام تطبيق Azure AD مسجَّل مع Bot Framework REST API دفع البطاقات التفاعلية تلقائياً إلى مستخدمين محددين أو إلى قنوات ذات ظهور عالٍ.

فيما يلي مثال على بنية الحمولة عند تغليف بطاقة Adaptive الخاصة بك كمرفق ضمن رسالة Bot Framework:

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "text": "New Service Request Pending Review"
          }
        ],
        "actions": [
          {
            "type": "Action.Submit",
            "title": "Approve"
          },
          {
            "type": "Action.Submit",
            "title": "Reject"
          }
        ]
      }
    }
  ]
}

عند ربط هذه الحمولة بمشغّل آلي، مثل إضافة صف جديد إلى قائمة SharePoint أو فشل تشغيل نظام في Power Automate، فإنك تحوّل التنبيه السلبي إلى مطالبة نشطة تدعم اتخاذ القرار.

الاختبار وتصحيح الأخطاء في البطاقات

يجب أن يسبق النشرَ دائماً اختبارٌ دقيق. فلأن العملاء المختلفين، مثل تطبيق Teams لسطح المكتب وتطبيقات الجوال وعملاء البريد في Outlook، يعرضون بطاقات Adaptive عبر إعدادات مضيف خاصة بكل منها، قد تظهر أخطاء تخطيط طفيفة بين حين وآخر.

عند تصحيح أخطاء بطاقاتك، ضع هذه الممارسات الفضلى في اعتبارك:

• التحقق من إصدارات المخطط: تأكد من أن إصدار بطاقتك يتوافق مع الإمكانات التي يدعمها عميل Microsoft Teams الحالي.
• فحص عرض النصوص: تحقق من أن ربط البيانات المتغيرة يملأ الحقول بشكل صحيح ولا يترك مساحات فارغة عندما يكون حقل البيانات فارغاً.
• الاختبار عبر الأجهزة: عاين بطاقاتك على شاشات الجوال الضيقة للتأكد من أن تخطيطات الأعمدة ومجموعات الأزرار تترتب بشكل سليم دون التفاف مربك.
• معالجة إجراءات الإرسال: تأكد من أن خدمة الخلفية لديك تعالج بشكل صحيح حمولات JSON الواردة الناتجة عن نقرات المستخدمين على الأزرار التفاعلية.

الخاتمة

تحويل تجربتك اليومية في Microsoft Teams يدور كله حول تقليل الاحتكاك والتخلص من الضوضاء الرقمية. فباستبدال التنبيهات الثابتة وغير المجدية ببطاقات Adaptive ديناميكية وتفاعلية، تتمكن أنت وفريقك من التصرف بحسم دون التنقل المستمر بين تطبيقات منفصلة. لقد استعرضنا اليوم الأسس الجوهرية لتصميم هذه البطاقات وهيكلتها ونشرها، لكن هذه مجرد البداية لما يمكنك تحقيقه.

لاستكشاف استراتيجيات الإنتاجية بعمق ومعرفة كيفية إعادة تشكيل مساحة عملك الرقمية بالأدوات الحديثة، استمع إلى الحلقة المصاحبة من البودكاست Build Actionable Teams Notifications with Adaptive Cards. ابدأ اليوم بتجربة بطاقاتك المخصصة، وبسّط سير عملك، واستعد تركيزك العميق!