Microsoft Teams Custom Widget 

Overview 

The Microsoft Teams custom widget enables you to create and schedule meetings in Microsoft Teams from within the ServiceDesk Plus. 

Here are the easy-to-follow, step-by-step instructions for setting up the Microsoft Teams widget in ServiceDesk Plus.

Step 1: Set up Azure app registration

• Go to the Azure portal > App registrations > New registration.

• In the Register an application form, 

  • Enter a name for the app registration.

  • Under Supported account types, choose Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant). 

  • Under Redirect URI, select Web from the drop-down and specify the URL in the below format:

    https://<sdp_domain>/integration/oauth/callback (where <sdp_domain> should be replaced with the actual ServiceDesk Plus domain)

  • Click Register.

3. After you register, you will be redirected to the app registration's details page. Copy the Application ID (Client ID) and make a note of it for later use.

4. Go to Manage in the left pane > Certificates and secrets > New client secret. 

   1. In the Add a client secret form, enter a name and select the validity from the Expires drop-down.

   2. Click Add.

5. Copy the value of the secret generated and make a note of it for later use. 

6. Go to the API permissions tab in the left pane. 

7. Go to Add a permission > Microsoft Graph > Delegated permissions.

8. Add the following three delegated permissions: 

                   Calendars.ReadWrite.Shared
                   OnlineMeetings.ReadWrite
                   offline_access

 Step 2: Set up ServiceDesk Plus: 

1. Go to Admin > Developer Space > Connection.

2. Create a new service:

   • Go to Custom Services. 

   • Click Create Service.

   • Name the service and service link as microsoftteams. 

   •  The Service Name must contain only alphanumeric characters, either as a single word or in snake case. For example, microsoftteams or microsoft_teams. Set the Authentication Type to OAuth2.

   • In the Client ID and Client Secret fields, paste the values copied from the initial steps on the Azure portal, respectively.

   • In the Authorize URL field, paste the below value:

     • https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize

   • In the Access Token URL and the Refresh Token URL fields, paste the below value:

     • https://login.microsoftonline.com/organizations/oauth2/v2.0/token

   • Add the following three scopes with the same values for both Scope and Scope Display Name fields. Click the plus icon next to the Display Name field to add more scopes.
     Calendars.ReadWrite.Shared, OnlineMeetings.ReadWrite, offline_access

• Select Space from the Scope Delimiter drop-down.

• Click Create Service. 

3. Create a new connection: 

   • After you create the service, click Create Connection. 

   • Provide a name for the connection, similar to the service name.

   • Select all the three scopes.

   • Click Create And Connect.

4. Establish the connection:

   • After you create the connection, click Connect.

   • 

   • Follow the on-screen instructions which will authorize the connection between Microsoft and ServiceDesk Plus.

The connection between the two services is now established. Next, you need to configure the Microsoft Teams widget in ServiceDesk Plus. 

 Step 3: Configure the Widget 

1. Download the custom widget zip from here and unzip it.

2. Open the plugin-manifest.json file in a text editor.

3. Locate the connections object in the editor and update it with the connection details found under Admin > Connections > My Connections > <your_connection_name> > JSON in ServiceDesk Plus.

4. After you complete the configuration, re-zip all the files of the widget.

 Step 4: Upload the Custom Widget 

1. Go to Admin > Developer Space > Custom Widget.

2. Click + Custom Widget.

3. Enter a name for the custom widget. 

4. Upload the zipped widget file. The supported file format is .zip and the maximum file size is 5MB.

5. Click Save.

Now, you should be able to access the Microsoft Teams widget.

How to access the Microsoft Teams widget in ServiceDesk Plus  

1. Go to an existing request in ServiceDesk Plus.

2. You should now see a Microsoft Teams pane added to the request details page on the right side.

3. In the widget, click Create a Meeting to schedule meetings in ServiceDesk Plus. 

4. Enter a title and choose an option in Schedule Options.

5. Click Create Meeting.

The meeting will be created in Microsoft Teams.

6. Click View Session History to view the history of all previous meetings.