Microsoft Teams Workflows Integration with Zabbix (Complete Setup Guide)

Microsoft is discontinuing Office 365 Connectors. If you want to send Zabbix notifications to a Microsoft Teams channel using a webhook URL, you now need to use Teams Workflows.

Unfortunately, this is not as simple as copying a webhook URL into a configuration box inside Zabbix. You need to import and configure the official Teams Workflow media type first.

Download the Official Zabbix Teams Workflow Integration

First, check your Zabbix version. You can find this easily in the footer of your Zabbix UI.

Visit the official Zabbix integration page and download the Teams Workflow media type for your Zabbix version:

https://www.zabbix.com/integrations/msteams#msteams-workflow

If your Zabbix version is not visible on the website, check the official Zabbix Git repository:

https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow/

Select your version from the branch list and download:

media_msteams_workflow.yaml

If you downloaded the entire branch, you can find the YAML file in this path:

/templates/media/msteams-workflow/media_msteams_workflow.yaml

Import the Media Type into Zabbix

In Zabbix, go to Alerts → Media types. In older versions, this may be under Administration → Media types.

Select Import and upload the YAML file.

After importing, open the new media type named Microsoft Teams Workflow.

Copy the webhook URL from your Teams channel workflow.

Paste the webhook URL into the teams_endpoint field.

Configure the Zabbix URL Macro

It is also important to configure the ZABBIX.URL macro from Administration → General → Macros.

Use your Zabbix frontend URL as the value. For example:

https://zabbix.yourdomain.com/zabbix

Test the Teams Workflow Media Type

To test the workflow, fill in the required fields in the media type test form. Set the alert message, subject, severity, source, endpoint URL, and Zabbix URL.

If everything is configured correctly, you should receive a test alert in Teams.

Update Zabbix Trigger Actions

Things do not end here.

Even if the test message is received successfully, Zabbix will not automatically start sending incident notifications through the new workflow unless your actions are updated.

Go to Configuration → Actions → Trigger actions → send_teams_alert → Operations and edit your existing operation.

Change Send only to from MS Teams to MS Teams Workflow, then update the operation.

Update the User Media Type

Your suffering could end at the trigger action step, but some Zabbix versions may still require you to update the media configured for your Zabbix admin user as well.

Go to Users → Admin → Media and edit your existing MS Teams media type.

Change the media type from MS Teams to MS Teams Workflow.

Click Update, and make sure you click Update again on the user page before leaving. Otherwise, the change may not save.

#cloud #monitoring