Microsoft Teams

Microsoft Teams

Microsoft Teams is a unified communication and collaboration platform that combines persistent workplace chat, video meetings, file storage (including collaboration on files), and application integration.

Available solutions




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


Microsoft Teams webhook

This guide describes how to integrate Zabbix 5.0 with MS Teams using the Zabbix webhook feature. This guide will provide instructions on setting up a media type, a user and an action in Zabbix. This integration is supported only for Teams as part of Office 365. Note, that Teams free plan does not support incoming webhook feature.

Setting up webhook in MS Teams

1. Create incoming webhook for the channel, where you want to receive notifications. (See Teams documentation for the step-by-step instructions).

Setting up webhook in Zabbix

1. n the Zabbix web interface go to Administration → General section and select Macros from the dropdown menu in top left corner. Setup the global macro "{$ZABBIX.URL}" which will contain the URL to the Zabbix frontend.
The URL should be either an IP address, a fully qualified domain name or localhost. Specifying a protocol is mandatory, whereas port is optional. Good examples:
http://zabbix.com
https://zabbix.lan/
http://localhost
http://127.0.0.1:8080

Bad examples:
zabbix.com
http://zabbix/

2. In the Administration > Media types section, import the media_msteams.xml

3. Open the newly added MS Teams media type and replace placeholder <PLACE WEBHOOK URL HERE> with the incoming webhook URL, created during the webhook setup in MS Teams.

4. ou can also choose between two notification formats. Set "use_default_message" parameter:

  • false (default)
    • Use preformatted message with predefined set of fields for trigger-based notifications.
      In internal, autoregistration and discovery notifications {ALERT.SUBJECT} as a title and {ALERT.MESSAGE} as text a body of the message will be used.
  • true
    • Use {ALERT.SUBJECT} as a title and {ALERT.MESSAGE} as text a body of the message in all types of notifications.

5. To receive Zabbix notifications in MS Teams, you need to create a Zabbix user and add Media with the MS Teams media type.
In the Administration → Users section, click Create user button in the top right corner. In the User tab, fill in all required fields (marked with red asterisks). In the Media tab, add a new media and select "MS Teams" type from the drop-down list. Though a "Send to" field is not used in MS Teams media, it cannot be empty. To comply with the frontend requirements, you can put any symbol there.
Don’t forget that in order to send notifications, this user must have access to hosts that generated such problems

6. Great! You can now start receiving alerts!

For more information see Zabbix and MS Teams webhook documentations.

Supported Versions

Zabbix 5.0

Articles and documentation

+ Propose new article
Add your solution