OTRS webhook

This guide describes how to integrate your Zabbix 5.0 installation with OTRS using the Zabbix webhook feature. This guide will provide instructions on setting up a media type, a user and an action in Zabbix.

Requirements

• OTRS version 6
• Zabbix version 5.0 or higher

Setting up a OTRS

1. Import ZabbixTicketConnector.yml in Admin > Web Services.

2. Create a new user for a Zabbix alerter with an email address.

Zabbix Webhook configuration

Create a global macro

1. Before setting up the Webhook, you need to setup the global macro {$ZABBIX.URL}, which must contain the URL to the Zabbix frontend.

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

3. Open the added OTRS media type and set:

• otrs_auth_user to the your Agent username
• otrs_auth_password to the your Agent password
• otrs_customer to your OTRS customer email
• otrs_queue to your OTRS ticket queue
• otrs_url to the frontend URL of your OTRS installation

4. If you want to prioritize issues according to severity values in Zabbix, you can define mapping parameters:

• severity_\<name>: OTRS priority ID

5. If you have dynamic fields in OTRS and you want them to be filled with values from Zabbix, add parameters in the form dynamicfield_\<OTRS dynamic field name>. Dynamic fields can only be of the text, textarea, checkbox, or date types.

6. Click the Update button to save the Webhook settings.

7. To receive notifications in OTRS, you need to create a Zabbix user and add Media with the OTRS type.

For Send to: enter any text, as this value is not used, but is required.

For more information, use the Zabbix and OTRS documentations.

Supported Versions

Zabbix 5.0