Mandala
Tools

Microsoft Teams

Manage messages, reactions, and members in Teams

Usage Instructions

Integrate Microsoft Teams into the workflow. Read, write, update, and delete chat and channel messages. Reply to messages, add reactions, and list team/channel members. 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>

Tools

microsoft_teams_read_chat

Read content from a Microsoft Teams chat

Input

ParameterTypeRequiredDescription
chatIdstringYesThe ID of the chat to read from
includeAttachmentsbooleanNoDownload and include message attachments (hosted contents) into storage

Output

ParameterTypeDescription
successbooleanTeams chat read operation success status
messageCountnumberNumber of messages retrieved from chat
chatIdstringID of the chat that was read from
messagesarrayArray of chat message objects
attachmentCountnumberTotal number of attachments found
attachmentTypesarrayTypes of attachments found
contentstringFormatted content of chat messages
attachmentsfile[]Uploaded attachments for convenience (flattened)

microsoft_teams_write_chat

Write or update content in a Microsoft Teams chat

Input

ParameterTypeRequiredDescription
chatIdstringYesThe ID of the chat to write to
contentstringYesThe content to write to the message
filesfile[]NoFiles to attach to the message

Output

ParameterTypeDescription
successbooleanTeams chat message send success status
messageIdstringUnique identifier for the sent message
chatIdstringID of the chat where message was sent
createdTimestringTimestamp when message was created
urlstringWeb URL to the message
updatedContentbooleanWhether content was successfully updated

microsoft_teams_read_channel

Read content from a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team to read from
channelIdstringYesThe ID of the channel to read from
includeAttachmentsbooleanNoDownload and include message attachments (hosted contents) into storage

Output

ParameterTypeDescription
successbooleanTeams channel read operation success status
messageCountnumberNumber of messages retrieved from channel
teamIdstringID of the team that was read from
channelIdstringID of the channel that was read from
messagesarrayArray of channel message objects
attachmentCountnumberTotal number of attachments found
attachmentTypesarrayTypes of attachments found
contentstringFormatted content of channel messages
attachmentsfile[]Uploaded attachments for convenience (flattened)

microsoft_teams_write_channel

Write or send a message to a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team to write to
channelIdstringYesThe ID of the channel to write to
contentstringYesThe content to write to the channel
filesfile[]NoFiles to attach to the message

Output

ParameterTypeDescription
successbooleanTeams channel message send success status
messageIdstringUnique identifier for the sent message
teamIdstringID of the team where message was sent
channelIdstringID of the channel where message was sent
createdTimestringTimestamp when message was created
urlstringWeb URL to the message
updatedContentbooleanWhether content was successfully updated

microsoft_teams_update_chat_message

Update an existing message in a Microsoft Teams chat

Input

ParameterTypeRequiredDescription
chatIdstringYesThe ID of the chat containing the message
messageIdstringYesThe ID of the message to update
contentstringYesThe new content for the message

Output

ParameterTypeDescription
successbooleanWhether the update was successful
messageIdstringID of the updated message
updatedContentbooleanWhether content was successfully updated

microsoft_teams_update_channel_message

Update an existing message in a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team
channelIdstringYesThe ID of the channel containing the message
messageIdstringYesThe ID of the message to update
contentstringYesThe new content for the message

Output

ParameterTypeDescription
successbooleanWhether the update was successful
messageIdstringID of the updated message
updatedContentbooleanWhether content was successfully updated

microsoft_teams_delete_chat_message

Soft delete a message in a Microsoft Teams chat

Input

ParameterTypeRequiredDescription
chatIdstringYesThe ID of the chat containing the message
messageIdstringYesThe ID of the message to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful
deletedbooleanConfirmation of deletion
messageIdstringID of the deleted message

microsoft_teams_delete_channel_message

Soft delete a message in a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team
channelIdstringYesThe ID of the channel containing the message
messageIdstringYesThe ID of the message to delete

Output

ParameterTypeDescription
successbooleanWhether the deletion was successful
deletedbooleanConfirmation of deletion
messageIdstringID of the deleted message

microsoft_teams_reply_to_message

Reply to an existing message in a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team
channelIdstringYesThe ID of the channel
messageIdstringYesThe ID of the message to reply to
contentstringYesThe reply content

Output

ParameterTypeDescription
successbooleanWhether the reply was successful
messageIdstringID of the reply message
updatedContentbooleanWhether content was successfully sent

microsoft_teams_get_message

Get a specific message from a Microsoft Teams chat or channel

Input

ParameterTypeRequiredDescription
teamIdstringNoThe ID of the team (for channel messages)
channelIdstringNoThe ID of the channel (for channel messages)
chatIdstringNoThe ID of the chat (for chat messages)
messageIdstringYesThe ID of the message to retrieve

Output

ParameterTypeDescription
successbooleanWhether the retrieval was successful
contentstringThe message content
metadataobjectMessage metadata including sender, timestamp, etc.

microsoft_teams_set_reaction

Add an emoji reaction to a message in Microsoft Teams

Input

ParameterTypeRequiredDescription
teamIdstringNoThe ID of the team (for channel messages)
channelIdstringNoThe ID of the channel (for channel messages)
chatIdstringNoThe ID of the chat (for chat messages)
messageIdstringYesThe ID of the message to react to
reactionTypestringYesThe emoji reaction (e.g., ❤️, 👍, 😊)

Output

ParameterTypeDescription
successbooleanWhether the reaction was added successfully
reactionTypestringThe emoji that was added
messageIdstringID of the message

microsoft_teams_unset_reaction

Remove an emoji reaction from a message in Microsoft Teams

Input

ParameterTypeRequiredDescription
teamIdstringNoThe ID of the team (for channel messages)
channelIdstringNoThe ID of the channel (for channel messages)
chatIdstringNoThe ID of the chat (for chat messages)
messageIdstringYesThe ID of the message
reactionTypestringYesThe emoji reaction to remove (e.g., ❤️, 👍, 😊)

Output

ParameterTypeDescription
successbooleanWhether the reaction was removed successfully
reactionTypestringThe emoji that was removed
messageIdstringID of the message

microsoft_teams_list_team_members

List all members of a Microsoft Teams team

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team

Output

ParameterTypeDescription
successbooleanWhether the listing was successful
membersarrayArray of team members
memberCountnumberTotal number of members

microsoft_teams_list_channel_members

List all members of a Microsoft Teams channel

Input

ParameterTypeRequiredDescription
teamIdstringYesThe ID of the team
channelIdstringYesThe ID of the channel

Output

ParameterTypeDescription
successbooleanWhether the listing was successful
membersarrayArray of channel members
memberCountnumberTotal number of members

Triggers

microsoftteams_webhook

Trigger workflow from Microsoft Teams channel messages via outgoing webhooks

Output

ParameterTypeDescription
from.idstringSender ID
from.namestringSender name
from.aadObjectIdstringAAD Object ID
message.raw.attachmentsarrayArray of attachments
message.raw.channelData.team.idstringTeam ID
message.raw.channelData.tenant.idstringTenant ID
message.raw.channelData.channel.idstringChannel ID
message.raw.channelData.teamsTeamIdstringTeams team ID
message.raw.channelData.teamsChannelIdstringTeams channel ID
message.raw.conversation.idstringComposite conversation ID
message.raw.conversation.namestringConversation name (nullable)
message.raw.conversation.isGroupbooleanIs group conversation
message.raw.conversation.tenantIdstringTenant ID
message.raw.conversation.aadObjectIdstringAAD Object ID (nullable)
message.raw.conversation.conversationTypestringConversation type (channel)
message.raw.textstringMessage text content
message.raw.messageTypestringMessage type
message.raw.channelIdstringChannel ID (msteams)
message.raw.timestampstringTimestamp
activityobjectActivity payload
conversation.idstringComposite conversation ID
conversation.namestringConversation name (nullable)
conversation.isGroupbooleanIs group conversation
conversation.tenantIdstringTenant ID
conversation.aadObjectIdstringAAD Object ID (nullable)
conversation.conversationTypestringConversation type (channel)

microsoftteams_chat_subscription

Trigger workflow from new messages in Microsoft Teams chats via Microsoft Graph subscriptions

Output

ParameterTypeDescription
message_idstringMessage ID
chat_idstringChat ID
from_namestringSender display name
textstringMessage body (HTML or text)
created_atstringMessage timestamp
attachmentsfile[]Uploaded attachments as files

Notes

  • Category: tools
  • Type: microsoft_teams
Microsoft Teams