You must have a Microsoft Teams account to configure a webhook.

This guide provides information on configuring webhooks using Microsoft Teams for alerts in ZDX. The following instructions provide a sample configuration that can be used based on the user’s requirements.

1. Select the team in which you want to add a channel for webhook notifications.
2. Click More Actions (…) > Add channel.

See image.

3. Enter the name of the channel and save your changes.

For example purposes, the channel is called Zscaler Webhook Channel.

4. On the Posts tab, where you can see the conversation, go to Channel > Connectors > Incoming Webhook > Configure.

See image.

5. Enter the name of the webhook. Adding an image is optional. Click Create.

For example purposes, the webhook name is called Alerting Information.

See image.

6. Copy the Zscaler Webhook Channel’s URL on the webhook configuration page.

See image.

7. Click Save.
8. Open and login to your ZDX Admin account.
9. Go to Administration > Alerts > Webhooks.
10. Click Add Webhook.
11. Enter the following information:
    1. Name: The name of the webhook for Microsoft Teams.
    2. Status: Select Enabled.
    3. URL: The URL you copied from the Microsoft Teams webhook configuration page.
    4. Authentication Type: Select Token.
    5. Bearer Token: Enter 1234.

Due to the nature of the Microsoft Teams webhook, a bearer token will not be checked.

See image.

11. (Optional) Click Test Webhook to confirm the webhook configuration works. Verify within the Microsoft Teams Webhook Channel from step 3.

See image.

12. Click Save.

Managing Incoming Webhooks in Microsoft Teams

To manage your configured webhooks for Microsoft Teams to update the URL or generate a new URL, select the impacted channel and go to Configured > Manage.

See image.