إنشاء تطبيقات Teams: مقدمة للمبتدئين

By Mirko Peters · 2026-05-19 · Updated 2026-09-13

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

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

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

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

البدء مع تطبيقات Teams Toolkit وبيئة المطور

عندما تبدأون ببناء تطبيقات لـ Microsoft Teams، فإن اختيار الأداة المناسبة وإعداد مساحة العمل يُحدثان فرقاً كبيراً. فـ Teams Toolkit هي أداتكم الرئيسية، إذ تجمع كل المكونات معاً عبر دمجها مباشرةً في Visual Studio Code. ومن هناك، تحصلون على مكان واحد متكامل لتصميم تطبيقات Teams وتطويرها واختبارها ونشرها، مما يجعل العمل أقل تعقيداً وأكثر إنتاجية بكثير.

إذا كنتم جدداً في هذا المجال، فإن العمل داخل Visual Studio Code باستخدام Teams Toolkit يعني أنكم لا تحتاجون إلى التنقل بين برامج متعددة أو تذكّر خطوات سطر الأوامر المعقدة. فكل شيء، من القوالب والإعدادات وحتى الاختبار المحلي، متاح في متناول أيديكم. وقد صُمم هذا الإعداد من أجل السرعة وقابلية التكرار، وتقليل المتاعب التي تُبطئ المبتدئين.

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

مراجعة المتطلبات الأساسية واعتبارات Microsoft 365

• Visual Studio Code وامتداد Teams Toolkit: ستحتاجون أولاً إلى تثبيت Visual Studio Code، ثم إضافة امتداد Teams Toolkit، وهو مساحة عملكم الرئيسية لتطوير تطبيقات Teams.
• Node.js والأدوات ذات الصلة: تعتمد العديد من تطبيقات Teams على لغة JavaScript أو TypeScript، لذا تأكدوا من تثبيت Node.js (الإصدار LTS) لإدارة التبعيات وتشغيل النصوص البرمجية.
• حساب مطور Microsoft 365: قوموا بإعداد مستأجر اختبار لـ Microsoft 365. فهذا يتيح لكم بناء التطبيقات واختبارها ومعاينتها بأمان، دون التأثير على بيئتكم المؤسسية الفعلية.
• الأذونات والوصول الإداري: تأكدوا من امتلاككم صلاحيات المسؤول أو أذونات التطوير على مستأجر الاختبار. فبعض الميزات (مثل الروبوتات أو موصلات البيانات) تتطلب وصولاً بصلاحيات مرتفعة.
• الاتصال بالإنترنت والمتصفح: الاتصال الموثوق بالإنترنت ضروري لمزامنة الكود وتشغيل المعاينات والمصادقة مع الخدمات السحابية. كما أن متصفحاً حديثاً ضروري للوصول إلى Teams وبوابات معاينة التطبيقات.

فهم أنواع تطبيقات Teams وإمكاناتها

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

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

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

بدء مشروع تطبيق جديد باستخدام Teams Toolkit في Visual Studio Code

بعد إعداد أدوات المطور، تبدأ المرحلة العملية في Visual Studio Code مع Teams Toolkit. فهذه هي نقطة الانطلاق لبناء أول مشروع تطبيق لـ Teams. ستجد توجيهات إرشادية تساعدك على اختيار نوع التطبيق الذي تريده (كعلامة تبويب أو روبوت)، واختيار قوالب جاهزة للاستخدام تسرّع رحلتك.

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

بعد الانتهاء من تهيئة المشروع، ستظهر في مساحة العمل بنية محددة من المجلدات ومجموعة من الملفات، لكل منها وظيفة مختلفة: بعضها يتولى الشيفرة، وبعضها يحدد الإعدادات، وبعضها يدير النشر. إن معرفة دور كل جزء في وقت مبكر تساعدك على تجنب الالتباس، وتبقي مشروعك على المسار الصحيح مع نموه. في الجزء التالي سنشرح ما يفعله كل مجلد وملف، حتى لا تتساءل عمّا هو ماذا.

استكشاف بنية المشروع وتخطيط الدلائل

• دليل src: هنا يوجد كل منطق التطبيق الأساسي وشيفرة الواجهة. سواء كنت تبني روبوتاً أو علامة تبويب، فستكتب ملفات TypeScript أو JavaScript وتنظمها في هذا الدليل.
• مجلد env: يحتوي على ملفات الإعدادات الخاصة بالبيئات المختلفة، مثل المتغيرات الخاصة بالتطوير والإنتاج. يساعدك على إدارة الإعدادات دون ترميز البيانات الحساسة بشكل صريح في الشيفرة.
• مجلد infrastructure أو infra: يحتوي على نصوص وقوالب خاصة بموارد Azure أو غيرها من متطلبات النشر. يلزم هذا المجلد إذا كان تطبيقك يُنشئ خدمات سحابية.
• مجلد manifest التطبيق: وفيه تحدد ملف manifest الخاص بتطبيقك، بما يشمل الأيقونات واسم التطبيق والأوصاف والأذونات. وهذا الملف هو ما يحدد كيفية تعرّف Teams على تطبيقك وتثبيته.
• README.md والمستندات: توفر هذه الملفات توثيقاً وتعليمات وملاحظات تساعدك أنت وزملاءك في الفريق على فهم إعداد المشروع وغايته بنظرة سريعة.

معاينة تطبيق Teams Toolkit محلياً باستخدام Ngrok

قبل أن تنشر تطبيق Teams على المؤسسة بأكملها، ستحتاج إلى اختباره مباشرةً كما سيراه مستخدموك. يتولى Teams Toolkit الكثير من المهام نيابةً عنك، لكن بما أن Microsoft Teams خدمة سحابية، فلا يمكنك ببساطة تشغيل خادم ويب محلي وتتوقع أن يعمل كل شيء من أول مرة. وهنا يأتي دور ngrok.

يُنشئ ngrok نفقاً آمناً من الإنترنت العام إلى جهازك المحلي. وهذا يعني أن تطبيق Teams الخاص بك، سواء كان علامة تبويب أو روبوتاً أو امتداد رسائل، يمكن الوصول إليه من Microsoft Teams، رغم أنك تشغّله على حاسوبك الخاص. ويتكامل Teams Toolkit مع ngrok، مما يجعل الإعداد بسيطاً كنقرتين أو ثلاث، فلا تحتاج إلى التعامل مع جدران الحماية أو مشكلات الشبكات المعقدة.

عند المعاينة محليًا باستخدام Toolkit وngrok، تحصل على ملاحظات فورية حول ما يعمل بشكل صحيح وما يحتاج إلى إصلاح، مباشرةً داخل واجهة Teams. وإذا لاحظت مشكلة، عدّل الشيفرة وأعد التحميل، وبهذه البساطة. تُقصّر حلقة الملاحظات هذه المدة بين البناء ورؤية النتائج الفعلية، وهو أمر بالغ الأهمية عند معالجة الأخطاء أو تحسين التجربة قبل الإطلاق. فالمعاينة المحلية في Teams تساعدك على إنجاز العمل بشكل صحيح قبل عرضه على فريقك بالكامل.

تخصيص تطبيق Teams Toolkit الخاص بك: تحسينات واجهة المستخدم والبيانات

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

لكن الأمر لا يقتصر على المظهر. فربط تطبيقك بالبيانات الفعلية يمكن أن يحوّله من نموذج تجريبي إلى أداة عمل لا غنى عنها. ربما ترغب في أن يستقي تطبيقك المعلومات من جدول بيانات، أو يدير صفوف جدول، أو يتصل بخلفية خادم عبر استدعاءات API مخصصة. تمنحك هذه التحسينات التحكم في ما يعرضه تطبيقك وطريقة تفاعل المستخدمين معه يوميًا.

وأنت تبدأ في تعديل واجهة المستخدم أو إعداد جداول البيانات، لا تغفل عن سهولة الاستخدام، فالنماذج الواضحة، والتسميات المفيدة، والبطاقات التفاعلية تُحدث فرقًا كبيرًا. للمزيد من الأفكار حول تعزيز التفاعلية في Teams، قد ترغب في قراءة المقال حول unlocking interactive Adaptive Cards in Teams. أما من يرغب في إتقان تخصيص الإشعارات والبقاء على اطلاع دائم، ففي this guide to smarter Teams notifications and adaptive cards الكثير مما يستحق التعلم. وفيما يلي سنتناول كيفية التعامل مع عناوين التطبيق وخلفياته والاتصال اليدوي بالبيانات لتحسين مظهر تطبيقك وفائدته.

تحديث عنوان التطبيق وخلفية المعرض

• تغيير عنوان التطبيق: افتح ملف البيان وحدّث الاسم المعروض للتطبيق ليتوافق مع هوية مؤسستك أو مشروعك.
• استبدال صورة خلفية المعرض: استبدل الخلفية الافتراضية بصورة مخصصة تعكس أسلوب فريقك أو لوحة ألوانه.
• تحديث أيقونات التطبيق: ارفع الأيقونات المربعة والأيقونات الخطية لمعارض Teams. يساعد ذلك تطبيقك على التميّز بصريًا في قائمة تطبيقات Teams.

ربط البيانات يدويًا وإدارة الجداول

• ربط مصادر البيانات: اربط تطبيقك يدويًا بقاعدة بيانات أو ملف Excel أو نقطة نهاية API، فقط وجّه إعدادات تطبيقك إلى المصدر الصحيح.
• إنشاء الجداول وتعديلها: أنشئ جداول جديدة، وأضف أعمدة لمعلومات المستخدم أو الحالة أو الحقول المخصصة التي يحتاجها تطبيقك.
• إضافة الصفوف وتحريرها: أدخل بيانات نموذجية، أو عدّل القيم، أو دع المستخدمين يدخلون المعلومات ديناميكيًا، فذلك يحافظ على تحديث محتوى تطبيقك وفائدته.

تصميم تجربة مستخدم متسقة باستخدام Fluent UI وAdaptive Cards

التطبيق الجيد في Teams لا يكتفي بالعمل، بل يبدو ويُحسّ بأنه في مكانه الصحيح ضمن بيئة Microsoft Teams. يوفّر Fluent UI مجموعة من مكونات واجهة المستخدم المفتوحة المصدر وسهلة الوصول، والمتوافقة مع أسلوب Teams نفسه. وباستخدامه يمكنك بناء حقول النماذج والأزرار والقوائم والتخطيطات التي تبدو طبيعية لمستخدميك النهائيين دون البدء من الصفر.

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

تركّز أفضل ممارسات تجربة المستخدم في Teams على الوضوح والسرعة، فاجعل تسميات أزرارك واضحة، ونظّم المعلومات المترابطة معًا، ولا تُثقل بطاقاتك بالتفاصيل. يساعد التصميم المتجاوب تطبيقك على التكيّف مع الويب وسطح المكتب والأجهزة المحمولة. أما للمطورين ومحترفي Power Platform الذين يرغبون في إتقان Adaptive Cards والأتمتة، فإن guide to building interactive Teams Adaptive Cards يتضمن أمثلة عملية غنية بسير العمل وبأمثلة JSON.

باختصار، الالتزام بـ Fluent UI والبطاقات التكيفية (Adaptive Cards) يجعل تطبيقك يبدو وكأنه جزء أصيل من المنصة ويحظى بالثقة. فهو يُبقي المستخدمين متفاعلين، ويقلل الارتباك، ويرفع فرص أن يتحول تطبيقك إلى عادة يومية، لا مجرد علامة تبويب أخرى يتم تجاهلها.

تخصيص تطبيق Teams Toolkit ونشره

عندما يبدو تطبيق Teams ويتصرف بالشكل الصحيح، حان الوقت لنقله من مكتب التطوير إلى بقية المؤسسة. تبدأ عملية النشر بتخصيص تطبيق Teams Toolkit، فالتعديلات النهائية على ملفات البيان (manifest) والأذونات والهوية البصرية تضمن أن يلبي تطبيقك توقعات فريقك ويجتاز الفحوصات التنظيمية.

تعني حزمة التطبيق تجميع جميع الملفات والصور والشيفرة في تنسيق يفهمه Teams. ستحتاج إلى التحقق مرة أخرى من ملف البيان للتأكد من الأيقونات المطلوبة وبيانات الخصوصية والأذونات التي يطلبها التطبيق. الأمان أمر بالغ الأهمية، إذ يجب أن تلتزم التطبيقات بمعايير المؤسسة ومعايير Microsoft 365 حتى يمكن تثبيتها في Teams.

يرشدك Teams Toolkit خلال إرسال التطبيق إلى كتالوج تطبيقات المستأجر في Microsoft 365 الخاص بك، أو إلى متجر تطبيقات Teams في حال الطرح الأوسع (وذلك وفقاً لعملية مراجعة Microsoft). قد تحتاج إلى موافقة المسؤول قبل أن يتمكن الجميع من استخدام الأداة الجديدة. كما يحدث التوفير (Provisioning) في هذه المرحلة، أي إعداد أي موارد سحابية يحتاجها التطبيق، لضمان جاهزيته للمستخدمين الفعليين لحظة تثبيته.

لا يقتصر نجاح الطرح على رفع ملف فحسب. اختبر التطبيق بدقة، وأبلغ بالتغييرات، وراقب المشكلات بعد النشر حتى يتمكن فريقك من الاستفادة من المزايا دون انقطاع.

استكشاف موارد التعلم والخطوات التالية لمطوري تطبيقات Teams

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

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

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

من هنا، فكّر في الحصول على شهادات تثبت كفاءتك في تطوير تطبيقات Teams، أو في التعمق في السيناريوهات المتقدمة مثل الروبوتات (Bots) والأتمتة والأمان. مع المزيج المناسب من التعلم والمشاركة المجتمعية، ستستمر في التقدم حتى بعد إطلاق تطبيقك الأول.