​

Microsoft Teams (Plugin)

„Lasst alle Hoffnung fahren, ihr, die ihr hier eintretet.“

​

Erforderliches Plugin

openclaw plugins install @openclaw/msteams

openclaw plugins install ./extensions/msteams

​

Schnellstart (Anfänger)

1. Installieren Sie das Microsoft-Teams-Plugin.
2. Erstellen Sie einen Azure Bot (App-ID + Client Secret + Tenant-ID).
3. Konfigurieren Sie OpenClaw mit diesen Zugangsdaten.
4. Exponieren Sie /api/messages (Standardport 3978) über eine öffentliche URL oder einen Tunnel.
5. Installieren Sie das Teams-App-Paket und starten Sie das Gateway.

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

​

Ziele

• Mit OpenClaw über Teams-DMs, Gruppenchats oder Kanäle sprechen.
• Deterministisches Routing beibehalten: Antworten gehen immer an den Kanal zurück, aus dem sie kamen.
• Standardmäßig sicheres Kanalverhalten (Erwähnungen erforderlich, sofern nicht anders konfiguriert).

​

Konfigurationsschreibzugriffe

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

​

Zugriffskontrolle (DMs + Gruppen)

• Standard: channels.msteams.dmPolicy = "pairing". Unbekannte Absender werden ignoriert, bis sie genehmigt sind.
• channels.msteams.allowFrom akzeptiert AAD-Objekt-IDs, UPNs oder Anzeigenamen. Der Assistent löst Namen bei ausreichenden Berechtigungen über Microsoft Graph in IDs auf.

• Standard: channels.msteams.groupPolicy = "allowlist" (blockiert, sofern Sie nicht groupAllowFrom hinzufügen). Verwenden Sie channels.defaults.groupPolicy, um den Standard zu überschreiben, wenn nicht gesetzt.
• channels.msteams.groupAllowFrom steuert, welche Absender in Gruppenchats/Kanälen auslösen dürfen (Fallback auf channels.msteams.allowFrom).
• Setzen Sie groupPolicy: "open", um jedes Mitglied zuzulassen (standardmäßig weiterhin erwähnungsbasiert).
• Um keine Kanäle zuzulassen, setzen Sie channels.msteams.groupPolicy: "disabled".

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

• Begrenzen Sie Gruppen-/Kanalantworten, indem Sie Teams und Kanäle unter channels.msteams.teams auflisten.
• Schlüssel können Team-IDs oder -Namen sein; Kanalschlüssel können Konversations-IDs oder -Namen sein.
• Wenn groupPolicy="allowlist" gesetzt ist und eine Teams-Allowlist vorhanden ist, werden nur gelistete Teams/Kanäle akzeptiert (erwähnungsbasiert).
• Der Konfigurationsassistent akzeptiert Team/Channel-Einträge und speichert sie für Sie.
• Beim Start löst OpenClaw Team-/Kanal- und Benutzer-Allowlist-Namen in IDs auf (wenn Graph-Berechtigungen vorhanden sind) und protokolliert die Zuordnung; nicht auflösbare Einträge bleiben unverändert.

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

​

Wie es funktioniert

1. Installieren Sie das Microsoft-Teams-Plugin.
2. Erstellen Sie einen Azure Bot (App-ID + Secret + Tenant-ID).
3. Erstellen Sie ein Teams-App-Paket, das auf den Bot verweist und die unten aufgeführten RSC-Berechtigungen enthält.
4. Laden/installieren Sie die Teams-App in ein Team (oder im persönlichen Bereich für DMs).
5. Konfigurieren Sie msteams in ~/.openclaw/openclaw.json (oder per Umgebungsvariablen) und starten Sie das Gateway.
6. Das Gateway lauscht standardmäßig auf Bot-Framework-Webhook-Traffic unter /api/messages.

​

Azure Bot Setup (Voraussetzungen)

​

Schritt 1: Azure Bot erstellen

1. Gehen Sie zu Azure Bot erstellen
2. Füllen Sie den Reiter Basics aus:

   Feld	Wert
   Bot-Name	Ihr Botname, z. B. openclaw-msteams (muss eindeutig sein)
   Abonnement	Wählen Sie Ihr Azure-Abonnement
   Ressourcengruppe	Neu erstellen oder bestehende verwenden
   Tarifstufe	Free für Dev/Test
   App-Typ	Single Tenant (empfohlen – siehe Hinweis unten)
   Erstellungstyp	Neue Microsoft App ID erstellen

Hinweis zur Abkündigung: Die Erstellung neuer Multi-Tenant-Bots wurde nach dem 2025-07-31 eingestellt. Verwenden Sie Single Tenant für neue Bots.

3. Klicken Sie auf Review + create → Create (Wartezeit ~1–2 Minuten)

​

Schritt 2: Zugangsdaten abrufen

1. Gehen Sie zu Ihrer Azure-Bot-Ressource → Configuration
2. Kopieren Sie Microsoft App ID → das ist Ihre appId
3. Klicken Sie auf Manage Password → zur App-Registrierung
4. Unter Certificates & secrets → New client secret → kopieren Sie den Value → das ist Ihre appPassword
5. Gehen Sie zu Overview → kopieren Sie Directory (tenant) ID → das ist Ihre tenantId

​

Schritt 3: Messaging Endpoint konfigurieren

1. In Azure Bot → Konfiguration
2. Setzen Sie Messaging endpoint auf Ihre Webhook-URL:
   • Produktion: https://your-domain.com/api/messages
   • Lokale Entwicklung: Verwenden Sie einen Tunnel (siehe Lokale Entwicklung unten)

​

Schritt 4: Teams-Kanal aktivieren

1. In Azure Bot → Channels
2. Klicken Sie auf Microsoft Teams → Configure → Save
3. Akzeptieren Sie die Nutzungsbedingungen

​

Lokale Entwicklung (Tunneling)

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 Developer Portal (Alternative)

1. Klicken Sie auf + New app
2. Füllen Sie die Basisinformationen aus (Name, Beschreibung, Entwicklerinfos)
3. Gehen Sie zu App features → Bot
4. Wählen Sie Enter a bot ID manually und fügen Sie Ihre Azure-Bot-App-ID ein
5. Aktivieren Sie die Scopes: Personal, Team, Group Chat
6. Klicken Sie auf Distribute → Download app package
7. In Teams: Apps → Manage your apps → Upload a custom app → ZIP auswählen

​

Bot testen

1. Im Azure-Portal → Ihre Azure-Bot-Ressource → Test in Web Chat
2. Senden Sie eine Nachricht – Sie sollten eine Antwort sehen
3. Dies bestätigt, dass Ihr Webhook-Endpunkt funktioniert, bevor Teams eingerichtet wird

1. Installieren Sie die Teams-App (Sideload oder Org-Katalog)
2. Finden Sie den Bot in Teams und senden Sie eine DM
3. Prüfen Sie die Gateway-Logs auf eingehende Aktivitäten

​

Setup (minimal, nur Text)

1. Microsoft-Teams-Plugin installieren
   • Aus npm: openclaw plugins install @openclaw/msteams
   • Aus lokalem Checkout: openclaw plugins install ./extensions/msteams
2. Bot-Registrierung
   • Erstellen Sie einen Azure Bot (siehe oben) und notieren Sie:
     • App-ID
     • Client Secret (App-Passwort)
     • Tenant-ID (Single Tenant)
3. Teams-App-Manifest
   • Fügen Sie einen bot-Eintrag mit botId = <App ID> hinzu.
   • Scopes: personal, team, groupChat.
   • supportsFiles: true (erforderlich für Dateiverarbeitung im persönlichen Bereich).
   • RSC-Berechtigungen hinzufügen (siehe unten).
   • Icons erstellen: outline.png (32×32) und color.png (192×192).
   • Alle drei Dateien zusammen zippen: manifest.json, outline.png, color.png.
4. OpenClaw konfigurieren
   {
     "msteams": {
       "enabled": true,
       "appId": "<APP_ID>",
       "appPassword": "<APP_PASSWORD>",
       "tenantId": "<TENANT_ID>",
       "webhook": { "port": 3978, "path": "/api/messages" }
     }
   }
   
   Sie können statt Konfigurationsschlüsseln auch Umgebungsvariablen verwenden:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. Bot-Endpunkt
   • Setzen Sie den Azure-Bot-Messaging-Endpunkt auf:
     • https://<host>:3978/api/messages (oder Ihren gewählten Pfad/Port).
6. Gateway starten
   • Der Teams-Kanal startet automatisch, wenn das Plugin installiert ist und eine msteams-Konfiguration mit Zugangsdaten existiert.

​

Verlaufskontext

• channels.msteams.historyLimit steuert, wie viele aktuelle Kanal-/Gruppennachrichten in den Prompt aufgenommen werden.
• Fallback auf messages.groupChat.historyLimit. Setzen Sie 0, um zu deaktivieren (Standard 50).
• DM-Verlauf kann mit channels.msteams.dmHistoryLimit (Benutzer-Turns) begrenzt werden. Pro-Benutzer-Overrides: channels.msteams.dms["<user_id>"].historyLimit.

​

Aktuelle Teams-RSC-Berechtigungen (Manifest)

• ChannelMessage.Read.Group (Application) – alle Kanalnachrichten ohne @Erwähnung empfangen
• 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) – alle Gruppenchats ohne @Erwähnung empfangen

​

Beispiel-Teams-Manifest (redigiert)

{
  "$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-Hinweise (Pflichtfelder)

• bots[].botId muss exakt der Azure-Bot-App-ID entsprechen.
• webApplicationInfo.id muss der Azure-Bot-App-ID entsprechen.
• bots[].scopes muss die von Ihnen geplanten Oberflächen enthalten (personal, team, groupChat).
• bots[].supportsFiles: true ist für die Dateiverarbeitung im persönlichen Bereich erforderlich.
• authorization.permissions.resourceSpecific muss Kanal-Lesen/Senden enthalten, wenn Sie Kanalverkehr möchten.

​

Aktualisieren einer bestehenden App

1. Aktualisieren Sie Ihr manifest.json mit den neuen Einstellungen
2. Erhöhen Sie das Feld version (z. B. 1.0.0 → 1.1.0)
3. Erneut zippen des Manifests mit Icons (manifest.json, outline.png, color.png)
4. Neues ZIP hochladen:
   • Option A (Teams Admin Center): Teams Admin Center → Teams apps → Manage apps → App finden → Upload new version
   • Option B (Sideload): In Teams → Apps → Manage your apps → Upload a custom app
5. Für Teamkanäle: App in jedem Team neu installieren, damit neue Berechtigungen wirksam werden
6. Teams vollständig beenden und neu starten (nicht nur das Fenster schließen), um zwischengespeicherte Metadaten zu löschen

​

Fähigkeiten: Nur RSC vs. Graph

​

Mit Teams RSC בלבד (App installiert, keine Graph-API-Berechtigungen)

• Lesen von Kanalnachrichten (Text).
• Senden von Kanalnachrichten (Text).
• Empfangen von persönlichen (DM) Dateianhängen.

• Bild- oder Dateiinhalte in Kanälen/Gruppen (Payload enthält nur HTML-Stub).
• Herunterladen von Anhängen aus SharePoint/OneDrive.
• Lesen des Nachrichtenverlaufs (über das Live-Webhook-Ereignis hinaus).

​

Mit Teams RSC + Microsoft Graph Application-Berechtigungen

• Herunterladen gehosteter Inhalte (in Nachrichten eingefügte Bilder).
• Herunterladen von Dateianhängen aus SharePoint/OneDrive.
• Lesen des Kanal-/Chat-Nachrichtenverlaufs über Graph.

​

RSC vs. Graph API

​

Graph-aktivierte Medien + Verlauf (erforderlich für Kanäle)

1. In Entra ID (Azure AD) App Registration Microsoft Graph Application permissions hinzufügen:
   • ChannelMessage.Read.All (Kanalanhänge + Verlauf)
   • Chat.Read.All oder ChatMessage.Read.All (Gruppenchats)
2. Admin-Consent für den Tenant erteilen.
3. Teams-App-Manifest-Version erhöhen, erneut hochladen und App in Teams neu installieren.
4. Teams vollständig beenden und neu starten, um Cache zu leeren.

​

Bekannte Einschränkungen

​

Webhook-Timeouts

• Gateway-Timeouts
• Teams wiederholt die Nachricht (verursacht Duplikate)
• Verlorene Antworten

​

Formatierung

• Grundformatierung funktioniert: fett, kursiv, code, Links
• Komplexes Markdown (Tabellen, verschachtelte Listen) wird möglicherweise nicht korrekt dargestellt
• Adaptive Cards werden für Umfragen und beliebige Karten unterstützt (siehe unten)

​

Konfiguration

• channels.msteams.enabled: Kanal aktivieren/deaktivieren.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: Bot-Zugangsdaten.
• channels.msteams.webhook.port (Standard 3978)
• channels.msteams.webhook.path (Standard /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (Standard: pairing)
• channels.msteams.allowFrom: Allowlist für DMs (AAD-Objekt-IDs, UPNs oder Anzeigenamen). Der Assistent löst Namen bei verfügbarem Graph-Zugriff während des Setups in IDs auf.
• channels.msteams.textChunkLimit: Ausgehende Text-Chunk-Größe.
• channels.msteams.chunkMode: length (Standard) oder newline, um vor der Längenaufteilung an Leerzeilen (Absatzgrenzen) zu splitten.
• channels.msteams.mediaAllowHosts: Allowlist für eingehende Anhang-Hosts (Standard: Microsoft-/Teams-Domains).
• channels.msteams.mediaAuthAllowHosts: Allowlist zum Anhängen von Authorization-Headern bei Medien-Retries (Standard: Graph- + Bot-Framework-Hosts).
• channels.msteams.requireMention: @Erwähnung in Kanälen/Gruppen erforderlich (Standard true).
• channels.msteams.replyStyle: thread | top-level (siehe Antwortstil).
• channels.msteams.teams.<teamId>.replyStyle: Pro-Team-Override.
• channels.msteams.teams.<teamId>.requireMention: Pro-Team-Override.
• channels.msteams.teams.<teamId>.tools: Standardmäßige Pro-Team-Werkzeugrichtlinien-Overrides (allow/deny/alsoAllow), die verwendet werden, wenn ein Kanal-Override fehlt.
• channels.msteams.teams.<teamId>.toolsBySender: Standardmäßige Pro-Team-Pro-Absender-Werkzeugrichtlinien-Overrides ("*"-Wildcard unterstützt).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: Pro-Kanal-Override.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: Pro-Kanal-Override.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: Pro-Kanal-Werkzeugrichtlinien-Overrides (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: Pro-Kanal-Pro-Absender-Werkzeugrichtlinien-Overrides ("*"-Wildcard unterstützt).
• channels.msteams.sharePointSiteId: SharePoint-Site-ID für Datei-Uploads in Gruppenchats/Kanälen (siehe Dateien in Gruppenchats senden).

​

Routing & Sitzungen

• Sitzungsschlüssel folgen dem Standard-Agent-Format (siehe /concepts/session):
  • Direktnachrichten teilen sich die Hauptsitzung (agent:<agentId>:<mainKey>).
  • Kanal-/Gruppennachrichten verwenden die Konversations-ID:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Antwortstil: Threads vs. Posts

• thread in einem Threads-Kanal → Antworten werden unglücklich verschachtelt angezeigt
• top-level in einem Posts-Kanal → Antworten erscheinen als separate Top-Level-Posts statt im Thread

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

​

Anhänge & Bilder

• DMs: Bilder und Dateianhänge funktionieren über die Teams-Bot-Datei-APIs.
• Kanäle/Gruppen: Anhänge liegen in M365-Speichern (SharePoint/OneDrive). Der Webhook-Payload enthält nur einen HTML-Stub, nicht die tatsächlichen Dateibytes. Graph-API-Berechtigungen sind erforderlich, um Kanalanhänge herunterzuladen.

​

Dateien in Gruppenchats senden

​

Warum Gruppenchats SharePoint benötigen

​

Setup

1. Graph-API-Berechtigungen hinzufügen in Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) – Dateien zu SharePoint hochladen
   • Chat.Read.All (Application) – optional, ermöglicht benutzerspezifische Freigabelinks
2. Admin-Consent für den Tenant erteilen.
3. SharePoint-Site-ID ermitteln:
   # 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 konfigurieren:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Freigabeverhalten

​

Fallback-Verhalten

​

Speicherort der Dateien

​

Umfragen (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Stimmen werden vom Gateway in ~/.openclaw/msteams-polls.json gespeichert.
• Das Gateway muss online bleiben, um Stimmen zu erfassen.
• Umfragen posten derzeit noch keine Ergebniszusammenfassungen automatisch (prüfen Sie bei Bedarf die Store-Datei).

​

Adaptive Cards (beliebig)

{
  "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!"}]}'

​

Zielformate

# 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" }]
  }
}

​

Proaktive Nachrichten

• Proaktive Nachrichten sind nur nachdem ein Benutzer interagiert hat möglich, da wir zu diesem Zeitpunkt Konversationsreferenzen speichern.
• Siehe /gateway/configuration für dmPolicy und Allowlist-Gating.

​

Team- und Kanal-IDs (häufige Stolperfalle)

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-ID = Pfadsegment nach /team/ (URL-dekodiert, z. B. 19:[email protected])
• Kanal-ID = Pfadsegment nach /channel/ (URL-dekodiert)
• Ignorieren Sie den Query-Parameter groupId

​

Private Kanäle

1. Standardkanäle für Bot-Interaktionen verwenden
2. DMs verwenden – Benutzer können den Bot jederzeit direkt anschreiben
3. Graph API für historischen Zugriff verwenden (erfordert ChannelMessage.Read.All)

​

Häufige Probleme

​

Häufige Probleme

• Bilder werden in Kanälen nicht angezeigt: Graph-Berechtigungen oder Admin-Consent fehlen. Teams-App neu installieren und Teams vollständig beenden/neu öffnen.
• Keine Antworten im Kanal: Erwähnungen sind standardmäßig erforderlich; setzen Sie channels.msteams.requireMention=false oder konfigurieren Sie pro Team/Kanal.
• Versionskonflikt (Teams zeigt noch altes Manifest): App entfernen + erneut hinzufügen und Teams vollständig beenden, um zu aktualisieren.
• 401 Unauthorized vom Webhook: Erwartet bei manuellem Test ohne Azure-JWT – bedeutet, der Endpunkt ist erreichbar, aber die Authentifizierung schlug fehl. Verwenden Sie Azure Web Chat für korrekte Tests.

​

Fehler beim Manifest-Upload

• „Icon file cannot be empty“: Das Manifest verweist auf Icon-Dateien mit 0 Byte. Erstellen Sie gültige PNG-Icons (32×32 für outline.png, 192×192 für color.png).
• „webApplicationInfo.Id already in use“: Die App ist noch in einem anderen Team/Chat installiert. Deinstallieren Sie sie dort oder warten Sie 5–10 Minuten auf die Propagierung.
• „Something went wrong“ beim Upload: Laden Sie stattdessen über https://admin.teams.microsoft.com hoch, öffnen Sie die Browser-DevTools (F12) → Network-Tab und prüfen Sie den Response-Body auf den eigentlichen Fehler.
• Sideload schlägt fehl: Versuchen Sie „Upload an app to your org’s app catalog“ statt „Upload a custom app“ – das umgeht häufig Sideload-Beschränkungen.

​

RSC-Berechtigungen funktionieren nicht

1. Verifizieren Sie, dass webApplicationInfo.id exakt der App-ID Ihres Bots entspricht
2. App erneut hochladen und im Team/Chat neu installieren
3. Prüfen Sie, ob Ihr Org-Admin RSC-Berechtigungen blockiert hat
4. Bestätigen Sie den richtigen Scope: ChannelMessage.Read.Group für Teams, ChatMessage.Read.Chat für Gruppenchats

​

Referenzen

• Azure Bot erstellen – Leitfaden zur Azure-Bot-Einrichtung
• Teams Developer Portal – Teams-Apps erstellen/verwalten
• Teams-App-Manifest-Schema
• Kanalnachrichten mit RSC empfangen
• RSC-Berechtigungsreferenz
• Teams-Bot-Dateiverarbeitung (Kanal/Gruppe erfordert Graph)
• Proaktive Nachrichten