--- schema_version: "1" id: d4ad22d54fd4deae2bd340a32676fe56594bd7851bcb337f665a745f2f2e1ab4 title: Configure Notifications for Teams Apps for IT Services collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/it_srvcs_msteams_config_notifications.md canonical_url: https://help.salesforce.com/s/articleView?id=service.it_srvcs_msteams_config_notifications.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: f1419c21600e67c3d09b5e46880727d360f1a174622b52016c66d6400d508d95 description: Employees and IT teams can receive automatic notifications in Microsoft Teams for critical updates, such as incident status changes and approval requests. To use these proactive notifications, set up an Azure Bot and configure your notification channels. This setup is applicable for the Salesforce IT Desk and Salesforce IT Service apps in Microsoft Teams. products: - Service Cloud - Agentforce IT Service release: "264" --- # Configure Notifications for Teams Apps for IT Services Employees and IT teams can receive automatic notifications in Microsoft Teams for critical updates, such as incident status changes and approval requests. To use these proactive notifications, set up an Azure Bot and configure your notification channels. This setup is applicable for the Salesforce IT Desk and Salesforce IT Service apps in Microsoft Teams. ### Required Editions
Available in: Lightning Experience
Available in: Enterprise, Performance, and Unlimited Editions with Agentforce IT Service.
User Permissions Needed
To set up Microsoft Teams: MicrosoftGraphAccess permission set
1. Set up the Microsoft Azure bot. 1. Log in to the [Azure portal](https://portal.azure.com). 2. Search for Azure Bot and select it. 3. On the Azure Bot page, select **Create**. 4. On the Create an Azure Bot page, configure these details: - In the Bot handle box, enter a unique name for your bot. For example, SalesforceEmployeeBot. - In the Subscription list, select your Azure subscription. - In the Resource group list, select an existing resource group or create a resource group. - In the Data residency list, select **Global**. 5. Under Pricing, select **Change plan**, and then select the **Standard** pricing tier. 6. Under Microsoft App ID, configure these settings: - In the Type of App list, select **Single Tenant**. - In the Creation type list, select **Create new Microsoft App ID**. 7. Select **Review + create**, and wait for the validation process to complete. 8. Select **Create**. 9. After the deployment is complete, select **Go to resource**. 10. In the left navigation pane, under Settings, select **Channels**. 11. From the list of available channels, select **Microsoft Teams Commercial**, and then agree to the terms of service if prompted. 12. Select **Apply**. 13. In the left navigation pane, under Settings, select **Configuration**. 14. Find the Microsoft App ID field, and copy the value to a secure location. You will need this value later for your Teams app manifest. 2. Set up the Microsoft Teams Bot App. 1. Log in to the [Microsoft Teams Developer Portal](https://dev.teams.microsoft.com). 2. Select the **Apps** tab. 3. Select **\+ New app**. 4. In the dialog box, enter a name for the application. For example, SalesforceEmployeeBot. 5. Select **Create**. 6. In the left navigation pane, under Configure, select **App features**. 7. Under Identify your bot, select an existing bot or create a new bot. 8. Under What can your bot do?, select the checkboxes for the features you want to enable: - Upload and download files: Allows the bot to send and receive files. - Only send notification: Limits the bot to one-way outgoing messages. - Supports audio calls: Enables Voice over IP functionality. - Supports video calls: Enables video communication features. 9. Under Select the scopes where people can use your bot, choose the environments where the bot to be available: - Personal: Users can interact with the bot in a one-on-one private chat. - Team: The bot can be added to specific teams for collaborative tasks. - Group chat: The bot can be added to multi-user chats outside of a specific team. 10. Save your changes. 11. In the left navigation pane, under Configure, select **Basic information**. 12. Fill in all the fields with relevant information. 13. For website URLs, provide your portal url. 14. In the Application (client) ID field, enter the App ID for the Azure AD bot app you created earlier. 15. After you complete the configuration, your manifest.json file should look like the following example. ``` { "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json", "version": "1.0.0", "manifestVersion": "1.23", "id": "02515a34-b249-44e0-9908-244dc8d5dcb2", "name": { "short": "test-notifications", "full": "test-notifications" }, "developer": { "name": "Your Webiste", "websiteUrl": "https://yourwebsite.com", "privacyUrl": "https://yourwebsite.com", "termsOfUseUrl": "https://yourwebsite.com" }, "description": { "short": "short description", "full": "Long Description" }, "icons": { "outline": "outline.png", "color": "color.png" }, "accentColor": "#ffffff", "bots": [ { "botId": "6b748562-dee8-4c5a-9053-2d07e80ab54b", "scopes": [], "isNotificationOnly": false, "supportsCalling": false, "supportsVideo": false, "supportsFiles": false } ], "validDomains": [], "webApplicationInfo": { "id": "6b748562-dee8-4c5a-9053-2d07e80ab54b" } } ``` 16. To view the file in the portal, go to **App package editor**, and then select manifest.json. 17. Go to the [Azure Portal](https://portal.azure.com/) home page and search for the bot app by name. 18. In the Manage section, select **API permissions**, and then assign the required permissions. 19. Select **Add a permission**. 20. Select **Microsoft Graph**. 21. Select the **Application permissions**. 22. Select the these permissions. - Chat.Create - Chat.ManageDeletion.All - Chat.Read.All - Chat.Read.WhereInstalled - Chat.ReadBasic.All - Chat.ReadBasic.WhereInstalled - Chat.ReadWrite.All - Chat.ReadWrite.WhereInstalled - Chat.UpdatePolicyViolation.All - ChatMember.Read.All - ChatMember.Read.WhereInstalled - ChatMember.ReadWrite.All - ChatMember.ReadWrite.WhereInstalled - ChatMessage.Read.All - Organization.Read.All - Organization.ReadWrite.All - TeamsActivity.Read.All - TeamsActivity.Send - User.Read.All - User.ReadBasic.All - User.ReadWrite.All 23. Select **Add permissions**. 24. Select **Grant admin consent** (for your tenant). 25. Go to [Microsoft Teams Developer](https://dev.teams.microsoft.com/apps) portal. 26. In the navigation bar, select **Distribute**. 27. Select **Publish to your org**. After the admin approves the request, the app is available for users in your company. 28. In the installation dialog, select **Add**. 29. To verify the installation, open the bot in a chat window, and then send a message to confirm that the bot responds. 3. Set up Named Credentials. 1. In the Quick Find box, enter Named Credentials and select **Named Credentials**. 2. Select the **External Credentials** tab. 3. Select **AzureBotAuthClientCredentialsEC** from the list. 4. Select **Edit**. 5. Find the Identity Provider [URL](https://login.microsoftonline.com/tenant-id/oauth2/v2.0/token) field and replace the {tenant\_id} placeholder with your actual Azure Bot Tenant ID. 6. Save your changes. 7. Scroll down to the Principals section. 8. For the NamedAuthPrincipal, select the action dropdown and choose **Edit**. 9. In the Edit Principal dialog box, enter the Azure Bot Client ID and Client Secret into the respective fields. Get the client ID and client secret from Azure AD app that was created earlier. 10. Select **Save**. 11. Verify that the Authentication Status for the principal is updated to Configured. 12. Repeat steps from c to k for the MSTeamsClientCredentialsEC External Credential. Ensure you update the {tenant\_id}, [URL](https://graph.microsoft.com), and provide the correct Client ID and Secret. 4. Set up notifications. 1. From Setup menu, go to **Salesforce Go** > **Feature Sets**. 2. On the Notification for Employee Service card, select **Get Started**. 3. Turn on Notification for Employee Service. 4. From Setup, in the Quick Find box, enter Notifications and select **Multi-channel Notifications** under Service Notifications. 5. Under the Channels section, turn on Teams. 6. On the All Notifications list, select **New**. 7. In the Basic Information field, enter Incident Update for the Notification Name. 8. In the Reference Object field, select **Incident**. 9. Select **Next**. 10. In the Trigger Conditions page, select **Update** as the Trigger Type. 11. Configure the condition by setting Resource to Status, Operator to Is Changed, and Value to True. 12. Select **Next**. 13. In the Notification Content and Channels page, select the **Teams** tab. 14. Turn on Activate Teams notification. 15. Select app as **Salesforce IT Service** or **Salesforce IT Desk**. 16. From the Recipient dropdown list, choose **Assigned User ID (User Field)**. You can select multiple recipients. 17. In the Message Title field, enter message title. For example, Incident {{Incident.Id}} Updated 18. In the Message Body field, enter the message body. Updated Incident Subject: {{Incident.Subject}} With Priority: {{Incident.Priority}}. 19. From Choose Actions list, choose **View Record**. 20. Select **Next**. 21. On the Summary page, turn on activate notification preferences. 22. Save your changes.