​

Microsoft Teams

“Lasciate ogni speranza, voi che entrate qui.”

​

Plugin incluso

openclaw plugins install @openclaw/msteams

openclaw plugins install ./path/to/local/msteams-plugin

​

Configurazione rapida (principianti)

1. Assicurati che il plugin Microsoft Teams sia disponibile.
   • Le attuali versioni pacchettizzate di OpenClaw lo includono già.
   • Le installazioni precedenti/personalizzate possono aggiungerlo manualmente con i comandi sopra.
2. Crea un Azure Bot (ID app + client secret + ID tenant).
3. Configura OpenClaw con queste credenziali.
4. Esponi /api/messages (porta 3978 per impostazione predefinita) tramite un URL pubblico o un tunnel.
5. Installa il pacchetto app Teams e avvia il gateway.

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

​

Obiettivi

• Parlare con OpenClaw tramite DM Teams, chat di gruppo o canali.
• Mantenere il routing deterministico: le risposte tornano sempre al canale da cui sono arrivate.
• Adottare per impostazione predefinita un comportamento sicuro nei canali (menzioni richieste salvo diversa configurazione).

​

Scritture di configurazione

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

​

Controllo degli accessi (DM + gruppi)

• Predefinito: channels.msteams.dmPolicy = "pairing". I mittenti sconosciuti vengono ignorati finché non vengono approvati.
• channels.msteams.allowFrom dovrebbe usare ID oggetto AAD stabili.
• UPN/nomi visualizzati sono modificabili; la corrispondenza diretta è disabilitata per impostazione predefinita e viene abilitata solo con channels.msteams.dangerouslyAllowNameMatching: true.
• La procedura guidata può risolvere i nomi in ID tramite Microsoft Graph quando le credenziali lo consentono.

• Predefinito: channels.msteams.groupPolicy = "allowlist" (bloccato a meno che non aggiungi groupAllowFrom). Usa channels.defaults.groupPolicy per sovrascrivere il valore predefinito quando non è impostato.
• channels.msteams.groupAllowFrom controlla quali mittenti possono attivarsi nelle chat di gruppo/canali (con fallback a channels.msteams.allowFrom).
• Imposta groupPolicy: "open" per consentire qualsiasi membro (comunque con gate basato su menzione per impostazione predefinita).
• Per non consentire alcun canale, imposta channels.msteams.groupPolicy: "disabled".

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["user@org.com"],
    },
  },
}

• Limita le risposte in gruppi/canali elencando team e canali in channels.msteams.teams.
• Le chiavi dovrebbero usare ID team stabili e ID conversazione del canale.
• Quando groupPolicy="allowlist" ed è presente una allowlist di team, vengono accettati solo team/canali elencati (con gate basato su menzione).
• La procedura guidata di configurazione accetta voci Team/Channel e le memorizza per te.
• All’avvio, OpenClaw risolve i nomi nelle allowlist di team/canali e utenti in ID (quando le autorizzazioni Graph lo consentono) e registra la mappatura; i nomi di team/canali non risolti vengono mantenuti così come digitati ma ignorati per il routing per impostazione predefinita, a meno che non sia abilitato channels.msteams.dangerouslyAllowNameMatching: true.

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

​

Come funziona

1. Assicurati che il plugin Microsoft Teams sia disponibile.
   • Le attuali versioni pacchettizzate di OpenClaw lo includono già.
   • Le installazioni precedenti/personalizzate possono aggiungerlo manualmente con i comandi sopra.
2. Crea un Azure Bot (ID app + secret + ID tenant).
3. Crea un pacchetto app Teams che faccia riferimento al bot e includa le autorizzazioni RSC qui sotto.
4. Carica/installa l’app Teams in un team (o nell’ambito personale per i DM).
5. Configura msteams in ~/.openclaw/openclaw.json (o variabili d’ambiente) e avvia il gateway.
6. Per impostazione predefinita, il gateway ascolta il traffico webhook Bot Framework su /api/messages.

​

Configurazione Azure Bot (prerequisiti)

​

Passaggio 1: crea Azure Bot

1. Vai a Create Azure Bot
2. Compila la scheda Basics:

   Campo	Valore
   Bot handle	Il nome del tuo bot, ad esempio openclaw-msteams (deve essere univoco)
   Subscription	Seleziona la tua sottoscrizione Azure
   Resource group	Creane uno nuovo o usane uno esistente
   Pricing tier	Free per sviluppo/test
   Type of App	Single Tenant (consigliato - vedi nota sotto)
   Creation type	Create new Microsoft App ID

Avviso di deprecazione: la creazione di nuovi bot multi-tenant è stata deprecata dopo il 2025-07-31. Usa Single Tenant per i nuovi bot.

3. Fai clic su Review + create → Create (attendi ~1-2 minuti)

​

Passaggio 2: ottieni le credenziali

1. Vai alla tua risorsa Azure Bot → Configuration
2. Copia Microsoft App ID → questo è il tuo appId
3. Fai clic su Manage Password → vai all’App Registration
4. In Certificates & secrets → New client secret → copia il Value → questo è il tuo appPassword
5. Vai a Overview → copia Directory (tenant) ID → questo è il tuo tenantId

​

Passaggio 3: configura l’endpoint di messaggistica

1. In Azure Bot → Configuration
2. Imposta Messaging endpoint sul tuo URL webhook:
   • Produzione: https://your-domain.com/api/messages
   • Sviluppo locale: usa un tunnel (vedi Sviluppo locale sotto)

​

Passaggio 4: abilita il canale Teams

1. In Azure Bot → Channels
2. Fai clic su Microsoft Teams → Configure → Save
3. Accetta i Termini di servizio

​

Sviluppo locale (tunneling)

ngrok http 3978
# Copia l'URL https, ad esempio https://abc123.ngrok.io
# Imposta l'endpoint di messaggistica su: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Usa il tuo URL Tailscale funnel come endpoint di messaggistica

​

Teams Developer Portal (alternativa)

1. Fai clic su + New app
2. Compila le informazioni di base (nome, descrizione, informazioni sullo sviluppatore)
3. Vai a App features → Bot
4. Seleziona Enter a bot ID manually e incolla il tuo Azure Bot App ID
5. Seleziona gli ambiti: Personal, Team, Group Chat
6. Fai clic su Distribute → Download app package
7. In Teams: Apps → Manage your apps → Upload a custom app → seleziona il file ZIP

​

Test del bot

1. In Azure Portal → la tua risorsa Azure Bot → Test in Web Chat
2. Invia un messaggio: dovresti vedere una risposta
3. Questo conferma che il tuo endpoint webhook funziona prima della configurazione Teams

1. Installa l’app Teams (sideload o catalogo org)
2. Trova il bot in Teams e invia un DM
3. Controlla i log del gateway per l’attività in ingresso

​

Configurazione (solo testo minima)

1. Assicurati che il plugin Microsoft Teams sia disponibile
   • Le attuali versioni pacchettizzate di OpenClaw lo includono già.
   • Le installazioni precedenti/personalizzate possono aggiungerlo manualmente:
     • Da npm: openclaw plugins install @openclaw/msteams
     • Da un checkout locale: openclaw plugins install ./path/to/local/msteams-plugin
2. Registrazione del bot
   • Crea un Azure Bot (vedi sopra) e annota:
     • ID app
     • Client secret (password app)
     • ID tenant (single-tenant)
3. Manifest dell’app Teams
   • Includi una voce bot con botId = <App ID>.
   • Ambiti: personal, team, groupChat.
   • supportsFiles: true (richiesto per la gestione dei file nell’ambito personale).
   • Aggiungi le autorizzazioni RSC (sotto).
   • Crea le icone: outline.png (32x32) e color.png (192x192).
   • Comprimi insieme tutti e tre i file: manifest.json, outline.png, color.png.
4. Configura OpenClaw
   {
     channels: {
       msteams: {
         enabled: true,
         appId: "<APP_ID>",
         appPassword: "<APP_PASSWORD>",
         tenantId: "<TENANT_ID>",
         webhook: { port: 3978, path: "/api/messages" },
       },
     },
   }
   
   Puoi anche usare variabili d’ambiente invece delle chiavi di configurazione:
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. Endpoint del bot
   • Imposta l’Azure Bot Messaging Endpoint su:
     • https://<host>:3978/api/messages (o il tuo percorso/porta scelti).
6. Esegui il gateway
   • Il canale Teams si avvia automaticamente quando il plugin incluso o installato manualmente è disponibile e la configurazione msteams esiste con le credenziali.

​

Azione informazioni membro

• Autorizzazione RSC Member.Read.Group (già presente nel manifest consigliato)
• Per ricerche tra team diversi: autorizzazione applicazione Graph User.Read.All con consenso amministratore

​

Contesto cronologia

• channels.msteams.historyLimit controlla quanti messaggi recenti di canale/gruppo vengono inseriti nel prompt.
• Usa come fallback messages.groupChat.historyLimit. Imposta 0 per disabilitare (predefinito 50).
• La cronologia del thread recuperata viene filtrata tramite allowlist dei mittenti (allowFrom / groupAllowFrom), quindi l’inizializzazione del contesto del thread include solo messaggi di mittenti consentiti.
• Il contesto degli allegati citati (ReplyTo* derivato dall’HTML di risposta Teams) viene attualmente passato così come ricevuto.
• In altre parole, le allowlist controllano chi può attivare l’agente; oggi vengono filtrati solo specifici percorsi di contesto supplementare.
• La cronologia DM può essere limitata con channels.msteams.dmHistoryLimit (turni utente). Override per utente: channels.msteams.dms["<user_id>"].historyLimit.

​

Autorizzazioni RSC Teams attuali (Manifest)

• ChannelMessage.Read.Group (Application) - riceve tutti i messaggi del canale senza @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) - riceve tutti i messaggi della chat di gruppo senza @mention

​

Esempio di manifest Teams (redatto)

{
  $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" },
      ],
    },
  },
}

​

Limitazioni del manifest (campi obbligatori)

• bots[].botId deve corrispondere all’Azure Bot App ID.
• webApplicationInfo.id deve corrispondere all’Azure Bot App ID.
• bots[].scopes deve includere le superfici che intendi usare (personal, team, groupChat).
• bots[].supportsFiles: true è richiesto per la gestione dei file nell’ambito personale.
• authorization.permissions.resourceSpecific deve includere lettura/invio canale se vuoi traffico canale.

​

Aggiornare un’app esistente

1. Aggiorna il tuo manifest.json con le nuove impostazioni
2. Incrementa il campo version (ad esempio 1.0.0 → 1.1.0)
3. Ricomprimi il manifest con le icone (manifest.json, outline.png, color.png)
4. Carica il nuovo zip:
   • Opzione A (Teams Admin Center): Teams Admin Center → Teams apps → Manage apps → trova la tua app → Upload new version
   • Opzione B (Sideload): In Teams → Apps → Manage your apps → Upload a custom app
5. Per i canali team: reinstalla l’app in ogni team affinché le nuove autorizzazioni abbiano effetto
6. Chiudi completamente e riavvia Teams (non solo chiudere la finestra) per cancellare i metadati dell’app memorizzati nella cache

​

Capacità: solo RSC vs Graph

​

Con solo Teams RSC (app installata, nessuna autorizzazione API Graph)

• Lettura del contenuto testuale dei messaggi di canale.
• Invio del contenuto testuale dei messaggi di canale.
• Ricezione di allegati file personali (DM).

• Contenuto di immagini o file in canali/gruppi (il payload include solo uno stub HTML).
• Download di allegati archiviati in SharePoint/OneDrive.
• Lettura della cronologia messaggi (oltre l’evento webhook in tempo reale).

​

Con Teams RSC + autorizzazioni applicazione Microsoft Graph

• Download dei contenuti ospitati (immagini incollate nei messaggi).
• Download degli allegati file archiviati in SharePoint/OneDrive.
• Lettura della cronologia dei messaggi di canale/chat tramite Graph.

​

RSC vs API Graph

​

Media + cronologia abilitati da Graph (richiesti per i canali)

1. In Entra ID (Azure AD) App Registration, aggiungi autorizzazioni Microsoft Graph Application:
   • ChannelMessage.Read.All (allegati canale + cronologia)
   • Chat.Read.All o ChatMessage.Read.All (chat di gruppo)
2. Concedi il consenso amministratore per il tenant.
3. Incrementa la versione del manifest dell’app Teams, ricaricala e reinstalla l’app in Teams.
4. Chiudi completamente e riavvia Teams per cancellare i metadati dell’app memorizzati nella cache.

​

Limitazioni note

​

Timeout webhook

• Timeout del gateway
• Teams che ritenta il messaggio (causando duplicati)
• Risposte perse

​

Formattazione

• La formattazione di base funziona: grassetto, corsivo, code, link
• Il markdown complesso (tabelle, elenchi annidati) potrebbe non essere renderizzato correttamente
• Le Adaptive Cards sono supportate per sondaggi e invii arbitrari di card (vedi sotto)

​

Configurazione

• channels.msteams.enabled: abilita/disabilita il canale.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: credenziali del bot.
• channels.msteams.webhook.port (predefinito 3978)
• channels.msteams.webhook.path (predefinito /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (predefinito: pairing)
• channels.msteams.allowFrom: allowlist DM (consigliati ID oggetto AAD). La procedura guidata risolve i nomi in ID durante la configurazione quando l’accesso Graph è disponibile.
• channels.msteams.dangerouslyAllowNameMatching: interruttore di emergenza per riabilitare la corrispondenza con UPN/nome visualizzato modificabili e il routing diretto per nome team/canale.
• channels.msteams.textChunkLimit: dimensione chunk testo in uscita.
• channels.msteams.chunkMode: length (predefinito) o newline per dividere sulle righe vuote (confini di paragrafo) prima del chunking per lunghezza.
• channels.msteams.mediaAllowHosts: allowlist per host di allegati in ingresso (predefinito: domini Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts: allowlist per allegare header Authorization ai retry dei media (predefinito: host Graph + Bot Framework).
• channels.msteams.requireMention: richiede @mention in canali/gruppi (predefinito true).
• channels.msteams.replyStyle: thread | top-level (vedi Stile di risposta).
• channels.msteams.teams.<teamId>.replyStyle: override per team.
• channels.msteams.teams.<teamId>.requireMention: override per team.
• channels.msteams.teams.<teamId>.tools: override predefiniti dei criteri strumenti per team (allow/deny/alsoAllow) usati quando manca un override di canale.
• channels.msteams.teams.<teamId>.toolsBySender: override predefiniti dei criteri strumenti per team per mittente ("*" wildcard supportato).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: override per canale.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: override per canale.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: override dei criteri strumenti per canale (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: override dei criteri strumenti per canale per mittente ("*" wildcard supportato).
• Le chiavi toolsBySender dovrebbero usare prefissi espliciti: id:, e164:, username:, name: (le chiavi legacy senza prefisso continuano a essere mappate solo a id:).
• channels.msteams.actions.memberInfo: abilita o disabilita l’azione informazioni membro supportata da Graph (predefinito: abilitata quando sono disponibili credenziali Graph).
• channels.msteams.sharePointSiteId: ID sito SharePoint per caricamenti file in chat di gruppo/canali (vedi Invio di file nelle chat di gruppo).

​

Routing e sessioni

• Le chiavi di sessione seguono il formato agente standard (vedi /concepts/session):
  • I messaggi diretti condividono la sessione principale (agent:<agentId>:<mainKey>).
  • I messaggi di canale/gruppo usano l’id conversazione:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Stile di risposta: thread vs post

• thread in un canale in stile Threads → le risposte appaiono annidate in modo scomodo
• top-level in un canale in stile Posts → le risposte appaiono come post top-level separati invece che nel thread

{
  channels: {
    msteams: {
      replyStyle: "thread",
      teams: {
        "19:abc...@thread.tacv2": {
          channels: {
            "19:xyz...@thread.tacv2": {
              replyStyle: "top-level",
            },
          },
        },
      },
    },
  },
}

​

Allegati e immagini

• DM: immagini e allegati file funzionano tramite le API file del bot Teams.
• Canali/gruppi: gli allegati vivono nello storage M365 (SharePoint/OneDrive). Il payload webhook include solo uno stub HTML, non i byte effettivi del file. Sono richieste autorizzazioni API Graph per scaricare gli allegati dei canali.
• Per invii espliciti file-first, usa action=upload-file con media / filePath / path; message opzionale diventa il testo/commento di accompagnamento, e filename sovrascrive il nome caricato.

​

Invio di file nelle chat di gruppo

​

Perché i gruppi richiedono SharePoint

​

Configurazione

1. Aggiungi autorizzazioni API Graph in Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) - carica file su SharePoint
   • Chat.Read.All (Application) - facoltativo, abilita link di condivisione per utente
2. Concedi il consenso amministratore per il tenant.
3. Ottieni il tuo ID sito SharePoint:
   # Tramite Graph Explorer o curl con un token valido:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Esempio: per un sito in "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # La risposta include: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Configura OpenClaw:
   {
     channels: {
       msteams: {
         // ... altra configurazione ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Comportamento di condivisione

​

Comportamento di fallback

​

Posizione dei file archiviati

​

Sondaggi (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• I voti vengono registrati dal gateway in ~/.openclaw/msteams-polls.json.
• Il gateway deve restare online per registrare i voti.
• I sondaggi non pubblicano ancora automaticamente riepiloghi dei risultati (se necessario, ispeziona il file dello store).

​

Adaptive Cards (arbitrarie)

{
  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:abc...@thread.tacv2" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

​

Formati target

# Invia a un utente per ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Invia a un utente per nome visualizzato (attiva una ricerca API Graph)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Invia a una chat di gruppo o a un canale
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" --message "Hello"

# Invia un'Adaptive Card a una conversazione
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --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:abc...@thread.tacv2",
  card: {
    type: "AdaptiveCard",
    version: "1.5",
    body: [{ type: "TextBlock", text: "Hello" }],
  },
}

​

Messaggistica proattiva

• I messaggi proattivi sono possibili solo dopo che un utente ha interagito, perché a quel punto memorizziamo i riferimenti alla conversazione.
• Vedi /gateway/configuration per dmPolicy e il controllo tramite allowlist.

​

ID team e canale (problema comune)

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

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      ID canale (decodifica questo URL)

• ID team = segmento del percorso dopo /team/ (decodificato URL, ad esempio 19:Bk4j...@thread.tacv2)
• ID canale = segmento del percorso dopo /channel/ (decodificato URL)
• Ignora il parametro di query groupId

​

Canali privati

1. Usa canali standard per le interazioni col bot
2. Usa i DM - gli utenti possono sempre inviare messaggi direttamente al bot
3. Usa l’API Graph per l’accesso storico (richiede ChannelMessage.Read.All)

​

Risoluzione dei problemi

​

Problemi comuni

• Le immagini non vengono mostrate nei canali: mancano autorizzazioni Graph o consenso amministratore. Reinstalla l’app Teams e chiudi/riapri completamente Teams.
• Nessuna risposta nel canale: le menzioni sono richieste per impostazione predefinita; imposta channels.msteams.requireMention=false oppure configura per team/canale.
• Version mismatch (Teams mostra ancora il vecchio manifest): rimuovi e aggiungi di nuovo l’app, quindi chiudi completamente Teams per aggiornare.
• 401 Unauthorized dal webhook: previsto quando si testa manualmente senza JWT Azure - significa che l’endpoint è raggiungibile ma l’autenticazione è fallita. Usa Azure Web Chat per testare correttamente.

​

Errori di caricamento del manifest

• “Icon file cannot be empty”: il manifest fa riferimento a file icona da 0 byte. Crea icone PNG valide (32x32 per outline.png, 192x192 per color.png).
• “webApplicationInfo.Id already in use”: l’app è ancora installata in un altro team/chat. Trovala e disinstallala prima, oppure attendi 5-10 minuti per la propagazione.
• “Something went wrong” durante il caricamento: carica invece tramite https://admin.teams.microsoft.com, apri DevTools del browser (F12) → scheda Network, e controlla il corpo della risposta per l’errore effettivo.
• Sideload non riuscito: prova “Upload an app to your org’s app catalog” invece di “Upload a custom app” - spesso aggira le restrizioni sul sideload.

​

Le autorizzazioni RSC non funzionano

1. Verifica che webApplicationInfo.id corrisponda esattamente all’App ID del tuo bot
2. Ricarica l’app e reinstallala nel team/chat
3. Controlla se l’amministratore dell’organizzazione ha bloccato le autorizzazioni RSC
4. Conferma di usare l’ambito corretto: ChannelMessage.Read.Group per i team, ChatMessage.Read.Chat per le chat di gruppo

​

Riferimenti

• Create Azure Bot - guida alla configurazione Azure Bot
• Teams Developer Portal - crea/gestisci app Teams
• Teams app manifest schema
• Receive channel messages with RSC
• RSC permissions reference
• Teams bot file handling (canale/gruppo richiede Graph)
• Proactive messaging

​

Correlati

• Panoramica canali — tutti i canali supportati
• Pairing — autenticazione DM e flusso di pairing
• Gruppi — comportamento della chat di gruppo e gate basato su menzione
• Routing del canale — routing della sessione per i messaggi
• Sicurezza — modello di accesso e hardening