{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21318,"path":"integrate-applications/integration-hub/msteams-spoke.md","title":"Microsoft Teams Graph Spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# Microsoft Teams Graph Spoke\n\nThe Microsoft Teams Graph spoke manages applications, calendar, teams, channels, chats, notifications, and webhooks in Microsoft Teams. To create, manage, or delete users and groups, use the Microsoft Entra ID spoke \\(formerly Microsoft Azure Active Directory spoke\\).\n\n## Request apps on the Store\n\nVisit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).\n\n**Note:**\n\n- Teams in the Microsoft Teams Graph spoke are created from the groups in Microsoft Entra ID \\(formerly Microsoft Azure Active Directory\\). To create a team using the Microsoft Teams Graph spoke, the associated group must be present in Microsoft Entra ID.\n- User and group management can be done using Microsoft Entra ID only and not Microsoft Teams Graph spoke.\n- Teams can be created from the Microsoft Office 365 group only.\n- The team ID in Microsoft Teams is the same as the group ID of the associated group in Microsoft Entra ID.\n\n## Integration Hub subscription\n\nThis spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).\n\n## Spoke version\n\nMicrosoft Teams Graph spoke v4.5.2 is the latest version. For version history of the spoke, see [Microsoft Teams Graph Spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-ms-teams.html).\n\n## Supported version\n\nMicrosoft Graph REST API v1.0.\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, confirm that these dependent plugins are installed:\n\n- ServiceNow Integration Hub Runtime \\(com.glide.hub.integration.runtime\\)\n- Flow Designer Model \\(com.glide.hub.designer\\_backend.model\\)\n- Complex Object \\(com.glide.cobject\\)\n- ServiceNow Integration Hub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n- ServiceNow Integration Hub Action Template - Data Stream \\(com.glide.hub.action\\_type.datastream\\)\n- Remote Tables \\(com.glide.script.vtable\\)\n- ServiceNow IntegrationHub Action Step - Get Connection Info \\(com.glide.hub.action\\_step.get\\_connection\\_info\\)\n\n**Note:** Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.\n\n## Spoke flows\n\nThe Microsoft Teams Graph spoke provides a sample flow, Post ServiceNow Incident Worknotes Updates to Microsoft Teams Chat, to demonstrate automating the task of posting a Microsoft Teams chat message to the assigned user with details about the latest work notes added to the incident.\n\n## Spoke subflows\n\nThe Microsoft Teams Graph spoke provides samples subflows to demonstrate automating the tasks. To customize a sample flow, copy it to the required application scope. Available sample subflows include:\n\n|Subflow|Description|\n|-------|-----------|\n|Post Incident Details|Posts details of the required incident to a Microsoft Teams channel.|\n|Process Inbound Notifications|Retrieves the details of the specified message based on the input data received from webhook subscription.|\n|Renew Webhook Subscription Helper Subflow|Renews a subscription if renewal is required, which is decided based upon inputs.|\n|Renew Webhook Subscriptions|Retrieves all the webhook subscriptions and renews them if renewal is required.|\n|Subscribe Webhook|Creates a webhook subscription for the specified team's channel.|\n\n## Spoke actions\n\nThe Microsoft Teams Graph spoke provides actions to automate team and channel tasks when an incident is created in the ServiceNow instance.\n\nYou can perform some actions by using the Microsoft Teams Spoke connection and the remaining actions by using the Microsoft Teams Graph Client Credentials connection.\n\nThe actions in the following table use the Microsoft Teams Spoke connection and credential alias record. These actions require the delegated permissions.\n\n\n
\n\nCategory\n\n\n\nAction\n\n\n\nDescription\n\n\n\nPermissions required \\(from least to most privileged\\)\n\n
\n\nApplication Management\n\n\n\nInstall Application to User\n\n\n\nInstalls the specified application in the personal scope of the user.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser\n\n
\n\nLook up User App Installation\n\n\n\nRetrieves the details of the specified application's installation for the user.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamsAppInstallation.ReadForUser, TeamsAppInstallation.ReadWriteSelfForUser, TeamsAppInstallation.ReadWriteForUser\n\n
\n\nCalendar Management\n\n\n\nLook up Schedules\n\n\n\nRetrieves the availability information \\(free or busy\\) for a collection of users, distributions lists, or resources \\(rooms or equipment\\) for the specified time period.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nCalendars.Read, Calendars.ReadWrite\n\n
\n\nChannel Management\n\n\n\nAdd Member to Channel\n\n\n\nAdds the specified member to the specified channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMember.ReadWrite.All\n\n
\n\nCreate Channel\n\n\n\nCreate a new channel in a team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannel.Create, Group.ReadWrite.All, Directory.ReadWrite.All\n\n
\n\nDelete Channel\n\n\n\nRemoves the specified channel from the required team and deletes all conversations.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannel.Delete.All, Group.ReadWrite.All, Directory.ReadWrite.All\n\n
\n\nLook up Channel\n\n\n\nRetrieves the properties and relationships of a channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All\n\n
\n\nLook up Channel by Name\n\n\n\nRetrieves the Channel ID and properties given a channel name and team ID.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All\n\n
\n\nLook up Channel Members\n\n\n\nRetrieves a list of channel members.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMember.Read.All, ChannelMember.ReadWrite.All\n\n
\n\nLook up Channel Messages\n\n\n\nRetrieves the list of messages in a channel of a team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Read.All\n\n
\n\nLook up Channels\n\n\n\nRetrieves the list of channels in this team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All\n\n
\n\nRemove Member from Channel\n\n\n\nRemoves the specified user from the specified channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMember.ReadWrite.All\n\n
\n\nChat Management\n\n\n\nCreate Chat\n\n\n\nCreates a chat between the users.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChat.Create, Chat.ReadWrite\n\n
\n\nLook up Chat Message Deltas Stream\n\n\n\nRetrieves the list of messages \\(without the replies\\) from a team's channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nMail.ReadBasic, Mail.Read, Mail.ReadWrite\n\n
\n\nDelegated \\(personal Microsoft account\\)\n\n\n\nMail.ReadBasic, Mail.Read, Mail.ReadWrite\n\n
\n\nLook up Chat Messages\n\n\n\nRetrieves the list of messages in a chat.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChat.Read, Chat.ReadWrite\n\n
\n\nLook up Chats\n\n\n\nRetrieves the list of chats that the user is a part of.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChat.ReadBasic, Chat.Read, Chat.ReadWrite\n\n
\n\nLook up Message\n\n\n\nRetrieves the details of the specified message.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChat.Read, Chat.ReadWrite\n\n
\n\nLook up Message Replies Stream\n\n\n\nRetrieves the list of replies for the specified message from a team's channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Read.All\n\n
\n\nPost Message to Chat\n\n\n\nPosts message to a Microsoft Teams chat.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChatMessage.Send, Chat.ReadWrite, Group.ReadWrite.All\n\n
\n\nNotification Management\n\n\n\nPost Change Details\n\n\n\nPosts details of the required change to a Microsoft Teams channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nPost Incident Details\n\n\n\nPosts details of the required incident to a Microsoft Teams channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nPost Message\n\n\n\nPosts message to a Microsoft Teams channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nPost Problem Details\n\n\n\nPosts details of the required problem to a Microsoft Teams channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nPost Reply to Message\n\n\n\nPosts a reply to the specified message.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nPost Record Details\n\n\n\nPosts details of the specified record to the specified Microsoft Teams channel.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nChannelMessage.Send, Group.ReadWrite.All\n\n
\n\nTeam Management\n\n\n\nAdd Member to Team\n\n\n\nAdds the specified user to the specified team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamMember.ReadWrite.All\n\n
\n\nArchive Team\n\n\n\nWhen a team is archived, users can no longer send or like messages on any channel in team or make Team setting updates.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All\n\n
\n\nCreate Team\n\n\n\nCreate a team from an existing Office 365 group.**Note:** The team ID is the same as the group ID.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nGroup.ReadWrite.All, Directory.ReadWrite.All\n\n
\n\nDelete Team\n\n\n\nDeletes the specified team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nGroup.ReadWrite.All\n\n
\n\nLook up Team\n\n\n\nRetrieves the properties and relationships of a team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeam.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All\n\n
\n\nLook up Team Members Stream\n\n\n\nRetrieves list of team members.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamMember.Read.All, TeamMember.ReadWrite.All\n\n
\n\nLook up Teams by User\n\n\n\nLists teams of the user containing IDs and their display names.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeam.ReadBasic.All, TeamSettings.Read.All, TeamSettings.ReadWrite.All, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All\n\n
\n\nRemove Member from Team\n\n\n\nRemoves the specified member from the specified team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamMember.ReadWrite.All\n\n
\n\nUnarchive Team\n\n\n\nRestores an archived team. Enables members to post to channels in the team, make comments, and like posts again.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All\n\n
\n\nUpdate Team\n\n\n\nUpdates the properties of a specific team.\n\n\n\nDelegated \\(work or school account\\)\n\n\n\nTeamSettings.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All\n\n
The actions in the following table use the Microsoft Teams Graph Client connection and credential alias record. These actions require the application permissions.\n\n|Category|Action|Description|Permissions required \\(from least to most privileged\\)|\n|--------|------|-----------|------------------------------------------------------|\n|Calendar Management|Create Meeting|Creates an online meeting event in the MS Teams calendar.|Application|Calendars.ReadWrite|\n|Delete Meeting|Deletes meeting event from the MS Teams calendar.|Application|Calendars.ReadWrite|\n|Look up Meeting|Retrieves meeting event details from the MS Teams calendar.|Application|Calendars.Read|\n|Look up Meeting Occurrences|Retrieves recurrence child meeting ID from the MS Teams calendar.|Application|Calendars.Read|\n|Look up Meetings Stream|Retrieves meeting events details from the MS Teams calendar.|Application|Calendars.Read, Calendars.ReadWrite|\n|Update Meeting|Creates an online meeting event in the MS Teams calendar.|Application|Calendars.ReadWrite|\n|Webhook Management|Look up Webhook Subscription|Retrieves details of the required webhook subscription.|Application|ChannelMessage.Read.All, Chat.Read.All|\n|Look up Webhook Subscriptions Stream|Retrieves details of all webhook subscriptions.|Application|ChannelMessage.Read.All, Chat.Read.All|\n|Renew Webhook Subscription|Renews the specified webhook subscription.|Application|ChannelMessage.Read.All, Chat.Read.All|\n|Subscribe Webhook|Creates a webhook subscription for the specified resource.|Application|ChannelMessage.Read.All, Chat.Read.All|\n|Unsubscribe Webhook|Deletes the specified webhook subscription.|Application|ChannelMessage.Read.All, Chat.Read.All|\n\n**Important:** Ensure that you’re aware about these default spoke configurations.\n\n- By default, the grant type is set to **Authorization Code**.\n- All actions in the Application Management, Channel Management, Chat Management, Notification Management, and Team Management categories, and Look up Schedules action in the Calendar Management category use the **Microsoft Teams Spoke** connection and credential alias and these actions require delegated permissions.\n- The Calendar and Webhook Management spoke actions \\(except Lookup schedules action in Calendar Management\\) use the **Microsoft Teams Graph Client Credentials** connection and credential alias and these actions require application permissions.\n\nIf you want to use the Microsoft Teams Graph Spoke without user interaction, you should change the grant type to **Client Credentials** so that the ServiceNow application can access the Microsoft Teams Graph API without user involvement. For instructions on how to change grant type and the required configurations, see the [Knowledge Base article - KB1635160](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1635160) on [ServiceNow - NOW Support](https://support.servicenow.com/now).\n\nFor more information about the required permissions, see [Microsoft Teams documentation](https://docs.microsoft.com/en-gb/).\n\n**Note:** Some of the spoke actions require the channel ID, group ID, or team ID as one of the inputs. To learn these details, log in to Microsoft Teams, navigate to **Teams**, and click **Get link to channel** for the required channel. The channel link contains the required details. For example, if the channel link is `https://teams.microsoft.com/l/channel/ 19%3a1aa3730712e245a0af31e4095d66d613%40thread.skype /New%2520channel%2520in%2520team? groupId= 7fb91938-5e8c-4968-bf7d-3987df7716f3 &tenantId= a46df9b7-2c9b-49d5-8c9f-d1b3de4ba59f`, the group ID and team ID are `7fb91938-5e8c-4968-bf7d-3987df7716f3`, and the channel ID is`19:1aa3730712e245a0af31e4095d66d613@thread.skype` or `1aa3730712e245a0af31e4095d66d613`.\n\nFor more information about accessing the channel ID and group ID through Microsoft Teams, see [Microsoft Teams documentation](https://docs.microsoft.com/en-gb/).\n\n## Available AI agents\n\nInstall Now Assist for Integration Hub and start using the available AI agents. For more information, see [ServiceNow Otto for Integration Hub](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/now-assist-spokes.md).\n\nThis spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance.\n\n- In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model \\(LLM\\) instructions along with one or more standalone AI agents to execute an objective. See [Create an agentic workflow](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/configure-use-case-ai-agents.md) for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger.\n\n You can also search for other available AI agents and add them to your agentic workflow. See [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md) for more information.\n\n- You can create a clone of the required spoke AI agent and customize it as per your requirement. See [Duplicate an AI agent](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/clone-ai-agent.md) for more information about creating a clone.\n- See [AI Agent Studio \\(legacy\\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/na-ai-agents.md) for information about AI agents.\n\nAvailable AI agents include:\n\n|AI Agent|Description|\n|--------|-----------|\n|Microsoft Teams application management AI agent|Automates tasks related to Microsoft Teams and Integration Hub. Performs actions such as looking up app installations and installing applications for the users.|\n|Microsoft Teams channel management AI agent|Manages Microsoft Teams channels through IntegrationHub. It provides capabilities such as creating channels, managing members, and retrieving channel information.|\n|Microsoft Teams chat management AI agent|Automates workflows between ServiceNow and Microsoft Teams by providing capabilities such as looking up chats and messages.|\n|Microsoft Teams notification management AI agent|Automates communication between ServiceNow and Microsoft Teams by sending messages, updates, and replies to Microsoft Teams channels. The agent supports actions like 'Post Change Details', 'Post Message', and 'Post Reply to Message' to ensure effective notification management for change requests.|\n|Microsoft Teams team management AI agent|Automates tasks such as creating and managing Teams, adding or removing members, and retrieving team-related information. Enhances team management and communication workflows within an organization.|\n|Microsoft Teams calendar management AI agent|Automates workflows between ServiceNow and Microsoft Teams. Provides calendar management capabilities. Performs actions such as deleting, and retrieving meeting details.|\n\nThere might be AI agents installed on your instance that are not used in agentic workflows. To learn how to see all agents that are available to you, see [Find AI agents](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/intelligent-experiences/find-ai-agents.md).\n\n**Note:** Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent.\n\n## Spoke modules\n\nThe Microsoft Teams Graph spoke adds the Microsoft Teams Graph Spoke to your ServiceNow instance and includes these modules.\n\n|Module|Description|\n|------|-----------|\n|Delta Token|Displays the list of available Delta Tokens.|\n|Webhook Registry|Displays the list of available webhook registries.|\n|Webhook Decision Policy|Displays the list of decision policies.|\n|Webhook Subscriptions|Displays the details of webhook subscriptions.|\n\n## Microsoft account requirements\n\nThe Microsoft Teams Graph spoke requires registering an application using the Microsoft Azure portal to generate OAuth 2.0 tokens.\n\n## Connection and credential alias requirements\n\nIntegration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.\n\nFor information about setting up the spoke, see [Set up the Microsoft Teams Graph spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/set-up-msteams.md).\n\n## MID Server requirements\n\nThe Microsoft Teams Graph spoke actions use REST calls, which can run on an instance or a MID Server. Use the connection record associated with the Microsoft alias to configure where actions run as well as set MID Server selection attributes. For more information, see [MID server](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/mid-server-landing.md).\n\nTo set up the MID Server for this spoke, see [Set up MID Server for a spoke](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/integrate-applications/integration-hub/config-adv-mid-settings-for-oauth-on-mid.md).\n\n"}}