Integrating MS teams with SDP MSP using Webhooks

Integrating MS teams with SDP MSP using Webhooks

PURPOSE:

When a request is created under SDP MSP, a message is posted in the Microsoft Teams channel associated with the Account of the request.

TESTED IN BUILDS: 14500, 14503 and 14504

PROCEDURE:

STEP 1: Creating a Connector:

>> To start, create a connector that links the specific MS Teams Channel with SDP MSP. Navigate to the required Channel in a team in MS Teams, click on the three dots next to the channel, and select "Connectors".



>>In the redirected page, search for "Incoming Webhooks" and click on "Add". Once added, click on the three dots next to the channel again and choose "Connectors".



>> In the next page, click on "configure." Provide a name for the Incoming Webhook, create it, and optionally change the picture. 

>> In the next page, copy the provided endpoint URL, as it will be used in the integration.



STEP 2: Creating a Webhook in SDP MSP:

>> Under Admin > Developer Space - Webhooks - Request, create a new Webhook and assign a name.

>> Set the HTTP Method to "Post," and place the MS Teams endpoint URL under "URL."

>> The next step is to configure the "Request Payload" to define the message to be posted in the teams channel in JSON format.

For example: If the message is "A new request has been created in Account 1", the format should be as below,

{
"text":"A new request has been created in Account 1"


>> To include dynamic content like request ID or subject etc.., use the "$" symbol and select the variable from the dropdown.



>> Once all details are filled, click on Save.

STEP 3: Configuring a custom trigger:

>> Under Admin > Request Custom Trigger, create a new custom trigger.



>> The condition set here is when "Account" is "Acc1". The condition can be modified according to the requirement.

Now, when a request is created under Acc1, a message with the request details will be posted in the associated MS Teams channel.

NOTE:

>> You can include formatting options in the message content. Supported formatting options by Microsoft include:
  1. Bold Text : **bold text**
  2. Italic Text : _italic text_
  3. Strikethrough Text : ~~strikethrough text~~
  4. Bold and Italic Text : **_bold and italic text_**
For example:

Webhook in SDP MSP:



Post in MS teams:



>> Keep the connector's endpoint URL confidential, as anyone with that URL will be able to post messages in that channel.


                  New to ADSelfService Plus?

                    • Related Articles

                    • Integrating MS teams with SDP MSP using Webhooks

                      Overview: ServiceDesk Plus MSP seamlessly integrates with MS Teams to create a collaboration between the apps whenever any incidents takes place. This integration automatically posts updates about new requests from ServiceDesk Plus MSP to the ...
                    • Integrating Zoho Projects with SDP MSP change management

                      Overview: Automatically creating projects in Zoho Projects based on the changes in SDP MSP keeps everything in sync without manual updates. This means all tasks and updates on a Change are automatically reflected in Zoho Projects, making it easier to ...
                    • Automatically create MS Planner tasks in SDP Projects using MS Power Automate.

                      In many organizations, project teams use various tools to manage their tasks. For instance, a team might use Microsoft Planner (MS Planner) to organize and assign tasks due to its simplicity and integration with other Microsoft 365 applications. ...
                    • Azure DevOps Integration

                      Feature:  Azure DevOps Integration <-->  ServiceDeskPlus (Plugin Model) --> Create a new work-item in Azure DevOps when a request is created in SDP --> Update SDP request status when a Azure DevOps work-item status is updated --> Updating Comments ...
                    • Notification script using Custom function in custom trigger

                      This is applicable from 10600 builds. From 10600 , Business rules dont have Email notification feature. The same use case be achieved through Custom triggers feature as mentioned below. Script to enable notification of request creation using custom ...