Microsoft Teams Workflows Integration with Zabbix (Complete Setup Guide)

Microsoft will be discontinuing their Office365 Connectors and if you want to get notifications from Zabbix on to a MS Teams channel via a webhook URL, you will need to make use of Teams Workflows. This unfortunately is not a simple task as copy pasting the URL on to some configuration box inside Zabbix.   

Download the official Zabbix Teams Workflows integration 

First check your Zabbix version. This can be found easily on the footer of your Zabbix UI.

Visit the official Zabbix website to download the respective Teams workflow version

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

If your Zabbix version is not visible here on the site itself, check out their Zabbix git repo:

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

Select your version from the branch list and download the media_msteams_workflow.yaml

In case if you downloaded the entire 200 something MB branch, you can find this yaml in the following path /templates/media/msteams-workflow/media_msteams_workflow.yaml

Import the media type into Zabbix

In Zabbix, go to Alerts → Media types (older versions: Administration → Media types).

Select Import and upload the yaml

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

Copy the webhook URL from the Teams channel.

Paste on the teams_endpoint

It is also essential to have the ZABBIX.URL macro configured from Administration > General > Macros

To test out this Workflow, fill out the essential fields from the form as follows:

Set the alert message, subject, severity, source, endpoint url and zabbix url (https://zabix.yourdomain.com/zabbix)

If everything is filled correctly you will receive your test alert as follows:

Things do not end here!

Even though our test message was received successfully, in-order for the alerts notifications to be sent out during incident detection, you need to configure zabbix actions.

Goto Configurations > Actions > Trigger actions > send_teams_alert > Operations and edit your existing operation. Change the 'Send only to' from MS Teams to MS Teams Workflow and update.

 

Your suffering could end here from the trigger actions state but some versions may still require you to update the media in your Zabbix admin account as well. Goto the Users page > Admin > Media > edit your existing MS Teams media type

Change MS Teams to MS Teams Workflows

Hit on update and make sure you hit update again on this page before you leave the page, if not it will not save!