category: Messaging and Conferencing provider: Microsoft sectionorder: - Connect - Collect commonfields: id: Microsoft Teams version: -1 configuration: - display: "Bot ID" name: credentials type: 9 section: Connect displaypassword: "Bot Password" required: false - display: Bot ID name: bot_id type: 0 section: Connect hidden: true required: false - display: Bot Password name: bot_password type: 4 section: Connect hidden: true required: false - display: Authentication Type additionalinfo: |- When switching from the 'Client Credentials Flow' to the 'Authorization Code Flow' do as follow: Save the instance, run the 'microsoft-teams-generate-login-url' command and follow the instructions mentioned there. Once done, test the validity of your instance by running the 'microsoft-teams-auth-test' command. When switching from the 'Authorization Code Flow' to the 'Client Credentials Flow', test the validity of the instance by clicking the 'Test' button. name: auth_type type: 15 defaultvalue: Client Credentials options: - Client Credentials - Authorization Code section: Connect required: false - display: Application redirect URI (for Authorization Code mode) name: redirect_uri type: 0 section: Connect required: false - display: '' name: auth_code_creds type: 9 displaypassword: Authorization code hiddenusername: true section: Connect required: false - display: Default team name: team required: true type: 0 section: Connect - display: Notifications channel name: incident_notifications_channel required: true type: 0 defaultvalue: General section: Connect - display: Certificate (Required for HTTPS) name: creds_certificate type: 9 section: Connect advanced: true displaypassword: Private Key (Required for HTTPS) required: false - display: Certificate (Required for HTTPS) name: certificate type: 12 section: Connect advanced: true hidden: true required: false - display: Private Key (Required for HTTPS) name: key type: 14 section: Connect advanced: true hidden: true required: false - display: Bot Type Converted to Single-Tenant name: is_single_tenant_bot_type type: 8 section: Connect additionalinfo: Select this option if the bot was originally created as multi-tenant and later converted to single-tenant. The system will detect the bot type automatically in all other standard cases. advanced: true required: false - display: Minimum incident severity to send notifications to Teams by name: min_incident_severity type: 15 section: Collect advanced: true defaultvalue: 'Low' options: - Unknown - Informational - Low - Medium - High - Critical required: false hidden: - marketplacev2 - platform - display: Disable Automatic Notifications name: auto_notifications type: 8 section: Connect advanced: true additionalinfo: Whether to disable automatic notifications to the configured notifications channel. defaultvalue: 'false' required: false - display: Allow external users to create incidents via direct message name: allow_external_incidents_creation type: 8 section: Collect advanced: true required: false - display: The header of an external form hyperlink. name: external_form_url_header type: 0 section: Connect defaultvalue: Microsoft Teams Form required: false - display: Trust any certificate (not secure) additionalinfo: Do not check for Cortex XSOAR version 8 name: insecure type: 8 section: Connect advanced: true required: false - display: Use system proxy settings name: proxy type: 8 section: Connect advanced: true required: false - additionalinfo: 'Optional - Welcome message when creating new incidents using the bot. If left empty (default option) the current default welcome message will be used, i.e., "Successfully created incident . View it on: ". If the parameter is set to "no_welcome_message" value, no message will be displayed. Any non-empty string value set will be used as the custom new incident welcome message.' defaultvalue: 'Successfully created incident . View it on: ' display: Custom New Incident Welcome Message name: new_incident_welcome_message required: false type: 0 section: Connect - display: Long running instance name: longRunning type: 8 section: Connect required: false - display: Listen port additionalinfo: E.g., 7000 (Required for investigation mirroring and direct messages). name: longRunningPort type: 0 section: Connect required: false - display: Incident type name: incidentType type: 13 section: Connect required: false description: Send messages and notifications to your team members. display: Microsoft Teams name: Microsoft Teams script: commands: - arguments: - description: The channel to which to send messages. Supports only standard channels. name: channel - description: The message to send to the channel or team member. name: message - description: Display name or email address of the team member to send the message to. name: team_member - description: The team in which the specified channel exists. The team must already exist, and this value will override the default channel configured in the integration parameters. name: team - description: ID of the message to send the notification to as a reply when sending to a channel. name: message_id - description: The Microsoft Teams adaptive card to send. name: adaptive_card - description: The team member to which to send the message. name: to - description: The header of an external form hyperlink. defaultValue: "Microsoft Teams Form" name: external_form_url_header description: |- Sends a message to the specified teams. To mention a user in the message, add a semicolon ";" at the end of the user mention. For example: @Bruce Willis;. If sending a reply to a message, the message ID must be provided and the reply will be sent via the Graph API which means the message will appear from the account used to authorize the integration instance and not the bot. Setting the account's name and picture to match the bot will make it appear to be from the same source. name: send-notification outputs: - contextPath: MicrosoftTeams.Message.ID description: ID of the message sent. type: String - arguments: - auto: PREDEFINED default: true defaultValue: all description: The mirroring type. Can be "all", which mirrors everything, "chat", which mirrors only chats (not commands), or "none", which stops all mirroring. name: mirror_type predefined: - all - chat - none - auto: PREDEFINED defaultValue: 'true' description: Whether to auto-close the channel when the incident is closed in XSOAR. If "true", the channel will be auto-closed. Default is "true". name: autoclose predefined: - 'true' - 'false' - auto: PREDEFINED defaultValue: both description: The mirroring direction. Can be "FromDemisto", "ToDemisto", or "Both". name: direction predefined: - Both - FromDemisto - ToDemisto - description: The team in which to mirror the XSOAR investigation. If not specified, the default team configured in the integration parameters will be used. name: team - description: The name of the channel. The default is "incident-". name: channel_name description: Mirrors the XSOAR investigation to the specified Microsoft Teams channel. Supports only standard channels. name: mirror-investigation - arguments: - description: The name of the channel to close. name: channel - description: The channel's team. name: team description: Deletes the specified Microsoft Teams channel. name: close-channel - description: Returns real-time and historical data on the integration status. name: microsoft-teams-integration-health arguments: [] - arguments: [] description: Tests the connectivity to MicrosoftTeams. name: microsoft-teams-auth-test - arguments: - description: The name of the channel. The name must be unique. name: channel_name required: true - description: The description of the channel. name: description - description: The team in which to create the channel. name: team required: true deprecated: true description: Creates a new channel in a Microsoft Teams team. name: create-channel - arguments: - description: The channel to which to add the add the member to this channel. name: channel required: true - description: The channel's team. name: team required: true - description: The display name of the member to add to the channel. name: member required: true description: Adds a member (user) to a private/shared channel. name: add-user-to-channel deprecated: true - arguments: - description: The display name of the member to call. name: username required: true description: 'Ring a user''s Teams account. Note: This is a ring only! no media will play in case the generated call is answered. To use this make sure your Bot has the following permissions - Calls.Initiate.All and Calls.InitiateGroupCall.All' name: microsoft-teams-ring-user - arguments: - description: The channel to which to add the member. name: channel required: true - description: The channel's team. name: team required: true - description: The display name of the member to add to the channel. name: member required: true - description: Whether to add the member with the owner role. name: owner auto: PREDEFINED predefined: - 'true' - 'false' defaultValue: false description: Adds a member (user) to a private/shared channel. name: microsoft-teams-add-user-to-channel - arguments: - description: The name of the channel. The name must be unique. name: channel_name required: true - description: The team in which to create the channel. name: team required: true - description: The description of the channel. name: description - description: The type of the channel. name: membership_type auto: PREDEFINED predefined: - 'private' - 'standard' - 'shared' defaultValue: 'standard' - description: The channel owner (Display name/mail/UPN). name: owner_user description: Creates a new channel in a Microsoft Teams team. name: microsoft-teams-create-channel - arguments: - description: The meeting start time in ISO 8601 format e.g., "2019-07-12T14:30:34.2444915-07:00". name: start_time - description: The meeting end time in ISO 8601 format e.g., "2019-07-12T14:30:34.2444915-07:00". name: end_time - description: The meeting subject. name: subject required: true - description: Display name/mail/UPN of user who created the meeting, e.g., Adam Smith. Note, when using Authorization Code Flow, the member must be the user who initiated the login request. name: member required: true description: Creates a new meeting in Microsoft Teams. name: microsoft-teams-create-meeting outputs: - contextPath: MicrosoftTeams.CreateMeeting.creationDateTime description: Meeting creation time. type: Date - contextPath: MicrosoftTeams.CreateMeeting.threadId description: Meeting thread ID. type: String - contextPath: MicrosoftTeams.CreateMeeting.messageId description: Meeting message ID. type: String - contextPath: MicrosoftTeams.CreateMeeting.id description: Meeting ID. type: String - contextPath: MicrosoftTeams.CreateMeeting.joinWebUrl description: The URL to join the meeting. type: String - contextPath: MicrosoftTeams.CreateMeeting.participantId description: The meeting participants. type: String - contextPath: MicrosoftTeams.CreateMeeting.participantDisplayName description: The display name of the participants. type: String - arguments: - description: The name of the channel. name: channel_name required: true - description: The name of the channel's team. name: team required: true - description: The display name of the member to remove from the channel. name: member required: true description: Removes a member (user) from a private/shared channel. name: microsoft-teams-user-remove-from-channel - arguments: - description: The name of the channel. name: channel_name required: true - description: The name of the channel's team. name: team required: true description: Retrieves a list of members from a channel. name: microsoft-teams-channel-user-list outputs: - contextPath: MicrosoftTeams.ChannelList.channelId description: The channel ID. type: String - contextPath: MicrosoftTeams.ChannelList.channelName description: The name of the channel. type: String - contextPath: MicrosoftTeams.ChannelList.members.displayName description: The display name of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.email description: The email of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.id description: The ID of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.roles description: The roles of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.tenantId description: The tenant ID of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.userId description: The user ID of the members. type: String - contextPath: MicrosoftTeams.ChannelList.members.visibleHistoryStartDateTime description: The timestamp denoting how far back a conversation's history is shared with the conversation member. type: String - arguments: - description: Specifies the type of chat. name: chat_type required: true auto: PREDEFINED predefined: - 'group' - 'oneOnOne' defaultValue: 'group' - description: Display name/mail/UPN of user that should be added to the chat. Can be an array. name: member isArray: true - description: The title of the chat. The chat title can be provided only if the chat is of group type. name: chat_name description: |- Creates a new chat. Note: Only one oneOnOne chat can exist between two members. If a oneOnOne chat already exists, it will be returned. name: microsoft-teams-chat-create outputs: - contextPath: MicrosoftTeams.ChatList.chatId description: The chat's unique identifier. type: String - contextPath: MicrosoftTeams.ChatList.topic description: Subject or topic for the chat. Only available for group chats. type: String - contextPath: MicrosoftTeams.ChatList.createdDateTime description: Date and time when the chat was created. type: String - contextPath: MicrosoftTeams.ChatList.lastUpdatedDateTime description: Date and time when the chat was renamed or list of members were last changed. type: String - contextPath: MicrosoftTeams.ChatList.chatType description: Specifies the type of chat. type: String - contextPath: MicrosoftTeams.ChatList.webUrl description: The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. type: String - contextPath: MicrosoftTeams.ChatList.tenantId description: The identifier of the tenant in which the chat was created. type: String - contextPath: MicrosoftTeams.ChatList.viewpoint description: Represents caller-specific information about the chat, such as last message read date and time. type: String - contextPath: MicrosoftTeams.ChatList.onlineMeetingInfo description: Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. type: String - arguments: - description: The chat ID / group chat name (topic) / oneOnOne member (Display name/mail/UPN). Note - the consent user must be a member of the chat. name: chat required: true - description: The content of the chat message. name: content required: true - description: The message content type. name: content_type auto: PREDEFINED predefined: - 'text' - 'html' defaultValue: 'text' description: |- Sends a new chat message in the specified chat. Notes: - This command works with the consent user, not with the bot. Which means, the message is sent to the given chat by the consent user, not the bot. - This command will fail if the consent user is not a member of the destination chat. - This command may fail if the bot app has not yet appeared in the "built for your org" section in teams. - This command can only send messages from type 'message'. name: microsoft-teams-message-send-to-chat outputs: - contextPath: MicrosoftTeams.ChatList.chatId description: The chat's unique identifier. type: String - contextPath: MicrosoftTeams.ChatList.messages.id description: Unique ID of the message. type: String - contextPath: MicrosoftTeams.ChatList.messages.replyToId description: ID of the parent chat message or root chat message of the thread. type: String - contextPath: MicrosoftTeams.ChatList.messages.etag description: Version number of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.messageType description: The type of chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.createdDateTime description: Timestamp of when the chat message was created. type: String - contextPath: MicrosoftTeams.ChatList.messages.lastModifiedDateTime description: Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed. type: String - contextPath: MicrosoftTeams.ChatList.messages.lastEditedDateTime description: Timestamp when edits to the chat message were made. Triggers an "Edited" flag in the Teams UI. If no edits are made the value is null. type: String - contextPath: MicrosoftTeams.ChatList.messages.deletedDateTime description: Timestamp when the chat message was deleted, or null if not deleted. type: String - contextPath: MicrosoftTeams.ChatList.messages.subject description: The subject of the chat message, in plaintext. type: String - contextPath: MicrosoftTeams.ChatList.messages.summary description: Summary text of the chat message that could be used for push notifications and summary views or fall back views. type: String - contextPath: MicrosoftTeams.ChatList.messages.chatId description: If the message was sent in a chat, represents the identity of the chat. type: String - contextPath: MicrosoftTeams.ChatList.messages.importance description: The importance of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.locale description: Locale of the chat message set by the client. type: String - contextPath: MicrosoftTeams.ChatList.messages.webUrl description: Link to the message in Microsoft Teams. type: String - contextPath: MicrosoftTeams.ChatList.messages.channelIdentity description: If the message was sent in a channel, represents the identity of the channel. type: String - contextPath: MicrosoftTeams.ChatList.messages.policyViolation description: Defines the properties of a policy violation set by a data loss prevention (DLP) application. type: String - contextPath: MicrosoftTeams.ChatList.messages.eventDetail description: If present, represents details of an event that happened in a chat, a channel, or a team, for example, adding new members. type: String - contextPath: MicrosoftTeams.ChatList.messages.from description: Details of the sender of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.body description: Plaintext/HTML representation of the content of the chat message. Representation is specified by the contentType inside the body. type: String - contextPath: MicrosoftTeams.ChatList.messages.attachments description: References to attached objects like files, tabs, meetings, etc. type: String - contextPath: MicrosoftTeams.ChatList.messages.mentions description: List of entities mentioned in the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.reactions description: Reactions for this chat message (for example, Like). type: String - arguments: - description: The chat ID or group chat name (topic) to which to add the member. Note - the consent user must be a member of the chat. name: chat required: true - description: Display name/mail/UPN of user that should be added to the chat. Can be an array. name: member required: true isArray: true - description: Whether to share the whole history of the chat. name: share_history auto: PREDEFINED predefined: - 'true' - 'false' defaultValue: true description: |- Adds a member (user) to a group chat. Notes: - This command works with the consent user, not with the bot. Which means, the member will be added to the given chat by the consent user, not the bot. - This command will fail if the consent user is not a member of the destination chat. name: microsoft-teams-chat-add-user - arguments: - description: The chat ID / group chat name (topic) / oneOnOne member (Display name/mail/UPN). Note - the consent user must be a member of the chat. name: chat required: true description: |- Retrieves a list of members from a chat. Notes: - This command works with the consent user, not with the bot. Which means, that the chat must include the consent user. name: microsoft-teams-chat-member-list outputs: - contextPath: MicrosoftTeams.ChatList.chatId description: The chat's unique identifier. type: String - contextPath: MicrosoftTeams.ChatList.members.displayName description: The display name of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.email description: The email of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.id description: The ID of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.roles description: The roles of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.tenantId description: The tenant ID of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.userId description: The user ID of the members. type: String - contextPath: MicrosoftTeams.ChatList.members.visibleHistoryStartDateTime description: The timestamp denoting how far back a conversation's history is shared with the conversation member. type: String - arguments: - description: ID of the message to update. Also referred to as Activity ID. name: message_id required: true - description: The team in which the specified message exists. name: team - description: The channel in which the specified message exists. name: channel - description: The new message content. name: message - description: The message recipient. Accepts the team member's email address or username. name: team_member - description: Whether or not an adaptive card is being updated. name: format_as_card outputs: - contextPath: MicrosoftTeams.Message.ID description: ID of the message sent. type: String description: Updates a message. name: microsoft-teams-message-update - arguments: - description: The chat ID / group chat name (topic) / oneOnOne member (Display name/mail/UPN). Note - the consent user must be a member of the chat. name: chat required: true - description: The number of results to retrieve. name: limit defaultValue: 50 - description: Orders results by lastModifiedDateTime (default) or createdDateTime in descending order. name: order_by auto: PREDEFINED predefined: - 'lastModifiedDateTime' - 'createdDateTime' defaultValue: 'lastModifiedDateTime' - description: A link that specifies a starting point to use for subsequent calls. name: next_link - description: Number of results to return per page. name: page_size defaultValue: 50 description: |- Retrieves a list of messages in a chat. Notes: - This command works with the consent user, not with the bot. Which means, that the chat must include the consent user. name: microsoft-teams-chat-message-list outputs: - contextPath: MicrosoftTeams.ChatList.chatId description: The chat's unique identifier. type: String - contextPath: MicrosoftTeams.ChatList.messages.id description: Unique ID of the message. type: String - contextPath: MicrosoftTeams.ChatList.messages.replyToId description: ID of the parent chat message or root chat message of the thread. type: String - contextPath: MicrosoftTeams.ChatList.messages.etag description: Version number of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.messageType description: The type of chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.createdDateTime description: Timestamp of when the chat message was created. type: String - contextPath: MicrosoftTeams.ChatList.messages.lastModifiedDateTime description: Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed. type: String - contextPath: MicrosoftTeams.ChatList.messages.lastEditedDateTime description: Timestamp when edits to the chat message were made. Triggers an "Edited" flag in the Teams UI. If no edits are made the value is null. type: String - contextPath: MicrosoftTeams.ChatList.messages.deletedDateTime description: Timestamp when the chat message was deleted, or null if not deleted. type: String - contextPath: MicrosoftTeams.ChatList.messages.subject description: The subject of the chat message, in plaintext. type: String - contextPath: MicrosoftTeams.ChatList.messages.summary description: Summary text of the chat message that could be used for push notifications and summary views or fall back views. type: String - contextPath: MicrosoftTeams.ChatList.messages.chatId description: If the message was sent in a chat, represents the identity of the chat. type: String - contextPath: MicrosoftTeams.ChatList.messages.importance description: The importance of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.locale description: Locale of the chat message set by the client. type: String - contextPath: MicrosoftTeams.ChatList.messages.webUrl description: Link to the message in Microsoft Teams. type: String - contextPath: MicrosoftTeams.ChatList.messages.channelIdentity description: If the message was sent in a channel, represents the identity of the channel. type: String - contextPath: MicrosoftTeams.ChatList.messages.policyViolation description: Defines the properties of a policy violation set by a data loss prevention (DLP) application. type: String - contextPath: MicrosoftTeams.ChatList.messages.eventDetail description: If present, represents details of an event that happened in a chat, a channel, or a team, for example, adding new members. type: String - contextPath: MicrosoftTeams.ChatList.messages.from description: Details of the sender of the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.body description: Plaintext/HTML representation of the content of the chat message. Representation is specified by the contentType inside the body. type: String - contextPath: MicrosoftTeams.ChatList.messages.attachments description: References to attached objects like files, tabs, meetings, etc. type: String - contextPath: MicrosoftTeams.ChatList.messages.mentions description: List of entities mentioned in the chat message. type: String - contextPath: MicrosoftTeams.ChatList.messages.reactions description: Reactions for this chat message (for example, Like). type: String - contextPath: MicrosoftTeams.MessageListNextLink description: Used if an operation returns partial results. If a response contains a NextLink element, its value specifies a starting point to use for subsequent calls. type: String - arguments: - description: The chat ID / group chat name (topic) / oneOnOne member (Display name/mail/UPN) / channel name. Note - the consent user must be a member of the chat. name: conversation_id required: true - description: The channel's team. Required if specifying a channel name in the conversation_id argument. name: team_name - description: The number of results to retrieve. name: limit defaultValue: 50 - description: Orders results by lastModifiedDateTime (default) or createdDateTime in descending order. name: order_by auto: PREDEFINED predefined: - 'lastModifiedDateTime' - 'createdDateTime' defaultValue: 'lastModifiedDateTime' - description: A link that specifies a starting point to use for subsequent calls. name: next_link - description: Id of a message to retrieve its replies. Supported only for channels. name: message_id description: |- Retrieves a list of messages in a chat or channel. Notes: - When retrieving messages from a chat, this command works with the consent user, not with the bot. Which means, that the chat must include the consent user. name: microsoft-teams-list-messages outputs: - contextPath: MicrosoftTeams.MessagesList.conversationId description: The conversation's unique identifier. type: String - contextPath: MicrosoftTeams.MessagesList.messages.id description: Unique ID of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.replyToId description: ID of the parent message or root message of the thread. type: String - contextPath: MicrosoftTeams.MessagesList.messages.etag description: Version number of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.messageType description: The type of message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.createdDateTime description: Timestamp of when the message was created. type: String - contextPath: MicrosoftTeams.MessagesList.messages.lastModifiedDateTime description: Timestamp when the message is created (initial setting) or modified, including when a reaction is added or removed. type: String - contextPath: MicrosoftTeams.MessagesList.messages.lastEditedDateTime description: Timestamp when edits to the message were made. Triggers an "Edited" flag in the Teams UI. If no edits are made the value is null. type: String - contextPath: MicrosoftTeams.MessagesList.messages.deletedDateTime description: Timestamp when the message was deleted, or null if not deleted. type: String - contextPath: MicrosoftTeams.MessagesList.messages.subject description: The subject of the message, in plaintext. type: String - contextPath: MicrosoftTeams.MessagesList.messages.summary description: Summary text of the message that could be used for push notifications and summary views or fall back views. type: String - contextPath: MicrosoftTeams.MessagesList.messages.chatId description: If the message was sent in a chat, represents the identity of the chat. type: String - contextPath: MicrosoftTeams.MessagesList.messages.importance description: The importance of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.locale description: Locale of the message set by the client. type: String - contextPath: MicrosoftTeams.MessagesList.messages.webUrl description: Link to the message in Microsoft Teams. type: String - contextPath: MicrosoftTeams.MessagesList.messages.channelIdentity description: If the message was sent in a channel, represents the identity of the channel. type: String - contextPath: MicrosoftTeams.MessagesList.messages.policyViolation description: Defines the properties of a policy violation set by a data loss prevention (DLP) application. type: String - contextPath: MicrosoftTeams.MessagesList.messages.eventDetail description: If present, represents details of an event that happened in a chat, a channel, or a team, for example, adding new members. type: String - contextPath: MicrosoftTeams.MessagesList.messages.from description: Details of the sender of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.body.content description: The content of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.body.contentType description: Plaintext/HTML representation of the content of the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.attachments description: References to attached objects like files, tabs, meetings, etc. type: String - contextPath: MicrosoftTeams.MessagesList.messages.attachments.content type: String description: The content of the attachments. - contextPath: MicrosoftTeams.MessagesList.messages.mentions description: List of entities mentioned in the message. type: String - contextPath: MicrosoftTeams.MessagesList.messages.reactions description: Reactions for this message (for example, Like). type: String - contextPath: MicrosoftTeams.MessagesListNextLink description: Used if an operation returns partial results. If a response contains a NextLink element, its value specifies a starting point to use for subsequent calls. type: String - contextPath: MicrosoftTeams.MessagesListMetadata.returned_count description: |- The actual number of messages returned in this specific execution. type: Number - contextPath: MicrosoftTeams.MessagesListMetadata.filtered_count description: |- The total number of messages in the system that match the specified filter criteria. type: Number - arguments: - description: The chat ID / group chat name (topic) / oneOnOne member (Display name/mail/UPN). Note - the consent user must be a member of the chat. name: chat - description: "Filters results. For example: topic eq 'testing'. For more query examples, see https://learn.microsoft.com/en-us/graph/filter-query-parameter?tabs=http. " name: filter - description: Expands the results to include members or lastMessagePreview properties. name: expand auto: PREDEFINED predefined: - 'members' - 'lastMessagePreview' - description: The number of results to retrieve. name: limit defaultValue: 50 - description: A link that specifies a starting point to use for subsequent calls. name: next_link - description: Number of results to return per page. name: page_size defaultValue: 50 description: |- Retrieves a list of chats that the consent user is a member of. If 'chat' is specified, retrieves this chat only. name: microsoft-teams-chat-list outputs: - contextPath: MicrosoftTeams.ChatList.chatId description: The chat's unique identifier. type: String - contextPath: MicrosoftTeams.ChatList.topic description: Subject or topic for the chat. Only available for group chats. type: String - contextPath: MicrosoftTeams.ChatList.createdDateTime description: Date and time when the chat was created. type: String - contextPath: MicrosoftTeams.ChatList.lastUpdatedDateTime description: Date and time when the chat was renamed or list of members were last changed. type: String - contextPath: MicrosoftTeams.ChatList.chatType description: Specifies the type of chat. type: String - contextPath: MicrosoftTeams.ChatList.webUrl description: The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. type: String - contextPath: MicrosoftTeams.ChatList.tenantId description: The identifier of the tenant in which the chat was created. type: String - contextPath: MicrosoftTeams.ChatList.viewpoint description: Represents caller-specific information about the chat, such as last message read date and time. type: String - contextPath: MicrosoftTeams.ChatList.onlineMeetingInfo description: Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. type: String - contextPath: MicrosoftTeams.ChatListNextLink description: Used if an operation returns partial results. If a response contains a NextLink element, its value specifies a starting point to use for subsequent calls. type: String - arguments: - description: The chat ID / group chat name (topic). Note - the consent user must be a member of the chat. name: chat required: true - description: The new chat name. Maximum length is 250 characters. Use of ':' is not allowed. name: chat_name required: true description: |- Updates the chat name. It can only be set for group chats. Notes: - This command works with the consent user, not with the bot. Which means, that the chat must include the consent user. name: microsoft-teams-chat-update - description: Generate the login url used for Authorization code flow. name: microsoft-teams-generate-login-url arguments: [] - description: Run this command if you need to rerun the authentication process. name: microsoft-teams-auth-reset arguments: [] - description: |- Retrieves the API permissions associated with the used graph access token. Note: Use this command if you encounter insufficient permissions error when attempting to execute an integration command. Compare the permissions list obtained for the token with the permissions required for the desired command (can be found in the integration documentation). If there are missing API permissions, add them to your application, and then run the `microsoft-teams-auth-reset` command (as described here - https://xsoar.pan.dev/docs/reference/integrations/microsoft-teams#microsoft-teams-auth-reset). name: microsoft-teams-token-permissions-list arguments: [] - description: |- Generates the messaging endpoint, based on the server URL, the server version, and the instance configurations. Note: The messaging endpoint should be added to the Demisto bot configuration in Microsoft Teams as part of the prerequisites of the integration's setup. For more information, see - https://xsoar.pan.dev/docs/reference/integrations/microsoft-teams#create-the-demisto-bot-in-microsoft-teams. name: microsoft-teams-create-messaging-endpoint arguments: - description: |- If your instance configuration involves a Cortex XSOAR engine, provide the engine's IP (or DNS name) and the port in use in the following format - `https://IP:port` or `http://IP:port`. For example - `https://my-engine.name:443`, `http://1.1.1.1:443`. name: engine_url - arguments: - description: The channel to which to send messages. Supports only standard channels. name: channel prettyname: Channel required: true - description: 'The message to send to the channel. Use issue fields as variables to enrich the text. Example: “${issue.details}".' name: message prettyname: Message required: true description: |- Sends a message to the specified teams. name: teams-send-notification-quick-action prettyname: Send Teams Message hidden: true quickaction: true outputs: - contextPath: MicrosoftTeams.Message.ID description: ID of the message sent. type: String - arguments: - description: |- The user to send the message to. Accepts any of the following identifiers: - Email address (e.g., "john.doe@example.com") - User Principal Name (e.g., "john.doe@domain.onmicrosoft.com") - Display name (e.g., "John Doe") - User GUID (e.g., "3fa9f28b-eb0e-463a-ba7b-8089fe9991e2"). name: user_id required: true - description: The text message to send to the user. name: message - description: The Microsoft Teams adaptive card to send (in JSON format). name: adaptive_card description: |- Sends a proactive message to any Microsoft Teams user across the organization. This command enables direct communication with users without requiring them to be in a specific team or channel. Note: Either 'message' or 'adaptive_card' must be provided, but not both. name: microsoft-teams-send-proactive-message outputs: - contextPath: MicrosoftTeams.Conversation.ConversationId description: The ID of the conversation created or used. type: String - contextPath: MicrosoftTeams.Conversation.UserId description: The resolved user ID. type: String - contextPath: MicrosoftTeams.Conversation.ActivityId description: The ID of the sent message activity. type: String - contextPath: MicrosoftTeams.Conversation.UserIdentifier description: The original user identifier provided. type: String dockerimage: demisto/teams:1.0.0.10133006 longRunning: true longRunningPort: true script: '' subtype: python3 type: python resetContext: true isFetchSamples: true runonce: false tests: - Microsoft Teams - Test supportsquickactions: true fromversion: 5.0.0 triggers: - conditions: - name: engine operator: not_exists - name: isEngineGroup operator: not_exists effects: - name: longRunningPort action: hidden: true required: false