Microsoft Teams for Alert Notifications

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 (A) and a custom webhook in ThousandEyes (B):

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 Integrations and click + New Integration.
  2. 2.
    Select Custom Webhook.
  3. 3.
    Fill in the resulting fields as follows:
    • Name: The name should not have spaces. Example:ThousandEyes-MSTeams-Webhook-Test
    • URL: Copied in step 7 above when the incoming webhook app was added to the Teams channel.
    • Preset Configurations: This will populate the header and the message body.
  4. 4.
    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. 5.
    Save the integration.
    Success! You now have a working integration for Microsoft Teams that can be used for receiving alerts.
  2. 6.
    Apply the webhook to your existing alert rules using the resulting Manage Alert Rules side panel.
For more information on configuring webhooks, see Custom Webhooks.