How to Create an Incoming Webhook URL for Microsoft (MS) Teams

This article will guide you through the steps of creating an incoming Webhook URL from MS Teams. A Webhook URL is a requirement for enabling IrisCX to push notifications to an external MS Teams channel.

Table of Contents

1. What is a Webhook URL?

2. Creating a Webook URL in MS Teams (Classic)

3. Creating a Webhook URL in MS Teams (New)

What is a Webhook URL?

A Webhook URL is a link provided by an application or service (e.g. MS Teams) that allows other applications (e.g. IrisCX) to send real-time data to it. Essentially, it's an endpoint on the internet that receives incoming messages.

Webhooks are commonly used for integrating various services where real-time data synchronization or actions are necessary, such as notifications systems. They provide an efficient way to achieve real-time, automated interactions between different software systems.

Creating a Webhook URL in MS Teams (Classic Teams)

1. In the Classic Teams client, select Teams  and navigate to the channel where you want to add an Incoming Webhook.

2. Select More options ••• from the upper-right corner.

3. Select Connectors from the dropdown menu.

   

   1. Search for Incoming Webhook and select Add.

      

      The Incoming Webhook dialog appears.

   2. Select Add.

      

       Note

      If you’ve already added an Incoming Webhook, the Configure option appears. Select Configure to create an Incoming Webhook.

   3. Provide a name for the webhook and upload an image if necessary.

   4. Select Create.

      

   5. Copy and save the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams.

   6. Select Done.

      

4. The webhook is now available in the Teams channel.

Creating a Webhook URL in MS Teams (New Teams)

1. In the New Teams client, select Teams  and navigate to the channel where you want to add an Incoming Webhook.

2. Tap on the Expand Channel Details icon at the top right, then Manage Channel
   

3. Scroll down to Connectors, then Select Edit.

   

4. Search "Incoming Webhook"

   

    

5. After the Incoming Webhook dialog appears, tap Add.

   

   Note: If you’ve already added an Incoming Webhook, the Configure option appears. Select Configure to create an Incoming Webhook.

6. Provide a name for the webhook  (e.g. Iris Alerts) and upload an image (not a requirement).

7. Select Create.

   

8. Scroll to the bottom and copy the unique webhook URL present in the dialog. The URL maps to the channel and you can use it to send information to Teams.

   

Select Done. Please share this URL with IrisCX!