Microsoft Teams Integration

Microsoft Teams Integration

Set up SupportCenter Plus integration with Microsoft Teams to leverage the collaboration app from Microsoft as an additional channel for IT and enterprise support. This integration creates a SupportCenter Plus bot that enables users to view their SupportCenter Plus tickets, view pending approvals, and chat with support reps―all from within their Microsoft Teams accounts. By bringing a host of SupportCenter Plus capabilities like incident management into Microsoft Teams, SupportCenter Plus bridges the gap between IT help desk teams and end users.

Pre-requisites for Integration

Make sure SupportCenter Plus is hosted on a domain with a valid certificate, run on HTTPS, and publicly accessible. You can also use the Application Proxy feature in Azure to host SupportCenter Plus publicly. Learn more.


Roles Required

To set up the Microsoft Teams integration, you will be working on the integration setup of SupportCenter Plus, Microsoft Teams desktop or web app, and your Azure Portal. Make sure you have access to all those areas with the following roles:

  • SupportCenter Plus SDAdmin

  • Azure Global administrator/Teams Administrator and Azure Applications Administrator

Installing SupportCenter Plus App in Microsoft Teams

 The first thing you'll need to set up the Microsoft Teams integration is to create and install a SupportCenter Plus app in Microsoft Teams as explained below:

  1. Go to your Microsoft teams app or head to teams.microsoft.com

  2. Go to the Apps tab on the left pane and locate Developer Portal.

 

 

      3.   Click on Add. The Developer Portal will be added to your list of apps.

  1. Once the Developer Portal has been installed, go to the apps tab inside the developer portal and click on Import App.

  2. Download this zip file (Find this under attachments at the end of document) and select the SupportCenter Plus zip file. The SupportCenter Plus app will be added. Click on the new "SupportCenter Plus" application.

 

 

 

6. Once imported, click on app features on the left pane and click on Bot. Now click on Create a new bot.

 

7. Click on + New Bot on the top pane and provide the name as SupportCenter Plus Bot.


   

Setting up things in Azure Portal  


8. Now head to this (azure portal) link and click on the newly created bot.

9. Copy the Client ID and Tenant ID and save them in a file.

 

 

 

10. Now go to Certificates and Secrets and click on New Client Secret. Once created, copy the value and save it in a file.

 

 

 

 

 

11. Now paste the Application ID, Tenant ID, and the Client Secret(Application Password) in the MS Teams configuration page of your SDP instance.


  

 

12. Copy the redirect URL, head to the Azure Portal and go to the "Authentication" tab.

Click on "Add a platform", select "Web", paste the URL and select ID tokens and configure.

 

 

 

 

 

13. Head to "API Permissions" tab, click on "Add a permission" and select "Microsoft Graph". Select "Delegated permissions" and search for openid and click "Add permission".

 

 

Copying Bot endpoint URL

14. Head back to SupportCenter and copy the bot endpoint URL. Now go to the Tools tab in the Developer Portal, click on Bot Management and choose the Bot you just created.

15. Click on Configure and paste the bot endpoint URL that you copied.

 

 

16. Now go to your app, head to basic information and paste the Application ID you copied from Azure portal in the Application ID field.

 

 

17. Go to App features tab and paste the Application ID from Azure in Enter a bot ID field. Click Save.

 



Optional configuration to show the list of commands 

18. To display the list of available commands for users in their SupportCenter Plus bot chat, go to the App Features -> Bot -> Add a command. This is only an optional step and the commands can be used regardless.

 

 

 

Optional configuration for personalized requests view tab

19. By adding a personal tab, you can allow your technicians to track their SupportCenter Plus requests. The steps to add the tab are as follows:

20. Go to App Features -> Personal App -> Add a personal app. Provide a name for the app.                      

21. Under Content URL, append /WOListView.do?externalframe=true to the domain where the SupportCenter Plus domain is hosted.

22. Under Website URL, append /WOListView.do to the domain where SupportCenter Plus is hosted. Click Confirm.

 

  


Install SupportCenter Plus App for an Organization

23. Now that all the configurations have been completed, Click on Publish to Store in the left pane and click on Download app package.

 

 

 
 
24. Now go to Apps on the left pane -> Manage your apps and click on upload an app. Click on upload a custom app and select the SupportCenter Plus zip package that you just downloaded and add it.

 

 

 

 

Once the Microsoft Teams administrator makes the SupportCenter Plus bot available for the organization, each organization user, can authorize SupportCenter Plus from within the bot and start using the following commands.

Configure Bot Commands

By default, SupportCenter Plus contains a list of default commands that can be invoked from Microsoft Teams. You can create more custom commands and execute any action in Microsoft teams right using the SupportCenter Plus bot.

 

List of default commands in SupportCenter Plus

Commands

Description

/help

Displays a help card with the commands applicable to the logged in user

/create request

Quick create requests by providing only the subject and description

/view all requests

Lists all the requests of the user

/view open requests

Lists all the open requests of the user

/search request

Search requests using keywords (the keywords will be looked for in request subjects)

/pending approvals

Lists all the pending approvals of the user (user can perform approval actions from the respective request cards)

/overview

Displays a consolidated view of pending approvals and open requests

/select instance

Lists the portals for the user to select from

/revoke

Revoke SupportCenter Plus authorization from the Teams account

/chat (only for contact)

Initiates a chat with support rep

/end chat (only for contact)

Ends chat with support rep


Create Custom Commands

  1. In the Microsoft Teams Configuration page, go to Bot Commands tab.

  2. Click Custom Command.

  3. Enter the Name of the command.

  4. Outline the functioning of the command in Description.

  5. Configure the Actions to be performed when the command is executed. You can associate global functions as the action or create a global function using the New option. 

  6. Click Create Command. 

Use the View Script hyperlink to see the associated custom function script.

The created commands are reflected immediately in Microsoft Teams. Use the  icon to disable a command and prevent users from using it. You can enable it later if needed.

You can create cards in Microsoft Teams by invoking custom commands.

You can create cards in Microsoft Teams by invoking custom commands.

 

 

Edit/Delete Custom Commands

Click on a command name to modify the command details. Use Update to save the changes. You can use the  icon to delete the command.


With respect to the default commands, only the name and description can be edited. Default commands cannot be deleted, only disabled.

Create Cards in SupportCenter Plus Bot

You can create cards to be displayed in Microsoft Teams by initiating the respective command using global functions.

Create Cards to Add Request Tasks

To define the card layout

 


  • Go to Admin > Developer Space > Custom Function > Global Function.

  •  Click New to create a global function and paste the card JSON.

  1. test='{"attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"$schema":"htn":"sendActivity","type":"message"}';
  2. t=Map();
  3. t=test.toMap();
  4. return t;

Sample card JSON

 

  • The created card will appear as follows


To define the action buttons

  • Go to Admin > Developer Space > Custom Function > Global Functions > New.

  • Create a global function using the code mentioned below:


data = Collection();

data.insert("description":metadata.get("description"));

data.insert("title":metadata.get("title"));

data.insert("status":{"name":"Open"});

request_id=metadata.get("request_id");

input_data = {"task":data};

info input_data;

response = invokeurl

[

url:"https://zylker-scpclient.msapp.net/api/v3/requests/"+request_id+"/tasks"

type :POST

parameters:{"input_data":input_data,"TECHNICIAN_KEY":"67B0BCFC-A812-4D3B-A126-C86111DA3768"}

];

info response;

id=response.get("task").get("request").get("id");

responseStatus = response.get("response_status");

returnObj = Collection();

if(responseStatus.get("messages").get(0).get("status_code") == 200) {

returnObj.insert("action":"sendActivity","type":"message","text": "New Task added successfully to Id "+id);

}

else {

returnObj.insert("action":"sendActivity","type":"message","text":"Failed to add");

}

return returnObj;



On clicking the Create Task button present in the card the task for the specified request gets added in SupportCenter Plus. A success message is returned along with the ID.

Enable Group Notifications

After the bot is added to a team, SupportCenter Plus will be able to access the channels present in the team.

You can map the various support groups present in SupportCenter Plus with respective teams channels. When a request is assigned to a support group, the bot will trigger a notification to the respective channel.

  • Go to the Notifications tab in the Microsoft Teams Configuration page.

  • Select Enable Support group notifications to send alerts in the channel.

  • Map the support group and the teams channel from the respective drop-down. Use the Add icon to map multiple groups with their respective channels.

  • Click Update to save the mapped relationships.

Quick Create Requests

You can create requests in SupportCenter Plus from within Microsoft teams using the quick create feature. This feature works just like the Quick Create feature in SupportCenter Plus.

 

To create a request using this feature,

  • Execute the command /create request.
    [OR]
    Execute the command /overview and click Quick Create.

  • Enter the subject and description of the request and click Create Request. Click Cancel to abort the process.

 

 

 

 

The quick create option uses the default request template to create requests. If the default template has mandatory fields, you can update a request template without any mandatory fields in the database using the following query:


  1. Update BOTCOMMANDS set configuration='{"template":{"name":"<template_name>"}}' where internalname='createRequest';


Here <template_name> is the name of the template to be updated.

Perform Approval Actions on Requests

You can approve/reject a request or change in SupportCenter Plus from within the teams app. To do this,

  • Execute the pending approvals command from the chat window. This displays all your pending approvals as individual cards.

  • Add relevant comments and perform the required action for each approval.

  

Using Request View Tab

Users can track their SupportCenter Plus tickets under the Request View tab in the SupportCenter Plus app in Microsoft Teams.

 

 

Update/Remove Integration

  1. To update any configuration in the integration, make the changes and click Update.
  2. To disable the integration while restoring the configurations, uncheck Enable Microsoft Teams displayed at the top of the integration page.
  3. To completely remove the integration, click Remove displayed at the bottom of the page. Note that if you remove the integration, all configurations will be deleted and cannot be restored.

 

 

 

 

 

 

 

 


    • Related Articles

    • Integration Key

      SupportCenter Plus enables administrators configure multiple API keys to allow delegated access for different integration requirements. Apart from creating and managing integration keys, administrators can also reassign them to different support reps ...
    • Maps Integration

      You can integrate maps with SupportCenter Plus to view or manage support reps based on their location. This is a portal-specific configuration.   To set up maps integration:  1. Go to Admin > Integrations > Maps integration. 2. Enable maps ...
    • Zoom Integration

      Zoom integration allows you to extend Zoom functionalities to SupportCenter Plus.  This is an application-wide configuration.   To set up Zoom integration:  1. Go to Admin > Integrations > Zoom Integration (if only one portal is configured) or go to ...
    • Jira Integration

      You can integrate Jira with SupportCenter Plus for an enhanced help desk management. This is an application-wide configuration.   To set up Jira integration:  1.  Go to Admin > Integrations > Jira (if only one portal is configured) or go to Global ...
    • Computer Telephony Integration

      Computer Telephony Integration (CTI) allows you to extend the SupportCenter Plus functionality to support telephone calls within the application. This is an application-wide configuration. To configure CTI: 1. Go to Admin > Integrations > Telephony ...