1. Help Center
  2. Admin & Configuration

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.

    Screenshot shows how to select connector.

    1. Search for Incoming Webhook and select Add.

      Screenshot shows the Add option to add an Incoming Webhook.

      The Incoming Webhook dialog appears.

    2. Select Add.

      Screenshot shows the Add option in the Incoming Webhook dialog.

       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.

      Screenshot shows the name and image fields to be filled to create the webhook.

    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.

      Screenshot shows the unique webhook URL.

    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. Select More options ••• on the right side of the channel name.

  3. Select Manage channel.

    Screenshot shows the Manage channel option under More options for Teams 2.1.

  4. Select Edit.

    Screenshot shows the edit option under Connectors option to add an Incoming Webhook.

  5. Search for Incoming Webhook and select Add.

    Screenshot shows the Add option to add an Incoming Webhook.

    The Incoming Webhook dialog appears.

  6. Select Add.

    Screenshot shows the Add option in the Incoming Webhook dialog.

     Note

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

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

  8. Select Create.

    Screenshot shows the name and image fields to be filled to create the webhook.

  9. 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.

  10. Select Done. The webhook is now available in the Teams channel.

    Screenshot shows the unique webhook URL.