Integrating TrueSight Server Automation with Microsoft Teams for getting insights into patching operations

An administrator can integrate TrueSight Server Automation with Microsoft Teams. This integration enables the administrator to initiate chats with Microsoft Teams for patching operations.

Before you begin

Process overview

Task	Action
1	Create a Microsoft Teams bot
2	Create a Microsoft Teams application
3	Configure the Microsoft Teams bot in the Microsoft Azure portal
4	Publish the application from the Microsoft Azure portal
5	Update the MS Teams channel

Task 1: To create a Microsoft Teams bot

1. Perform the following steps to get the endpoint address details for the bot:

   1. Log in to BMC Helix Innovation Studio and launch the BMC Helix Agent Studio application.
   2. From the Application list, select BMC Helix Server Automation.
   3. Select the Operations Analyzer skill.
   4. Click Channels, select MS Teams channel for operations analyzer agent, and click Edit.
   5. Copy the Webhook URL in a temporary file.
      
2. Log in to Microsoft Teams using the administrator credentials and click the View more apps option. 
3. Search for Developer Portal and launch it.
   Add the Developer Portal if it is not available.
4. Select Tools >  Bot Management > New Bot.
5. In the Create a new bot dialog box, enter a bot name and click Create Bot.
   
6. Depending on the BMC Helix ITSM deployment, do one of the following:
   • (SaaS deployment) In the Endpoint address field, add the copied Webhook URL, as shown in the following example:
     https://itsmapps.pun01.abc.com/api/com.abc.dsom.hgm/channels/XAGGCTS2IDOYBVATQJDDBQDDPPNPG/Office365:Microsoft%20Teams
   • (On-premises deployment) Edit the URL:
     1. Delete the protocol from the copied URL.
     2. Add the URL for the proxy server as the prefix.
     3. In the Endpoint address field, add the updated Webhook URL, as shown in the following example
        https://pun-dmz01.abc.com/wsapi/scheme/https/server/itsmapps.pun01.abc.com/api/com.abc.dsom.hgm/channels/XAGGCTS2IDOYBVATQJDDBQDDPPNPG/Office365:Microsoft%20Teams
7. Click Save.
   The bot appears on the Tools >  Bot Management page.

Task 2: To create a Microsoft Teams application

1. In the Developer Portal, click Apps and then click New app.
2. Enter an application name and click Create.
3. From the left navigation pane, click Basic information, and review and update the following information:
   • Short name - 30 characters or less
   • Full name - up to 10n0 characters (optional)
   • Short description - 80 characters or less
   • Long description - 4,000 characters or less
   • Developer or company name
   • Website (must be a valid HTTPS URL)
   • Privacy policy
   • Terms of use
4. Note down the App ID. The App ID is required for BMC Helix ITSM integration.
   
5. Under Configure, click App features and then click Bot.
6. From the Select an existing bot list, select the bot you have created in step 5.
7. In Scope, select one of the following options:
   • Personal
   • Teams
   • Group Chat
8. Click Save.
9. Under Publish, select Publish to org.
10. Click Publish your app.

Task 3: To configure the bot in the Microsoft Azure portal

1. Access the following URL with credentials:
   https://portal.azure.com/#home 
2. Click App registrations.
   Or
   If you do not see the App resigration option in the new Microsoft UI, perform the following steps:
   1. Click Manage Microsoft Entra ID.
   2. Click the number link displayed next to the Application.
      
3. Click All applications and search for the bot you have created.
4. Click the bot you have created. 
5. Click Manage and then click API permissions.
6. Click Add a permission and then click Microsoft Graph
7. Click Delegated Permissions and select the following permissions.
   • Chat.Create
   • Chat.ReadWrite
   • User.Read
   • User.Read.All
8. Click Application Permissions and select the following permissions.
   • Chat.ReadBasic.All
   • ChatMessage.Read.All
   • User.ReadBasic.All
9. Click Add permissions and then click Grant admin consent for ***.
10. Select Yes to grant permissions for all the permissions.
11. Click Certificates & Secret and then click New client secret and add the required details.
12. Click Add and copy the highlighted TestSecret value.
    
13. Click Overview and note the following details:
    • Application (Client) ID
    • Directory (Tenant) ID

Task 4: To publish the application in the Microsoft portal

1. Access the following URL with the Microsoft Azure administrator credentials:
   https://admin.teams.microsoft.com/policies/manage-apps
2. Select All apps and identify the application you have created.
   Your application might be in a blocked status.
3. Select your application and click Publish.
   
4. Open All apps and verify that the Status is set to Unblocked.
5. To provide consent for using the application, click the following link:
   https://login.microsoftonline.com/common/adminconsent?client_id=<clientID>&state=12345&redirect_uri= https://midtierhost/arsys/pwa/assets/swarm/swarm.html
   Replace <clientID> with the Application (Client ID) that you noted down in Task 3, step 17 
   The application is published.

Task 5: To update the MS Teams channel for the Operations Analyzer skill

1. Open HelixGPT Agent Studio.
2. From the Application list, select BMC Helix Server Automation.
3. Select the Operations Analyzer skill.
4. Click Channels, select Microsoft Teams, and click Edit.
5. In the Edit Channel dialog box, enter the following details:

   Field name	Description
   Channel	Office 365: Microsoft Teams
   Name	Enter agent name
   Microsoft Bot ID	ID of the bot is the same as the application client ID created in Task 3, step 17
   Microsoft app password	TestSecret value copied in Task 4, step 16

6. Click Update.

Where to go from here

Using the TrueSight Server Automation Operations Analyzer to get insights into patching operations 

Related topics

TSSA Operations Analyzer