You are here:
Configure Salesforce and Microsoft Teams Manually
Configure the Salesforce and Microsoft Teams integration manually, including single sign-on, external credentials, the authentication provider, and Microsoft Entra ID callback URLs.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Performance, and Unlimited Editions with Agentforce IT Service. |
| User Permissions Needed | |
|---|---|
| To connect Salesforce and Microsoft Teams: | System Administrator Profile |
Make sure your org has the Teams IT Services Add-on, Teams Employee Add-on, Incident Management Add-on, and Service Cloud Employee Hub HR Standard Add-on licenses provisioned.
Enable Microsoft Teams for Employee Service
- From Setup menu, go to Salesforce Go > Feature Sets.
- On the Deliver IT Services Across Channels card, select Set Up.
- On the Microsoft Teams for Employee Service card, select Set Up.
- On the Microsoft Teams for Employee Service page, select Get Started.
-
Turn on Microsoft Teams for Employee Service.
When you enable Microsoft Teams for Employee Service, the External Client App, Auth Provider, External Credentials, and Named Credentials install automatically.
Configure SSO from Salesforce to Microsoft Teams
Configure Single Sign-On (SSO) for Microsoft Teams that allows employees and IT teams access to IT and HR service features in Microsoft Teams without repeated sign-ins. The SSO creates a secure trust relationship between Salesforce and Microsoft Azure to provide a seamless experience for managing support tickets and collaboration.
-
Create or reuse a Microsoft Entra ID application.
- Sign in to the Azure portal.
- On the Welcome to Azure dashboard, under Manage Microsoft Entra ID, click View. You can also search for Microsoft Entra ID in the top search bar.
- From the left navigation menu, under the Manage section, select App registrations.
- Select + New registration.
- For Name field, enter a descriptive name, such as MS_Teams_Salesforce_Integration_App.
- Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant).
- Click Register.
- On the application overview page, click Add a certificate or secret.
- Select + New client secret.
- On the Add a client secret page, enter a description, and select an expiration duration.
-
Click Add.
Copy the client secret value and store it in a secure location. This value is hidden permanently after you leave this page. Use the value, not the secret ID.
- From the left navigation menu, select API permissions.
- Select + Add a permission.
- Select Microsoft Graph.
- Select Delegated permissions.
-
Select these permissions for your integration.
- Channel.Create
- Channel.ReadBasic.All
- ChannelMember.Read.All
- ChannelMember.ReadWrite.All
- ChannelMessage.Edit
- ChannelMessage.Read.All
- ChannelMessage.ReadWrite
- ChannelMessage.Send
- Group.Read.All
- Group.ReadWrite.All
- offline_access
- openid
- profile
- Team.Create
- Team.ReadBasic.All
- User.Read
- Click Add permissions.
- To finalize the authorization, click Grant admin consent for your org to finalize the authorization.
-
Configure the MSTeamsClientCredentialsEC external credential with the Azure AD app's
client ID and client secret. See Set up Named Credentials.
If you have already configured the principal, delete it and reconfigure the client ID and client secret to apply the updated permissions.
-
Configure Microsoft Teams in Salesforce to improve collaboration and service
delivery.
- From Setup, click Salesforce Go.
- Search for and select Microsoft Teams for Employee Service.
- Turn on the toggle for Microsoft Teams for Employee Service. If it’s already enabled, turn it off and then turn it on again. To apply the new automated SSO features, turn the toggle off and then turn it on again.
- Locate the Grant Azure Administrator Consent step and click Grant Consent. A pop-up window displays a unique authorization URL.
- Click Copy Link and share this URL with your Azure Tenant Administrator. If you are the Azure Administrator, open the link in a new browser tab to approve the application's request to access and read organizational data.
-
Register your Salesforce org and preferred Experience Cloud site URLs in Microsoft Entra
ID by creating a Microsoft Graph organization extension.
- Open Microsoft Graph Explorer.
- Click the profile icon, select Sign In, and sign in with your Microsoft Entra Global Administrator credentials.
- Click the profile icon again, and select Consent to permissions.
- Search for Organization.ReadWrite.All.
- Select Consent for the permission, and approve the request.
- In Graph Explorer, set the HTTP method to POST.
-
Enter this endpoint, replacing <your_tenant_id> with your
Microsoft Entra tenant ID
https://graph.microsoft.com/v1.0/organization/<your_tenant_id>/extensions
-
In Request body, enter this JSON.
"@odata.type": "#microsoft.graph.openTypeExtension", "extensionName": "com_sf_itsm_teams_config", "salesforceOrgUrls": ["<YOUR_ORG_URL>"], "salesforceSiteUrls": ["<PREFERRERD_SITE_URL>"], "id": "com_sf_itsm_teams_config" - Replace <YOUR_ORG_URL> and <PREFERRERD_SITE_URL> with your Salesforce org and Experience Cloud site URLs.
-
Click Run Query.
A successful request returns the HTTP status 201 Created.
-
Configure the Auth. Provider for secure communication between Salesforce and Microsoft
Teams.
- From Setup, in the Quick Find box, enter Auth Providers, and then select Auth Providers.
- On the Auth Providers page, find and open the microsoft_auth_provider Auth Provider.
- Click Edit.
- Set Registration Handler Type to Apex.
-
In the Registration Handler, select MsTeamsItsmSSOHandler.
If MsTeamsItsmSSOHandler isn’t available, go to Salesforce Go, turn off the Microsoft Teams toggle, and then turn it on again to refresh the latest configuration.
- Set Execute Registration As a user account with only the Manage Users permission to maintain security best practices.
- Save your changes.
-
Add the Callback URL to Microsoft Entra ID.
- From the Auth. Provider page in Microsoft Teams, copy the generated callback URL.
- In the Microsoft Azure portal, open the your app registration that you created earlier.
- Add the callback URL as a redirect URL.
- On the Auth. Provider page in Microsoft Teams, copy the callback URL of the preferred site selected on the Salesforce Go page.
- Add the preferred site callback URL as a redirect URL in the same app registration.
Did this article solve your issue?
Let us know so we can improve!
