Microsoft Teams

​

Gebundelde Plugin

openclaw plugins install @openclaw/msteams

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

​

Snelle setup

npm install -g @microsoft/teams.cli@preview
teams login
teams status   # verify you're logged in and see your tenant info

# One-time setup (persistent URL across sessions):
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot
# Your endpoint: https://<tunnel-id>.devtunnels.ms/api/messages

teams app create \
  --name "OpenClaw" \
  --endpoint "https://<your-tunnel-url>/api/messages"

• Maakt een Entra ID-applicatie (Azure AD) aan
• Genereert een client secret
• Bouwt en uploadt een Teams-appmanifest (met pictogrammen)
• Registreert de bot (standaard beheerd door Teams - geen Azure-abonnement nodig)

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

teams app get <teamsAppId> --install-link

teams app doctor <teamsAppId>

​

Doelen

• Praat met OpenClaw via Teams-DM’s, groepschats of kanalen.
• Houd routing deterministisch: antwoorden gaan altijd terug naar het kanaal waarop ze binnenkwamen.
• Gebruik standaard veilig kanaalgedrag (vermeldingen vereist tenzij anders geconfigureerd).

​

Configuratieschrijfacties

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

​

Toegangscontrole (DM’s + groepen)

• Standaard: channels.msteams.dmPolicy = "pairing". Onbekende afzenders worden genegeerd totdat ze zijn goedgekeurd.
• channels.msteams.allowFrom moet stabiele AAD-object-ID’s gebruiken of statische afzendertoegangsgroepen zoals accessGroup:core-team.
• Vertrouw niet op UPN-/weergavenaam-matching voor allowlists - die kunnen veranderen. OpenClaw schakelt directe naammatching standaard uit; schakel dit expliciet in met channels.msteams.dangerouslyAllowNameMatching: true.
• De wizard kan namen naar ID’s herleiden via Microsoft Graph wanneer credentials dat toestaan.

• Standaard: channels.msteams.groupPolicy = "allowlist" (geblokkeerd tenzij je groupAllowFrom toevoegt). Gebruik channels.defaults.groupPolicy om de standaardwaarde te overschrijven wanneer deze niet is ingesteld.
• channels.msteams.groupAllowFrom bepaalt welke afzenders of statische afzendertoegangsgroepen in groepschats/kanalen kunnen triggeren (valt terug op channels.msteams.allowFrom).
• Stel groupPolicy: "open" in om elk lid toe te staan (standaard nog steeds met vermelding vereist).
• Om geen kanalen toe te staan, stel je channels.msteams.groupPolicy: "disabled" in.

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["00000000-0000-0000-0000-000000000000", "accessGroup:core-team"],
    },
  },
}

• Beperk groeps-/kanaalantwoorden door teams en kanalen te vermelden onder channels.msteams.teams.
• Sleutels moeten stabiele Teams-gespreks-ID’s uit Teams-links gebruiken, geen veranderlijke weergavenamen.
• Wanneer groupPolicy="allowlist" en er een teams-allowlist aanwezig is, worden alleen vermelde teams/kanalen geaccepteerd (met vermelding vereist).
• De configuratiewizard accepteert Team/Channel-items en slaat ze voor je op.
• Bij het opstarten herleidt OpenClaw namen van team/kanaal- en gebruikers-allowlists naar ID’s (wanneer Graph-machtigingen dat toestaan) en logt de mapping; niet-herleide team-/kanaalnamen worden behouden zoals getypt, maar standaard genegeerd voor routing tenzij channels.msteams.dangerouslyAllowNameMatching: true is ingeschakeld.

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

​

Gefedereerde authenticatie (certificaat plus beheerde identiteit)

Toegevoegd in 2026.4.11

​

Optie A: Certificaatgebaseerde authenticatie

1. Genereer of verkrijg een certificaat (PEM-indeling met privésleutel).
2. In Entra ID → App Registration → Certificaten en geheimen → Certificaten → upload het openbare certificaat.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      certificatePath: "/path/to/cert.pem",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_CERTIFICATE_PATH=/path/to/cert.pem

​

Optie B: Azure Managed Identity

1. De bot-pod/VM heeft een beheerde identiteit (door het systeem toegewezen of door de gebruiker toegewezen).
2. Een gefedereerde identiteitscredential koppelt de beheerde identiteit aan de Entra ID-appregistratie.
3. Tijdens runtime gebruikt OpenClaw @azure/identity om tokens op te halen van het Azure IMDS-endpoint (169.254.169.254).
4. Het token wordt doorgegeven aan de Teams SDK voor botauthenticatie.

• Azure-infrastructuur met beheerde identiteit ingeschakeld (AKS workload identity, App Service, VM)
• Gefedereerde identiteitscredential aangemaakt op de Entra ID-appregistratie
• Netwerktoegang tot IMDS (169.254.169.254:80) vanaf de pod/VM

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

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      tenantId: "<TENANT_ID>",
      authType: "federated",
      useManagedIdentity: true,
      managedIdentityClientId: "<MI_CLIENT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

• MSTEAMS_AUTH_TYPE=federated
• MSTEAMS_USE_MANAGED_IDENTITY=true
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID=<client-id> (alleen voor door gebruiker toegewezen)

​

AKS Workload Identity instellen

1. Schakel workload identity in op je AKS-cluster.
2. Maak een federated identity credential op de Entra ID-appregistratie:
   az ad app federated-credential create --id <APP_OBJECT_ID> --parameters '{
     "name": "my-bot-workload-identity",
     "issuer": "<AKS_OIDC_ISSUER_URL>",
     "subject": "system:serviceaccount:<NAMESPACE>:<SERVICE_ACCOUNT>",
     "audiences": ["api://AzureADTokenExchange"]
   }'
   
3. Annoteer het Kubernetes-serviceaccount met de app-client-ID:
   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: my-bot-sa
     annotations:
       azure.workload.identity/client-id: "<APP_CLIENT_ID>"
   
4. Label de pod voor injectie van workload identity:
   metadata:
     labels:
       azure.workload.identity/use: "true"
   
5. Zorg voor netwerktoegang tot IMDS (169.254.169.254) - als je NetworkPolicy gebruikt, voeg dan een egress-regel toe die verkeer naar 169.254.169.254/32 op poort 80 toestaat.

​

Vergelijking van auth-typen

​

Lokale ontwikkeling (tunneling)

# One-time setup:
devtunnel create my-openclaw-bot --allow-anonymous
devtunnel port create my-openclaw-bot -p 3978 --protocol auto

# Each dev session:
devtunnel host my-openclaw-bot

teams app update <teamsAppId> --endpoint "https://<new-url>/api/messages"

​

De Bot testen

teams app doctor <teamsAppId>

1. Installeer de Teams-app (gebruik de installatielink van teams app get <id> --install-link)
2. Zoek de bot in Teams en stuur een DM
3. Controleer de Gateway-logs op inkomende activiteit

​

Omgevingsvariabelen

• MSTEAMS_APP_ID
• MSTEAMS_APP_PASSWORD
• MSTEAMS_TENANT_ID
• MSTEAMS_AUTH_TYPE (optioneel: "secret" of "federated")
• MSTEAMS_CERTIFICATE_PATH (federated + certificaat)
• MSTEAMS_CERTIFICATE_THUMBPRINT (optioneel, niet vereist voor auth)
• MSTEAMS_USE_MANAGED_IDENTITY (federated + managed identity)
• MSTEAMS_MANAGED_IDENTITY_CLIENT_ID (alleen door gebruiker toegewezen MI)

​

Actie voor ledeninformatie

• Member.Read.Group RSC-machtiging (al aanwezig in het aanbevolen manifest)
• Voor lookups over meerdere teams: User.Read.All Graph Application-machtiging met beheerderstoestemming

​

Geschiedeniscontext

• channels.msteams.historyLimit bepaalt hoeveel recente kanaal-/groepsberichten in de prompt worden verpakt.
• Valt terug op messages.groupChat.historyLimit. Stel in op 0 om uit te schakelen (standaard 50).
• Opgehaalde threadgeschiedenis wordt gefilterd op afzender-allowlists (allowFrom / groupAllowFrom), zodat het vullen van threadcontext alleen berichten van toegestane afzenders bevat.
• Context van geciteerde bijlagen (ReplyTo* afgeleid uit Teams-antwoord-HTML) wordt momenteel doorgegeven zoals ontvangen.
• Met andere woorden: allowlists bepalen wie de agent kan activeren; alleen specifieke aanvullende contextpaden worden vandaag gefilterd.
• DM-geschiedenis kan worden beperkt met channels.msteams.dmHistoryLimit (gebruikersbeurten). Overrides per gebruiker: channels.msteams.dms["<user_id>"].historyLimit.

​

Huidige Teams RSC-machtigingen (manifest)

• ChannelMessage.Read.Group (Application) - ontvang alle kanaalberichten zonder @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) - ontvang alle groepschatberichten zonder @mention

teams app rsc add <teamsAppId> ChannelMessage.Read.Group --type Application

​

Voorbeeld van Teams-manifest (geredigeerd)

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

​

Kanttekeningen bij het manifest (vereiste velden)

• bots[].botId moet overeenkomen met de Azure Bot App ID.
• webApplicationInfo.id moet overeenkomen met de Azure Bot App ID.
• bots[].scopes moet de oppervlakken bevatten die je wilt gebruiken (personal, team, groupChat).
• bots[].supportsFiles: true is vereist voor bestandsverwerking in persoonlijk bereik.
• authorization.permissions.resourceSpecific moet kanaallezen/-verzenden bevatten als je kanaalverkeer wilt.

​

Een bestaande app bijwerken

# Download, edit, and re-upload the manifest
teams app manifest download <teamsAppId> manifest.json
# Edit manifest.json locally...
teams app manifest upload manifest.json <teamsAppId>
# Version is auto-bumped if content changed

​

Mogelijkheden: alleen RSC versus Graph

​

Met alleen Teams RSC (app geïnstalleerd, geen Graph API-machtigingen)

• Tekstinhoud van kanaalberichten lezen.
• Tekstinhoud van kanaalberichten verzenden.
• Persoonlijke (DM) bestandsbijlagen ontvangen.

• Afbeeldings- of bestandsinhoud van kanalen/groepen (payload bevat alleen HTML-stub).
• Bijlagen downloaden die zijn opgeslagen in SharePoint/OneDrive.
• Berichtgeschiedenis lezen (buiten de live Webhook-gebeurtenis).

​

Met Teams RSC + Microsoft Graph Application-machtigingen

• Gehoste inhoud downloaden (afbeeldingen die in berichten zijn geplakt).
• Bestandsbijlagen downloaden die zijn opgeslagen in SharePoint/OneDrive.
• Kanaal-/chatberichtgeschiedenis lezen via Graph.

​

RSC versus Graph API

​

Graph-ingeschakelde media + geschiedenis (vereist voor kanalen)

1. Voeg in Entra ID (Azure AD) App Registration Microsoft Graph Application-machtigingen toe:
   • ChannelMessage.Read.All (kanaalbijlagen + geschiedenis)
   • Chat.Read.All of ChatMessage.Read.All (groepschats)
2. Verleen beheerderstoestemming voor de tenant.
3. Verhoog de manifestversie van de Teams-app, upload opnieuw en installeer de app opnieuw in Teams.
4. Sluit Teams volledig af en start het opnieuw om gecachete appmetadata te wissen.

​

Bekende beperkingen

​

Webhook-time-outs

• Gateway-time-outs
• Teams probeert het bericht opnieuw te verzenden (waardoor duplicaten ontstaan)
• Weggevallen antwoorden

​

Ondersteuning voor Teams-cloud en service-URL

• channels.msteams.cloud selecteert de Teams SDK-cloudpreset voor authenticatie, JWT-validatie, tokenservices en Graph-scope.
• channels.msteams.serviceUrl selecteert de Bot Connector-eindpuntgrens die wordt gebruikt om opgeslagen gespreksreferenties te valideren voordat proactieve verzendingen, bewerkingen, verwijderingen, kaarten, polls, berichten voor bestandstoestemming en in de wachtrij geplaatste langdurige antwoorden worden uitgevoerd. Dit is vereist voor USGov- en DoD-SDK-clouds. Voor China/21Vianet gebruikt OpenClaw de SDK-preset China en accepteert het alleen opgeslagen/geconfigureerde service-URL’s op Azure China Bot Framework-kanaalhosts.

{
  "channels": {
    "msteams": {
      "serviceUrl": "https://smba.infra.gcc.teams.microsoft.com/teams"
    }
  }
}

{
  "channels": {
    "msteams": {
      "cloud": "USGov",
      "serviceUrl": "https://smba.infra.gov.teams.microsoft.us/teams"
    }
  }
}

​

Opmaak

• Basisopmaak werkt: vet, cursief, code, links
• Complexe markdown (tabellen, geneste lijsten) wordt mogelijk niet correct weergegeven
• Adaptive Cards worden ondersteund voor polls en semantische presentatieverzendingen (zie hieronder)

​

Configuratie

• channels.msteams.enabled: schakel het kanaal in/uit.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId: botreferenties.
• channels.msteams.cloud: Teams SDK-cloudomgeving (Public, USGov, USGovDoD of China; standaard Public). Stel dit in met serviceUrl voor USGov/DoD-SDK-clouds; China gebruikt de SDK-preset en opgeslagen Azure China Bot Framework-gespreksreferenties, met door Graph ondersteunde helpers uitgeschakeld totdat Azure China Graph-routering is geïmplementeerd.
• channels.msteams.serviceUrl: Bot Connector-service-URL-grens voor proactieve SDK-bewerkingen. De openbare cloud gebruikt de SDK-standaard; stel dit in voor GCC (https://smba.infra.gcc.teams.microsoft.com/teams), GCC High of DoD. China accepteert Azure China Bot Framework-kanaalhosts wanneer de opgeslagen gespreksreferentie afkomstig is van Teams beheerd door 21Vianet.
• channels.msteams.webhook.port (standaard 3978)
• channels.msteams.webhook.path (standaard /api/messages)
• channels.msteams.dmPolicy: pairing | allowlist | open | disabled (standaard: pairing)
• channels.msteams.allowFrom: DM-allowlist (AAD-object-ID’s aanbevolen). De wizard zet namen tijdens de installatie om naar ID’s wanneer Graph-toegang beschikbaar is.
• channels.msteams.dangerouslyAllowNameMatching: noodschakelaar om wijzigbare UPN/weergavenaam-matching en directe team-/kanaalnaamroutering opnieuw in te schakelen.
• channels.msteams.textChunkLimit: chunkgrootte voor uitgaande tekst.
• channels.msteams.chunkMode: length (standaard) of newline om vóór chunking op lengte op lege regels (alinea-grenzen) te splitsen.
• channels.msteams.mediaAllowHosts: allowlist voor hosts van inkomende bijlagen (standaard Microsoft/Teams-domeinen).
• channels.msteams.mediaAuthAllowHosts: allowlist voor het toevoegen van Authorization-headers bij media-retries (standaard Graph + Bot Framework-hosts).
• channels.msteams.requireMention: vereis @mention in kanalen/groepen (standaard true).
• channels.msteams.replyStyle: thread | top-level (zie Antwoordstijl).
• channels.msteams.teams.<teamId>.replyStyle: override per team.
• channels.msteams.teams.<teamId>.requireMention: override per team.
• channels.msteams.teams.<teamId>.tools: standaardoverschrijvingen voor toolbeleid per team (allow/deny/alsoAllow) die worden gebruikt wanneer een kanaaloverride ontbreekt.
• channels.msteams.teams.<teamId>.toolsBySender: standaardoverschrijvingen voor toolbeleid per team per afzender ("*"-wildcard ondersteund).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle: override per kanaal.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention: override per kanaal.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools: overschrijvingen voor toolbeleid per kanaal (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender: overschrijvingen voor toolbeleid per kanaal per afzender ("*"-wildcard ondersteund).
• toolsBySender-sleutels moeten expliciete voorvoegsels gebruiken: channel:, id:, e164:, username:, name: (verouderde sleutels zonder voorvoegsel worden nog steeds alleen aan id: gekoppeld).
• channels.msteams.actions.memberInfo: schakel de door Graph ondersteunde actie voor ledeninformatie in of uit (standaard: ingeschakeld wanneer Graph-referenties beschikbaar zijn).
• channels.msteams.authType: authenticatietype - "secret" (standaard) of "federated".
• channels.msteams.certificatePath: pad naar PEM-certificaatbestand (federated + certificaatauthenticatie).
• channels.msteams.certificateThumbprint: certificaatvingerafdruk (optioneel, niet vereist voor auth).
• channels.msteams.useManagedIdentity: schakel managed identity-authenticatie in (federated-modus).
• channels.msteams.managedIdentityClientId: client-ID voor door de gebruiker toegewezen managed identity.
• channels.msteams.sharePointSiteId: SharePoint-site-ID voor bestandsuploads in groepschats/kanalen (zie Bestanden verzenden in groepschats).

​

Routering en sessies

• Sessiesleutels volgen de standaard agent-indeling (zie /concepts/session):
  • Directe berichten delen de hoofdsessie (agent:<agentId>:<mainKey>).
  • Kanaal-/groepsberichten gebruiken conversation id:
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Antwoordstijl: threads versus posts

• thread in een kanaal met Threads-stijl → antwoorden verschijnen onhandig genest
• top-level in een kanaal met Posts-stijl → antwoorden verschijnen als afzonderlijke posts op het hoogste niveau in plaats van in-thread

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

​

Resolutievolgorde

1. Per kanaal — channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle
2. Per team — channels.msteams.teams.<teamId>.replyStyle
3. Globaal — channels.msteams.replyStyle
4. Impliciete standaard — afgeleid van requireMention:
   • requireMention: true → thread
   • requireMention: false → top-level

​

Behoud van threadcontext

​

Bijlagen en afbeeldingen

• Privéberichten: Afbeeldingen en bestandsbijlagen werken via Teams bot-bestands-API’s.
• Channels/groepen: Bijlagen staan in M365-opslag (SharePoint/OneDrive). De webhook-payload bevat alleen een HTML-stub, niet de daadwerkelijke bestandsbytes. Graph API-machtigingen zijn vereist om channel-bijlagen te downloaden.
• Gebruik voor expliciete bestands-eerst verzendingen action=upload-file met media / filePath / path; optioneel message wordt de begeleidende tekst/opmerking, en filename overschrijft de geüploade naam.

​

Bestanden verzenden in groepschats

​

Waarom groepschats SharePoint nodig hebben

​

Configuratie

1. Voeg Graph API-machtigingen toe in Entra ID (Azure AD) → App Registration:
   • Sites.ReadWrite.All (Application) - upload files to SharePoint
   • Chat.Read.All (Application) - optional, enables per-user sharing links
2. Verleen beheerderstoestemming voor de tenant.
3. Haal je SharePoint-site-ID op:
   # 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. Configureer OpenClaw:
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Deelgedrag

​

Fallback-gedrag

​

Locatie waar bestanden worden opgeslagen

​

Peilingen (Adaptive Cards)

• CLI: openclaw message poll --channel msteams --target conversation:<id> ...
• Stemmen worden door de Gateway vastgelegd in de OpenClaw SQLite voor Plugin-status onder state/openclaw.sqlite.
• Bestaande msteams-polls.json-bestanden worden geïmporteerd door openclaw doctor --fix, niet door de draaiende Plugin.
• De Gateway moet online blijven om stemmen vast te leggen.
• Peilingen plaatsen nog niet automatisch samenvattingen van resultaten, en er is nog geen ondersteunde CLI voor peilingresultaten.

​

Presentatiekaarten

{
  action: "send",
  channel: "msteams",
  target: "user:<id>",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello!" }],
  },
}

openclaw message send --channel msteams \
  --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello!"}]}'

​

Doelformaten

# 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:abc...@thread.tacv2" --message "Hello"

# Send a presentation card to a conversation
openclaw message send --channel msteams --target "conversation:19:abc...@thread.tacv2" \
  --presentation '{"title":"Hello","blocks":[{"type":"text","text":"Hello"}]}'

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

{
  action: "send",
  channel: "msteams",
  target: "conversation:19:abc...@thread.tacv2",
  presentation: {
    title: "Hello",
    blocks: [{ type: "text", text: "Hello" }],
  },
}

​

Proactieve berichten

• Proactieve berichten zijn alleen mogelijk nadat een gebruiker interactie heeft gehad, omdat we op dat moment gespreksreferenties opslaan.
• Zie /gateway/configuration voor dmPolicy en allowlist-poorten.

​

Team- en channel-ID’s (veelvoorkomende valkuil)

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

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

• Teamsleutel = padsegment na /team/ (URL-gedecodeerd, bijv. 19:Bk4j...@thread.tacv2; oudere tenants kunnen @thread.skype tonen, wat ook geldig is)
• Channelsleutel = padsegment na /channel/ (URL-gedecodeerd)
• Negeer de queryparameter groupId voor OpenClaw-routering. Dit is de Microsoft Entra-groep-ID, niet de Bot Framework-gespreks-ID die in inkomende Teams-activiteiten wordt gebruikt.

​

Privéchannels

1. Gebruik standaardchannels voor botinteracties
2. Gebruik privéberichten - gebruikers kunnen de bot altijd rechtstreeks berichten
3. Gebruik Graph API voor historische toegang (vereist ChannelMessage.Read.All)

​

Probleemoplossing

​

Veelvoorkomende problemen

• Afbeeldingen worden niet weergegeven in channels: Graph-machtigingen of beheerderstoestemming ontbreken. Installeer de Teams-app opnieuw en sluit Teams volledig af en open het opnieuw.
• Geen reacties in channel: vermeldingen zijn standaard vereist; stel channels.msteams.requireMention=false in of configureer dit per team/channel.
• Versiemismatch (Teams toont nog steeds oud manifest): verwijder de app, voeg deze opnieuw toe en sluit Teams volledig af om te vernieuwen.
• 401 Unauthorized van webhook: Verwacht bij handmatig testen zonder Azure JWT - betekent dat het eindpunt bereikbaar is, maar autorisatie is mislukt. Gebruik Azure Web Chat om correct te testen.

​

Fouten bij manifest-upload

• “Icon file cannot be empty”: Het manifest verwijst naar pictogrambestanden die 0 bytes zijn. Maak geldige PNG-pictogrammen (32x32 voor outline.png, 192x192 voor color.png).
• “webApplicationInfo.Id already in use”: De app is nog geïnstalleerd in een ander team/chat. Zoek deze en verwijder deze eerst, of wacht 5-10 minuten op propagatie.
• “Something went wrong” bij uploaden: Upload in plaats daarvan via https://admin.teams.microsoft.com, open browser-DevTools (F12) → tabblad Network, en controleer de response body op de daadwerkelijke fout.
• Sideload mislukt: Probeer “Upload an app to your org’s app catalog” in plaats van “Upload a custom app” - dit omzeilt vaak sideload-beperkingen.

​

RSC-machtigingen werken niet

1. Controleer of webApplicationInfo.id exact overeenkomt met de App ID van je bot
2. Upload de app opnieuw en installeer deze opnieuw in het team/de chat
3. Controleer of je organisatiebeheerder RSC-machtigingen heeft geblokkeerd
4. Bevestig dat je het juiste bereik gebruikt: ChannelMessage.Read.Group voor Teams, ChatMessage.Read.Chat voor groepschats

​

Verwijzingen

• Azure Bot maken - installatiehandleiding voor Azure Bot
• Teams-ontwikkelaarsportal - Teams-apps maken/beheren
• Teams-appmanifestschema
• Kanaalberichten ontvangen met RSC
• RSC-machtigingenreferentie
• Bestandsafhandeling voor Teams-bots (kanaal/groep vereist Graph)
• Proactieve berichten
• @microsoft/teams.cli - Teams CLI voor botbeheer

​

Gerelateerd

• Overzicht van kanalen - alle ondersteunde kanalen
• Koppelen - DM-authenticatie en koppelingsflow
• Groepen - gedrag van groepschats en vermeldingstoegang
• Kanaalroutering - sessieroutering voor berichten
• Beveiliging - toegangsmodel en hardening