improvement(ms-teams): resolve mentions accurately (#1762)

* improvement(ms-teams): resolve mentions accurately

* fix for bots

* add utils file

* add logs

* fix perms issue

* fix scopes

* fetch works for bots

* Revert "fetch works for bots"

This reverts commit 0ac702a.

* update docs

Author: icecrasher321

apps/docs/content/docs/en/tools/microsoft_teams.mdx

@@ -208,3 +208,13 @@ Write or send a message to a Microsoft Teams channel
 
 - Category: `tools`
 - Type: `microsoft_teams`
+
+### Mentioning Users
+
+To mention users in your messages (both in chats and channels), wrap their display name in `<at>` tags:
+
+```
+<at>John Doe</at> can you review this?
+```
+
+The mention will be automatically resolved to the correct user and they will receive a notification in Microsoft Teams. This works for both chat messages and channel messages. Bots/Apps cannot be tagged.

apps/sim/app/api/tools/microsoft_teams/write_channel/route.ts

@@ -5,6 +5,7 @@ import { createLogger } from '@/lib/logs/console/logger'
 import { processFilesToUserFiles } from '@/lib/uploads/utils/file-utils'
 import { downloadFileFromStorage } from '@/lib/uploads/utils/file-utils.server'
 import { generateRequestId } from '@/lib/utils'
+import { resolveMentionsForChannel, type TeamsMention } from '@/tools/microsoft_teams/utils'
 
 export const dynamic = 'force-dynamic'
 
@@ -141,23 +142,55 @@ export async function POST(request: NextRequest) {
     }
 
     let messageContent = validatedData.content
+    let contentType: 'text' | 'html' = 'text'
+    const mentionEntities: TeamsMention[] = []
+
+    try {
+      const mentionResult = await resolveMentionsForChannel(
+        validatedData.content,
+        validatedData.teamId,
+        validatedData.channelId,
+        validatedData.accessToken
+      )
+
+      if (mentionResult.hasMentions) {
+        contentType = 'html'
+        messageContent = mentionResult.updatedContent
+        mentionEntities.push(...mentionResult.mentions)
+        logger.info(`[${requestId}] Resolved ${mentionResult.mentions.length} mention(s)`)
+      }
+    } catch (error) {
+      logger.warn(`[${requestId}] Failed to resolve mentions, continuing without them:`, error)
+    }
 
     if (attachments.length > 0) {
+      contentType = 'html'
       const attachmentTags = attachments
         .map((att) => `<attachment id="${att.id}"></attachment>`)
         .join(' ')
-      messageContent = `${validatedData.content}<br/>${attachmentTags}`
+      messageContent = `${messageContent}<br/>${attachmentTags}`
     }
 
-    const messageBody = {
+    const messageBody: {
       body: {
-        contentType: attachments.length > 0 ? 'html' : 'text',
+        contentType: 'text' | 'html'
+        content: string
+      }
+      attachments?: any[]
+      mentions?: TeamsMention[]
+    } = {
+      body: {
+        contentType,
         content: messageContent,
       },
     }
 
     if (attachments.length > 0) {
-      ;(messageBody as any).attachments = attachments
+      messageBody.attachments = attachments
+    }
+
+    if (mentionEntities.length > 0) {
+      messageBody.mentions = mentionEntities
     }
 
     logger.info(`[${requestId}] Sending message to Teams channel: ${validatedData.channelId}`)

apps/sim/app/api/tools/microsoft_teams/write_chat/route.ts

@@ -5,6 +5,7 @@ import { createLogger } from '@/lib/logs/console/logger'
 import { processFilesToUserFiles } from '@/lib/uploads/utils/file-utils'
 import { downloadFileFromStorage } from '@/lib/uploads/utils/file-utils.server'
 import { generateRequestId } from '@/lib/utils'
+import { resolveMentionsForChat, type TeamsMention } from '@/tools/microsoft_teams/utils'
 
 export const dynamic = 'force-dynamic'
 
@@ -139,23 +140,54 @@ export async function POST(request: NextRequest) {
     }
 
     let messageContent = validatedData.content
+    let contentType: 'text' | 'html' = 'text'
+    const mentionEntities: TeamsMention[] = []
+
+    try {
+      const mentionResult = await resolveMentionsForChat(
+        validatedData.content,
+        validatedData.chatId,
+        validatedData.accessToken
+      )
+
+      if (mentionResult.hasMentions) {
+        contentType = 'html'
+        messageContent = mentionResult.updatedContent
+        mentionEntities.push(...mentionResult.mentions)
+        logger.info(`[${requestId}] Resolved ${mentionResult.mentions.length} mention(s)`)
+      }
+    } catch (error) {
+      logger.warn(`[${requestId}] Failed to resolve mentions, continuing without them:`, error)
+    }
 
     if (attachments.length > 0) {
+      contentType = 'html'
       const attachmentTags = attachments
         .map((att) => `<attachment id="${att.id}"></attachment>`)
         .join(' ')
-      messageContent = `${validatedData.content}<br/>${attachmentTags}`
+      messageContent = `${messageContent}<br/>${attachmentTags}`
     }
 
-    const messageBody = {
+    const messageBody: {
       body: {
-        contentType: attachments.length > 0 ? 'html' : 'text',
+        contentType: 'text' | 'html'
+        content: string
+      }
+      attachments?: any[]
+      mentions?: TeamsMention[]
+    } = {
+      body: {
+        contentType,
         content: messageContent,
       },
     }
 
     if (attachments.length > 0) {
-      ;(messageBody as any).attachments = attachments
+      messageBody.attachments = attachments
+    }
+
+    if (mentionEntities.length > 0) {
+      messageBody.mentions = mentionEntities
     }
 
     logger.info(`[${requestId}] Sending message to Teams chat: ${validatedData.chatId}`)

apps/sim/blocks/blocks/microsoft_teams.ts

@@ -9,7 +9,7 @@ export const MicrosoftTeamsBlock: BlockConfig<MicrosoftTeamsResponse> = {
   description: 'Read, write, and create messages',
   authMode: AuthMode.OAuth,
   longDescription:
-    'Integrate Microsoft Teams into the workflow. Can read and write chat messages, and read and write channel messages. Can be used in trigger mode to trigger a workflow when a message is sent to a chat or channel.',
+    'Integrate Microsoft Teams into the workflow. Can read and write chat messages, and read and write channel messages. Can be used in trigger mode to trigger a workflow when a message is sent to a chat or channel. To mention users in messages, wrap their name in <at> tags: <at>userName</at>',
   docsLink: 'https://docs.sim.ai/tools/microsoft_teams',
   category: 'tools',
   triggerAllowed: true,
@@ -47,6 +47,7 @@ export const MicrosoftTeamsBlock: BlockConfig<MicrosoftTeamsResponse> = {
         'Channel.ReadBasic.All',
         'ChannelMessage.Send',
         'ChannelMessage.Read.All',
+        'ChannelMember.Read.All',
         'Group.Read.All',
         'Group.ReadWrite.All',
         'Team.ReadBasic.All',
@@ -255,7 +256,10 @@ export const MicrosoftTeamsBlock: BlockConfig<MicrosoftTeamsResponse> = {
     manualChannelId: { type: 'string', description: 'Manual channel identifier' },
     teamId: { type: 'string', description: 'Team identifier' },
     manualTeamId: { type: 'string', description: 'Manual team identifier' },
-    content: { type: 'string', description: 'Message content' },
+    content: {
+      type: 'string',
+      description: 'Message content. Mention users with <at>userName</at>',
+    },
     attachmentFiles: { type: 'json', description: 'Files to attach (UI upload)' },
     files: { type: 'json', description: 'Files to attach (UserFile array)' },
   },

apps/sim/lib/auth.ts

@@ -512,6 +512,7 @@ export const auth = betterAuth({
             'Channel.ReadBasic.All',
             'ChannelMessage.Send',
             'ChannelMessage.Read.All',
+            'ChannelMember.Read.All',
             'Group.Read.All',
             'Group.ReadWrite.All',
             'Team.ReadBasic.All',

apps/sim/lib/oauth/oauth.ts

@@ -239,6 +239,7 @@ export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
           'Channel.ReadBasic.All',
           'ChannelMessage.Send',
           'ChannelMessage.Read.All',
+          'ChannelMember.Read.All',
           'Group.Read.All',
           'Group.ReadWrite.All',
           'Team.ReadBasic.All',