Retail Manager

Retrieve the information and metadata of a given channel

Get the information and metadata of the current user or an existing user

Get information or metadata about a team member

Get the information and metadata of an existing user

List all of the messages in a given channel

https://graph.microsoft.com/v1.0/$metadata#teams('id')/channels('id')/messages

example

Retrieve the list of channels in a given team

https://graph.microsoft.com/v1.0/$metadata#teams('id')/channels

Retrieve the list of installed apps in a given team

https://graph.microsoft.com/v1.0/$metadata#teams

https://graph.microsoft.com/v1.0/$metadata#teams('id')/members

List apps from the Microsoft Teams app catalog

https://graph.microsoft.com/v1.0/$metadata#users

List all teams containing the provided user

Remove an Installed App from the given team

Send an adaptive card message to a given channel

Send an adaptive card message to an Incoming Webhook

This action must use the "Incoming Webhook" connection type.

See [adaptivecards.io](https://adaptivecards.io/) for documentation on constructing card payloads.


Send a text message to an Incoming Webhook

This action must use the "Incoming Webhook" connection type.


Upgrade an Installed App to the latest version for given team

Begin by following the steps in [Creating an App Registration](https://prismatic.io/docs/components/ms-teams/#creating-an-app-registration).

Recommended API permissions for Authorization Code Authentication:
1. Navigate to the **API Permissions** section. Select **Add Permission**, select all permissions that are required for your desired integration. A full list of scopes can be found on the [Microsoft Graph API documentation](https://learn.microsoft.com/en-us/graph/permissions-reference).
   1. Recommended scopes for Teams can be found in Microsoft Graph > Delegated permissions:
`Team.ReadBasic.All`
`Team.Create`
`TeamMember.ReadWrite.All`
`ChannelMessage.Read.All`
`offline_access`

When App is created, supply the following values to the **OAuth 2.0 Authorization Code** connection in your integration within Prismatic:

-   **Client ID** enter the **Application (client) ID**
-   **Client Secret** enter the **Value** provided (Do not use **Secret ID**)
-   Provide the **Scopes** you assigned to your Azure application permissions. The default value will match the recommended scopes. `https://graph.microsoft.com/Team.ReadBasic.All https://graph.microsoft.com/Team.Create https://graph.microsoft.com/Group.ReadWrite.All https://graph.microsoft.com/TeamMember.ReadWrite.All https://graph.microsoft.com/ChannelMessage.Read.All offline_access`
-   If you didn't select Multitenant when creating the App, you will need to replace the **Authorize URL** and **Token URL** with ones specific to your tenant.


Begin by following the steps in [Creating an App Registration](https://prismatic.io/docs/components/ms-teams/#creating-an-app-registration).

When App is created, supply the following values to the **OAuth 2.0 Client Credentials** connection in your integration within Prismatic:

-   **Client ID** enter the **Application (client) ID**
-   **Client Secret** enter the **Value** provided (Do not use **Secret ID**)
-   If you didn't select Multitenant when creating the App, you will need to replace the **Authorize URL** and **Token URL** with ones specific to your tenant.


[Incoming Webhooks](https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook) can be used for sending [adaptive cards](https://adaptivecards.io/) or plain text messages to individual chats or channels.


This authentication method may be used when an App requires granting admin consent to API permissions, in addition to authorizing the integration with the  App's configured client credentials.

The Microsoft Teams component authenticates requests through the [Microsoft Graph API](https://docs.microsoft.com/en-us/graph/use-the-api).

#### Creating an App Registration
To configure OAuth 2.0 you must first create an App through Active Directory in the [Microsoft Entra Admin Center](https://entra.microsoft.com/#home) or [Microsoft Azure Portal](https://portal.azure.com/#home).

1. Navigate to **App Registrations**
1. When creating the application you will be prompted to select  **Supported account types**.
1. Select **Accounts in any organizational directory (Any Azure AD directory - Multitenant)**.
1. Navigate to **Redirect URI** and add the **Web** platform. Now enter the redirect URI as `https://oauth2.prismatic.io/callback` for US based integrations.
   1. For integrations outside the US refer to this [guide](https://prismatic.io/docs/connections/#creating-an-oauth-20-app-in-a-third-party-service) to find your region’s Callback URL.
1. Select **Register** to complete.
1. In the App, navigate to **Certificates & Secrets** and select **New client secret**. Copy/save the **Value** for use in the connection configuration of your integration (the value will not be shown again).
1. Next, navigate to the **Overview** section and copy the **Application (client) ID**
1. Navigate to the **API Permissions** section to assign the proper permissions for the integration. Select **Add Permission**, select all permissions that are required for your desired integration and save these values for later. A full list of scopes can be found on the [Microsoft Graph API documentation](https://learn.microsoft.com/en-us/graph/permissions-reference)
   1. Recommended scopes for Teams can be found in Microsoft Graph > Application permissions:
`AppCatalog.Read.All`
`TeamsAppInstallation.Read.Group`
`TeamsAppInstallation.ReadWriteSelfForTeam.All`
`TeamsAppInstallation.ReadWriteForTeam.All`
`TeamsAppInstallation.ReadWriteAndConsentForTeam.All`
`TeamsAppInstallation.ReadWriteAndConsentSelfForTeam.All`
`Group.ReadWrite.All`
`Directory.ReadWrite.All`
`ChannelSettings.Read.Group`
`Channel.ReadBasic.All`
`Channel.Delete.Group`
`Channel.Create.Group`
`ChannelSettings.ReadWrite.Group`
`Teamwork.Migrate.All`
`ChannelMessage.Read.Group`
`GroupMember.Read.All`
`Team.ReadBasic.All`
`TeamMember.Read.Group`
`TeamMember.ReadWrite.All`
`TeamSettings.ReadWrite.Group`
`Team.Create`
`TeamSettings.Read.Group`
`User.Read.All`
`User.ReadWrite.All`

For more information regarding authenticating against the Microsoft Graph API refer to the [Microsoft documentation](https://docs.microsoft.com/en-us/graph/auth-v2-user).

#### Configuring the Integration
Supply the following values to the **OAuth 2.0 Admin Consent Client Credentials** connection in your integration within Prismatic:

-   **Client ID** enter the **Application (client) ID**
-   **Client Secret** enter the **Value** provided (Do not use **Secret ID**)
-   In the **Admin Consent URL** `https://login.microsoftonline.com/{tenant}/adminconsent`, replace `{tenant}` with the **Directory (tenant) ID** from the App.
-   In the **Token URL** `https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token?grant_type=client_credentials`, replace `{tenant}` with the **Directory (tenant) ID** from the App.
-   Provide the assigned API permissions as **Scopes** you assigned to your App. The default value will be set to `https://graph.microsoft.com/.default` which will use all admin consented permissions assigned to the App.
-   If you didn't select Multitenant when creating the App, you will need to replace the **Authorize URL** and **Token URL** with ones specific to your tenant.




Manage the teams, groups, channels, and messages associated with your Microsoft Teams account

[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams/group-chat-software) is a business communication platform developed by Microsoft, as part of the Microsoft 365 family of products.
This component allows you to easily manage teams, groups, channels, and messages inside of your Microsoft Teams account.


Receive and validate webhook requests from Microsoft Teams for webhooks you configure.

Action Name	Action Description
List Catalog Apps	Retrieve the list of apps in the catalog
List Installed Apps	Retrieve the list of installed apps in a given team
Install App	Add an Installed App to given team
Upgrade Installed App	Upgrade an Installed App to the latest version for given team
Remove Installed App	Remove an Installed App from the given team
List Channels	Retrieve the list of channels in a given team
Get Channel	Retrieve the information and metadata of a given channel
Delete Channel	Delete the information and metadata of a given channel
Create Channel	Create a channel inside a team
Update Channel	Update an existing channel inside a team
Send Message To Channel	Send a message to a given channel
Send Adaptive Card To Channel	Send an adaptive card message to a given channel
List Channel Messages	List all of the messages in a given channel
List Teams	List all teams
List Joined Teams	List the teams you have joined
List Team Members	List all the members in a team
Remove Team Member	Remove a user from a provided team
Get Member	Get information or metadata about a team member
Archive Team	Archive the specified team
Add Team Member	Add a new member to the team
Create Team	Create a new team
Get Team	Get information or metadata of a team
Update Team	Update an existing team
List Teams Apps	List apps from the Microsoft Teams app catalog
List Users	List all users
Get User	Get the information and metadata of an existing user
Delete User	Delete the information and metadata of an existing user
Get Current Or Existing User	Get the information and metadata of the current user or an existing user
List User's Teams	List all teams containing the provided user
Send Incoming Webhook Message	Send a text message to an Incoming Webhook
Send Incoming Webhook Adaptive Card	Send an adaptive card message to an Incoming Webhook
Raw Request	Send raw HTTP request to Microsoft Teams

Microsoft Teams Connector

Integrate with customers’ other SaaS apps, fast

About the Microsoft Teams Connector

Actions

Triggers

Ready to get started?