Using Custom Webhooks to Integrate with Microsoft Teams

This article shows you how to receive ThousandEyes alert notifications in a Microsoft Teams channel using webhooks.
Microsoft Teams provides a 3-minute video and documentation on how to create an incoming webhook on the Microsoft Teams platform: Create Incoming Webhooks
To receive alert notifications in a Microsoft Teams channel, set up an incoming webhook in Microsoft Teams and a custom webhook in ThousandEyes:

A. In Microsoft Teams

  1. 1.
    Log in.
  2. 2.
    Configure a Teams channel for the webhook to use for alerts from ThousandEyes. You can create a new Teams channel or use an existing one. If you create a new Teams channel, you'll see screens like the following:
  3. 3.
    Join the Teams channel you are configuring to receive alert notifications. Click the + to add a tab.
  4. 4.
    Click Manage Apps.
  5. 5.
    Click the Incoming Webhooks app. If the app is not listed, select More apps and search for "Incoming Webhooks".
  6. 6.
    Add the Incoming Webhook app to the Teams Channel you are configuring to receive alert notifications. Type the name of the channel into the search box when prompted. This example uses ThousandEyes Custom Webhook Integration Channel. Then, click Set up a connector.
  7. 7.
    Give the Webhook Connector a name, copy the URL, and click Done. You may optionally upload a custom image.
    The Teams channel URL will be needed later to create the ThousandEyes Integration.
  8. 8.
    Verify the webhook has been added to the Teams channel. The following message should appear in the channel:

B. In ThousandEyes

  1. 1.
    In the ThousandEyes platform, navigate to Alert > Integrations > +New Integration. Create a new custom integration using the Microsoft Teams preset configuration.
  2. 2.
    Add the new integration as follows:
| Name |
The name should not have spaces. Example:
| | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | URL | Copied when the incoming webhook app was added to the Teams channel. | | Preset Configurations |
Microsoft Teams
from the pulldown selector. This will populate the header and the message body.
  1. 3.
    Click Test to verify that the new webhook is working. A successful test returns the message: Testing completed successfully! HTTP status: OK (200)
If the test fails, click Save to save the integration. Re-open the integration and test it again. If the test still fails, verify that the webhook URL in the ThousandEyes custom webhook matches the incoming Microsoft Teams webhook.
  1. 4.
    Save the integration.
    Success! You now have a working integration for Microsoft Teams that can be used for receiving alerts.
  2. 5.
    To make sure that alerts are sent through your new integration, apply the integration to your alert rules.
    To edit an alert rule, click Alerts > Alert Rules and select an alert rule whose alerts you want to be sent through this new integration. On the Notifications tab, under Integrations, select the integration, and click Save Changes.
For more information on configuring webhooks, see Alert Notifications Via Webhooks.