Skip to main content
Version: 8.4

Teams App Config

Microsoft Teams or Teams is an application to communicate with your team members. Using Teams for incident creation and management will become easier if you add the ServiceOps Virtual Agent as an app within Teams. Once added, you can generate or review requests from Teams without signing-in to the Support Portal or accessing the virtual chat agent from the portal.

You can integrate a custom-built Teams app that connects your ServiceOps Portal, enabling the Virtual Agent to send responses to the requester over the Teams application.

Applicable Version​

This functionality is applicable from version 7.7 and above.

Prerequisites​

  • ServiceOps hosted on a live URL.
  • SSL certificate enabled.
  • The Base URL in ServiceOps should be the same as the portal URL.
  • Requester created in the ServiceOps portal.
  • Teams account created with the same requester email ID as created in the above point.
  • The Developer Portal in Teams should be accessible for creating an app.

Creating and Configuring Teams Virtual Agent​

To create a Virtual Agent application, follow the below steps:

Step 1: Create or Open a Teams account with admin permissions.

Step 2: Open the application and navigate to Apps > Developer Portal.

Developer Portal

Step 3: Click Open.

Open Developer Portal

Step 4: Create a new app by clicking the "New app" option. You can also click the option "Import app" and select the sample zip file provided by Motadata. To download the sample zip file, click here.

Create an app

Step 5: Enter the App name and click Add. Here, the Motadata Virtual Agent app is created.

Add an app

Step 6: Navigate to Configure > Basic Information page and enter the below details:

  • Descriptions: Enter the short and long descriptions of the App. These are mandatory fields.
  • Developer Information: Enter the Developer/Company name and Website URL. These are mandatory fields.
  • App URLs: Enter the URLs of the privacy policy and terms of use. These are mandatory fields.

Basic Information

Once done, click Save.

Step 7: In the Branding tab, set the Color and Outline icons for the App.

note

The Outline icon should be 32x32 pixels and greyscale.

Branding

Step 8: In the App Features, select Bot.

App Features

Step 9: Click Create a new bot or select the existing one from the dropdown.

Create a Bot

If "create a new bot" is selected, the Bot Management page appears. You can also create a bot from the Tools tab > Bot Management page.

Step 10: Click New Bot, enter the bot’s name, and click Add.

Add Bot

Step 11: Configure the bot endpoint address and click Save. Change the base URL before the "/api/public/teams/readMessage" section, as shown below. It is the HTTPS URL on which Teams will send the message.

Configure Endpoint Address

Step 12: Navigate to the Client secrets tab and click the "Add a client secret for your bot" button.

Client secrets tab

The client's secret will get generated and appear on the screen, as shown below. Copy this secret and paste it into ServiceOps in the Password field.

Client secret generated

The Bot is now created and appears on the Bot Management as shown below. Copy the Bot ID and paste it into ServiceOps in the Client ID field.

Bot ID

Step 13: Now, navigate to the Apps tab, and edit the created App (here, Motadata Virtual Agent) by clicking on it.

Edit App

Step 14: Navigate to Configure > App features > Bot, select the Bot from the "Select an existing bot" dropdown, and select the scope for the Bot.

Select the Bot Scope

Once done, click Save.

Step 15: Download the app package from the App list page below.

Download the app package

Step 16: In the ServiceOps Portal, navigate to Admin > Support Channel > Virtual Agent > Teams App Config page.

ServiceOps Configuration

Enable the Teams functionality to allow requesters to chat via the Teams application and configure the below settings.

  • Allow Notification: Enable to send notifications to the Teams application. By default, it is disabled.
note

Teams notifications support only those events that are displayed in the App Notifications tab.

  • Client ID: Paste the Client ID (Bot ID) copied from the Teams application in Step 12.
  • Password: Paste the password (Client secret) copied from the Teams application in Step 12.
  • Attachments: Attach the app zip file downloaded from the Teams application in Step 15.

Once done, click Update.

Step 17: In the Teams application, publish the App by clicking the Publish button and selecting "Publish to your org".

Publish your App

Once done, a request will be submitted to the IT Admin to publish the App. Once approved and published, it will appear in the apps list, as shown below.

Approved App

Step 18: Click on the App and Add it to the left panel.

Add the Virtual Agent

Step 19: Once added, type hi, and begin your conversation with the Motadata Virtual Agent.

Motadata Virtual Agent in Microsoft Teams