​

Microsoft Teams (مكوّن إضافي)

«اتركوا كل أمل، يا من تدخلون هنا».

​

المكوّن الإضافي المطلوب

openclaw plugins install @openclaw/msteams

openclaw plugins install ./extensions/msteams

​

إعداد سريع (للمبتدئين)

1. تثبيت مكوّن Microsoft Teams الإضافي.
2. إنشاء Azure Bot (معرّف التطبيق + سرّ العميل + معرّف المستأجر).
3. تهيئة OpenClaw باستخدام هذه الاعتمادات.
4. تعريض /api/messages (المنفذ 3978 افتراضيًا) عبر عنوان URL عام أو نفق.
5. تثبيت حزمة تطبيق Teams وبدء الـ Gateway.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      appPassword: "<APP_PASSWORD>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

​

الأهداف

• التحدث إلى OpenClaw عبر الرسائل المباشرة في Teams أو محادثات المجموعات أو القنوات.
• الحفاظ على توجيه حتمي: تعود الردود دائمًا إلى القناة التي وصلت منها.
• الافتراضي هو سلوك آمن للقنوات (يتطلب الذِكر ما لم يتم الضبط خلاف ذلك).

​

كتابة التهيئة

{
  channels: { msteams: { configWrites: false } },
}

​

التحكم في الوصول (الرسائل المباشرة + المجموعات)

• الافتراضي: channels.msteams.dmPolicy = "pairing". يتم تجاهل المُرسِلين غير المعروفين حتى تتم الموافقة عليهم.
• channels.msteams.allowFrom يقبل معرّفات كائن AAD أو UPNs أو أسماء العرض. يقوم المعالج بحل الأسماء إلى معرّفات عبر Microsoft Graph عندما تسمح الاعتمادات.

• الافتراضي: channels.msteams.groupPolicy = "allowlist" (محجوب ما لم تُضِف groupAllowFrom). استخدم channels.defaults.groupPolicy لتجاوز الافتراضي عند عدم الضبط.
• channels.msteams.groupAllowFrom يتحكم في أي المُرسِلين يمكنهم التفعيل في محادثات/قنوات المجموعات (يرجع إلى channels.msteams.allowFrom).
• عيّن groupPolicy: "open" للسماح لأي عضو (مع اشتراط الذِكر افتراضيًا).
• لمنع كل القنوات، عيّن channels.msteams.groupPolicy: "disabled".

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["[email protected]"],
    },
  },
}

• حدِّد نطاق الردود في المجموعات/القنوات بإدراج الفرق والقنوات تحت channels.msteams.teams.
• يمكن أن تكون المفاتيح معرّفات الفرق أو أسمائها؛ ومفاتيح القنوات يمكن أن تكون معرّفات المحادثة أو الأسماء.
• عند تعيين groupPolicy="allowlist" ووجود قائمة سماح للفرق، لا تُقبل إلا الفرق/القنوات المُدرجة (مع اشتراط الذِكر).
• يقبل معالج التهيئة إدخالات Team/Channel ويخزّنها لك.
• عند بدء التشغيل، يقوم OpenClaw بحل أسماء الفرق/القنوات وقائمة سماح المستخدمين إلى معرّفات (عندما تسمح أذونات Graph) ويسجّل المطابقة؛ وتُحفظ الإدخالات غير المحلولة كما كُتبت.

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

كيف يعمل

1. تثبيت مكوّن Microsoft Teams الإضافي.
2. إنشاء Azure Bot (معرّف التطبيق + السرّ + معرّف المستأجر).
3. إنشاء حزمة تطبيق Teams تشير إلى الروبوت وتتضمن أذونات RSC أدناه.
4. رفع/تثبيت تطبيق Teams داخل فريق (أو النطاق الشخصي للرسائل المباشرة).
5. تهيئة msteams في ~/.openclaw/openclaw.json (أو متغيرات البيئة) وبدء الـ Gateway.
6. يستمع الـ Gateway لحركة webhook الخاصة بـ Bot Framework على /api/messages افتراضيًا.

​

إعداد Azure Bot (المتطلبات المسبقة)

​

الخطوة 1: إنشاء Azure Bot

1. انتقل إلى Create Azure Bot
2. املأ تبويب Basics:

   الحقل	القيمة
   اسم المعرّف الخاص بالبوت	اسم الروبوت، مثل openclaw-msteams (يجب أن يكون فريدًا)
   الاشتراك	اختر اشتراك Azure الخاص بك
   مجموعة الموارد	أنشئ جديدًا أو استخدم موجودًا
   فئة التسعير	Free للتطوير/الاختبار
   نوع التطبيق	Single Tenant (موصى به – انظر الملاحظة أدناه)
   نوع الإنشاء	إنشاء معرف تطبيق Microsoft جديد

إشعار إيقاف: تم إيقاف إنشاء روبوتات متعددة المستأجرين الجديدة بعد 2025-07-31. استخدم Single Tenant للروبوتات الجديدة.

3. انقر Review + create → Create (انتظر ~1–2 دقيقة)

​

الخطوة 2: الحصول على الاعتمادات

1. انتقل إلى مورد Azure Bot → Configuration
2. انسخ Microsoft App ID → هذا هو appId
3. انقر Manage Password → انتقل إلى تسجيل التطبيق
4. ضمن Certificates & secrets → New client secret → انسخ Value → هذا هو appPassword
5. انتقل إلى Overview → انسخ Directory (tenant) ID → هذا هو tenantId

​

الخطوة 3: تهيئة نقطة نهاية المراسلة

1. في Azure Bot → Configuration
2. عيّن Messaging endpoint إلى عنوان URL الخاص بالويبهوك:
   • الإنتاج: https://your-domain.com/api/messages
   • التطوير المحلي: استخدم نفقًا (انظر التطوير المحلي أدناه)

​

الخطوة 4: تمكين قناة Teams

1. في Azure Bot → Channels
2. انقر Microsoft Teams → Configure → Save
3. وافق على شروط الخدمة

​

التطوير المحلي (النفق)

ngrok http 3978
# Copy the https URL, e.g., https://abc123.ngrok.io
# Set messaging endpoint to: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Use your Tailscale funnel URL as the messaging endpoint

​

بوابة مطوري Teams (بديل)

1. انقر + New app
2. املأ المعلومات الأساسية (الاسم، الوصف، معلومات المطوّر)
3. انتقل إلى App features → Bot
4. اختر Enter a bot ID manually والصق معرّف تطبيق Azure Bot
5. حدّد النطاقات: Personal، Team، Group Chat
6. انقر Distribute → Download app package
7. في Teams: Apps → Manage your apps → Upload a custom app → اختر ملف ZIP

​

اختبار الروبوت

1. في بوابة Azure → مورد Azure Bot الخاص بك → Test in Web Chat
2. أرسل رسالة — يجب أن ترى ردًا
3. يؤكد ذلك أن نقطة نهاية الويبهوك تعمل قبل إعداد Teams

1. ثبّت تطبيق Teams (تحميل جانبي أو كتالوج المؤسسة)
2. اعثر على الروبوت في Teams وأرسل رسالة مباشرة
3. تحقق من سجلات الـ Gateway للنشاط الوارد

​

الإعداد (نص فقط، حد أدنى)

1. تثبيت مكوّن Microsoft Teams الإضافي
   • من npm: openclaw plugins install @openclaw/msteams
   • من نسخة محلية: openclaw plugins install ./extensions/msteams
2. تسجيل الروبوت
   • أنشئ Azure Bot (انظر أعلاه) وسجّل:
     • App ID
     • Client secret (كلمة مرور التطبيق)
     • Tenant ID (مستأجر واحد)
3. ملف manifest لتطبيق Teams
   • تضمين إدخال bot مع botId = <App ID>.
   • النطاقات: personal، team، groupChat.
   • supportsFiles: true (مطلوب للتعامل مع الملفات في النطاق الشخصي).
   • إضافة أذونات RSC (أدناه).
   • إنشاء أيقونات: outline.png (32x32) و color.png (192x192).
   • ضغط الملفات الثلاثة معًا: manifest.json، outline.png، color.png.
4. تهيئة OpenClaw
   {
     "msteams": {
       "enabled": true,
       "appId": "<APP_ID>",
       "appPassword": "<APP_PASSWORD>",
       "tenantId": "<TENANT_ID>",
       "webhook": { "port": 3978, "path": "/api/messages" }
     }
   }
   
   يمكنك أيضًا استخدام متغيرات البيئة بدل مفاتيح التهيئة:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. نقطة نهاية الروبوت
   • عيّن نقطة نهاية المراسلة في Azure Bot إلى:
     • https://<host>:3978/api/messages (أو المسار/المنفذ الذي تختاره).
6. تشغيل الـ Gateway
   • تبدأ قناة Teams تلقائيًا عند تثبيت المكوّن ووجود تهيئة msteams مع الاعتمادات.

​

سياق السجل (History)

• يتحكم channels.msteams.historyLimit في عدد الرسائل الأخيرة من القناة/المجموعة التي تُغلّف داخل الموجّه.
• يعود افتراضيًا إلى messages.groupChat.historyLimit. عيّن 0 لتعطيل ذلك (الافتراضي 50).
• يمكن تقييد سجل الرسائل المباشرة عبر channels.msteams.dmHistoryLimit (عدد أدوار المستخدم). تجاوزات لكل مستخدم: channels.msteams.dms["<user_id>"].historyLimit.

​

أذونات Teams RSC الحالية (Manifest)

• ChannelMessage.Read.Group (Application) – استلام كل رسائل القناة دون @mention
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) – استلام كل رسائل محادثة المجموعة دون @mention

​

مثال Manifest لتطبيق Teams (محذوف التفاصيل)

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  "manifestVersion": "1.23",
  "version": "1.0.0",
  "id": "00000000-0000-0000-0000-000000000000",
  "name": { "short": "OpenClaw" },
  "developer": {
    "name": "Your Org",
    "websiteUrl": "https://example.com",
    "privacyUrl": "https://example.com/privacy",
    "termsOfUseUrl": "https://example.com/terms"
  },
  "description": { "short": "OpenClaw in Teams", "full": "OpenClaw in Teams" },
  "icons": { "outline": "outline.png", "color": "color.png" },
  "accentColor": "#5B6DEF",
  "bots": [
    {
      "botId": "11111111-1111-1111-1111-111111111111",
      "scopes": ["personal", "team", "groupChat"],
      "isNotificationOnly": false,
      "supportsCalling": false,
      "supportsVideo": false,
      "supportsFiles": true
    }
  ],
  "webApplicationInfo": {
    "id": "11111111-1111-1111-1111-111111111111"
  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        { "name": "ChannelMessage.Read.Group", "type": "Application" },
        { "name": "ChannelMessage.Send.Group", "type": "Application" },
        { "name": "Member.Read.Group", "type": "Application" },
        { "name": "Owner.Read.Group", "type": "Application" },
        { "name": "ChannelSettings.Read.Group", "type": "Application" },
        { "name": "TeamMember.Read.Group", "type": "Application" },
        { "name": "TeamSettings.Read.Group", "type": "Application" },
        { "name": "ChatMessage.Read.Chat", "type": "Application" }
      ]
    }
  }
}

​

ملاحظات Manifest (حقول إلزامية)

• bots[].botId يجب أن يطابق معرّف تطبيق Azure Bot.
• webApplicationInfo.id يجب أن يطابق معرّف تطبيق Azure Bot.
• bots[].scopes يجب أن يتضمن الأسطح التي تخطط لاستخدامها (personal، team، groupChat).
• bots[].supportsFiles: true مطلوب للتعامل مع الملفات في النطاق الشخصي.
• authorization.permissions.resourceSpecific يجب أن يتضمن قراءة/إرسال القنوات إذا أردت حركة مرور القنوات.

​

تحديث تطبيق موجود

1. حدّث manifest.json بالإعدادات الجديدة
2. زد قيمة الحقل version (مثل 1.0.0 → 1.1.0)
3. أعد ضغط ملف manifest مع الأيقونات (manifest.json، outline.png، color.png)
4. ارفع ملف zip الجديد:
   • الخيار أ (Teams Admin Center): Teams Admin Center → Teams apps → Manage apps → اعثر على تطبيقك → Upload new version
   • الخيار ب (تحميل جانبي): في Teams → Apps → Manage your apps → Upload a custom app
5. لقنوات الفرق: أعد تثبيت التطبيق في كل فريق لتفعيل الأذونات الجديدة
6. أغلق Teams تمامًا وأعد تشغيله (ليس مجرد إغلاق النافذة) لمسح بيانات التعريف المخزنة مؤقتًا

​

الإمكانات: RSC فقط مقابل Graph

​

مع Teams RSC فقط (التطبيق مُثبّت، دون أذونات Graph API)

• قراءة محتوى نص رسائل القنوات.
• إرسال محتوى نص لرسائل القنوات.
• استلام مرفقات الملفات في الرسائل الشخصية (DM).

• محتويات الصور أو الملفات في القنوات/المجموعات (يتضمن الحمولة مجرد HTML).
• تنزيل المرفقات المخزنة في SharePoint/OneDrive.
• قراءة سجل الرسائل (ما بعد حدث الويبهوك المباشر).

​

مع Teams RSC + أذونات Microsoft Graph (Application)

• تنزيل المحتويات المستضافة (الصور الملصقة داخل الرسائل).
• تنزيل مرفقات الملفات المخزنة في SharePoint/OneDrive.
• قراءة سجل رسائل القنوات/الدردشات عبر Graph.

​

RSC مقابل Graph API

​

وسائط + سجل عبر Graph (مطلوب للقنوات)

1. في Entra ID (Azure AD) تسجيل التطبيق، أضف أذونات Microsoft Graph Application:
   • ChannelMessage.Read.All (مرفقات القنوات + السجل)
   • Chat.Read.All أو ChatMessage.Read.All (محادثات المجموعات)
2. امنح موافقة المسؤول للمستأجر.
3. ارفع رقم إصدار manifest لتطبيق Teams، أعد الرفع، وأعد تثبيت التطبيق في Teams.
4. أغلق Teams تمامًا وأعد تشغيله لمسح البيانات المخزنة مؤقتًا.

​

القيود المعروفة

​

مهل Webhook

• مهلات Gateway
• إعادة إرسال Teams للرسالة (مسببة تكرارات)
• إسقاط الردود

​

التنسيق

• يعمل التنسيق الأساسي: غامق، مائل، code، الروابط
• قد لا تُعرَض تنسيقات معقدة (الجداول، القوائم المتداخلة) بشكل صحيح
• بطاقات Adaptive Cards مدعومة للاستطلاعات وإرسال البطاقات عمومًا (انظر أدناه)

​

التهيئة

• channels.msteams.enabled: تمكين/تعطيل القناة.
• channels.msteams.appId، channels.msteams.appPassword، channels.msteams.tenantId: اعتمادات الروبوت.
• channels.msteams.webhook.port (الافتراضي 3978)
• channels.msteams.webhook.path (الافتراضي /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (الافتراضي: pairing)
• channels.msteams.allowFrom: قائمة سماح للرسائل المباشرة (معرّفات كائن AAD أو UPNs أو أسماء العرض). يقوم المعالج بحل الأسماء إلى معرّفات أثناء الإعداد عند توفر وصول Graph.
• channels.msteams.textChunkLimit: حجم تقسيم النص الصادر.
• channels.msteams.chunkMode: length (افتراضي) أو newline للتقسيم عند الأسطر الفارغة (حدود الفقرات) قبل التقسيم حسب الطول.
• channels.msteams.mediaAllowHosts: قائمة سماح لمضيفي المرفقات الواردة (الافتراضي نطاقات Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: قائمة سماح لإرفاق رؤوس Authorization عند إعادة محاولة الوسائط (الافتراضي مضيفو Graph + Bot Framework).
• channels.msteams.requireMention: اشتراط @mention في القنوات/المجموعات (افتراضي true).
• channels.msteams.replyStyle: thread | top-level (انظر نمط الرد).
• channels.msteams.teams.<teamId>.replyStyle: تجاوز لكل فريق.
• channels.msteams.teams.<teamId>.requireMention: تجاوز لكل فريق.
• channels.msteams.teams.<teamId>.tools: تجاوزات افتراضية لسياسات الأدوات لكل فريق (allow/deny/alsoAllow) تُستخدم عند غياب تجاوز القناة.
• channels.msteams.teams.<teamId>.toolsBySender: تجاوزات افتراضية لسياسات الأدوات لكل فريق ولكل مُرسِل ("*" مدعوم).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: تجاوز لكل قناة.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: تجاوز لكل قناة.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: تجاوزات سياسات الأدوات لكل قناة (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: تجاوزات سياسات الأدوات لكل قناة ولكل مُرسِل ("*" مدعوم).
• channels.msteams.sharePointSiteId: معرّف موقع SharePoint لرفع الملفات في محادثات/قنوات المجموعات (انظر إرسال الملفات في محادثات المجموعات).

​

التوجيه والجلسات

• تتبع مفاتيح الجلسة تنسيق الوكيل القياسي (انظر /concepts/session):
  • الرسائل المباشرة تشترك في الجلسة الرئيسية (agent:<agentId>:<mainKey>).
  • رسائل القنوات/المجموعات تستخدم معرّف المحادثة:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

نمط الرد: السلاسل مقابل المنشورات

• thread في قناة بنمط السلاسل → تظهر الردود متداخلة بشكل غير ملائم
• top-level في قناة بنمط المنشورات → تظهر الردود كمنشورات عليا منفصلة بدل الرد داخل السلسلة

{
  "msteams": {
    "replyStyle": "thread",
    "teams": {
      "19:[email protected]": {
        "channels": {
          "19:[email protected]": {
            "replyStyle": "top-level"
          }
        }
      }
    }
  }
}

​

المرفقات والصور

• الرسائل المباشرة: تعمل الصور ومرفقات الملفات عبر واجهات ملفات روبوت Teams.
• القنوات/المجموعات: تعيش المرفقات في تخزين M365 (SharePoint/OneDrive). تتضمن حمولة الويبهوك مجرد HTML، وليس بايتات الملف الفعلية. أذونات Graph API مطلوبة لتنزيل مرفقات القنوات.

​

إرسال الملفات في محادثات المجموعات

​

لماذا تحتاج محادثات المجموعات إلى SharePoint

​

الإعداد

1. إضافة أذونات Graph API في Entra ID (Azure AD) → تسجيل التطبيق:
   • Sites.ReadWrite.All (Application) – رفع الملفات إلى SharePoint
   • Chat.Read.All (Application) – اختياري، يفعّل روابط مشاركة لكل مستخدم
2. منح موافقة المسؤول للمستأجر.
3. الحصول على معرّف موقع SharePoint:
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. تهيئة OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

سلوك المشاركة

​

سلوك الرجوع (Fallback)

​

موقع تخزين الملفات

​

الاستطلاعات (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• تُسجَّل الأصوات بواسطة الـ Gateway في ~/.openclaw/msteams-polls.json.
• يجب أن يبقى الـ Gateway متصلًا لتسجيل الأصوات.
• لا يتم نشر ملخصات النتائج تلقائيًا بعد (افحص ملف التخزين عند الحاجة).

​

بطاقات Adaptive (عامّة)

{
  "action": "send",
  "channel": "msteams",
  "target": "user:<id>",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello!" }]
  }
}

openclaw message send --channel msteams \
  --target "conversation:19:[email protected]" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

​

تنسيقات الهدف

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:[email protected]" --message "Hello"

# Send an Adaptive Card to a conversation
openclaw message send --channel msteams --target "conversation:19:[email protected]" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

{
  "action": "send",
  "channel": "msteams",
  "target": "user:John Smith",
  "message": "Hello!"
}

{
  "action": "send",
  "channel": "msteams",
  "target": "conversation:19:[email protected]",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello" }]
  }
}

​

رسالة استباقية

• لا تكون الرسائل الاستباقية ممكنة إلا بعد تفاعل المستخدم، لأننا نخزّن مراجع المحادثة عند تلك النقطة.
• انظر /gateway/configuration بخصوص dmPolicy وبوابات قوائم السماح.

​

معرّفات الفرق والقنوات (خطأ شائع)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• معرّف الفريق = مقطع المسار بعد /team/ (بعد فك الترميز، مثل 19:[email protected])
• معرّف القناة = مقطع المسار بعد /channel/ (بعد فك الترميز)
• تجاهل معامل الاستعلام groupId

​

القنوات الخاصة

1. استخدام القنوات القياسية لتفاعلات الروبوت
2. استخدام الرسائل المباشرة — يمكن للمستخدمين دائمًا مراسلة الروبوت مباشرة
3. استخدام Graph API للوصول التاريخي (يتطلب ChannelMessage.Read.All)

​

مشكلات شائعة

​

مشكلات شائعة

• الصور لا تظهر في القنوات: أذونات Graph أو موافقة المسؤول مفقودة. أعد تثبيت تطبيق Teams وأغلق/أعد فتح Teams بالكامل.
• لا توجد ردود في القناة: الذِكر مطلوب افتراضيًا؛ عيّن channels.msteams.requireMention=false أو اضبط لكل فريق/قناة.
• عدم تطابق الإصدار (Teams ما زال يعرض manifest قديمًا): أزل التطبيق وأعد إضافته وأغلق Teams بالكامل للتحديث.
• 401 Unauthorized من الويبهوك: متوقع عند الاختبار اليدوي دون JWT من Azure — يعني أن نقطة النهاية قابلة للوصول لكن فشل التوثيق. استخدم Azure Web Chat للاختبار الصحيح.

​

أخطاء رفع Manifest

• «Icon file cannot be empty»: يشير manifest إلى أيقونات حجمها 0 بايت. أنشئ أيقونات PNG صالحة (32x32 لـ outline.png، و192x192 لـ color.png).
• «webApplicationInfo.Id already in use»: التطبيق ما زال مُثبّتًا في فريق/دردشة أخرى. اعثر عليه وألغِ تثبيته أولًا، أو انتظر 5–10 دقائق للانتشار.
• «Something went wrong» عند الرفع: ارفع عبر https://admin.teams.microsoft.com بدلًا من ذلك، وافتح أدوات المطوّر في المتصفح (F12) → تبويب Network، وتحقق من جسم الاستجابة للخطأ الفعلي.
• فشل التحميل الجانبي: جرّب «Upload an app to your org’s app catalog» بدل «Upload a custom app» — غالبًا ما يتجاوز قيود التحميل الجانبي.

​

أذونات RSC لا تعمل

1. تحقق من أن webApplicationInfo.id يطابق معرّف تطبيق الروبوت بدقة
2. أعد رفع التطبيق وأعد تثبيته في الفريق/الدردشة
3. تحقق مما إذا كان مسؤول المؤسسة قد حظر أذونات RSC
4. تأكد من استخدام النطاق الصحيح: ChannelMessage.Read.Group للفرق، وChatMessage.Read.Chat لمحادثات المجموعات

​

المراجع

• Create Azure Bot – دليل إعداد Azure Bot
• Teams Developer Portal – إنشاء/إدارة تطبيقات Teams
• Teams app manifest schema
• Receive channel messages with RSC
• RSC permissions reference
• Teams bot file handling (القنوات/المجموعات تتطلب Graph)
• Proactive messaging