Zabbix Documentation 5.0

This media type is useful for making HTTP calls using custom JavaScript code for straightforward integration with external systems like helpdesk systems, chats or messengers.

To use a webhook as the notification mechanism, you need to first configure a webhook as the media type and then indicate specific addresses for users, before using the media type in action configuration.

You may import a preconfigured webhook media type or as well as create your own.

The following integrations are available allowing to use predefined webhook media types for pushing Zabbix notifications to:

• Discord
• Jira
• Jira Service Desk
• Mattermost
• Microsoft Teams
• Opsgenie
• OTRS
• Pagerduty
• Pushover
• Redmine
• ServiceNow
• SIGNL4
• Slack
• Telegram
• Zammad
• Zendesk

To configure a webhook as the media type:

• Go to Administration → Media types
• Click on Create media type

The Media type tab contains various attributes specific for this media type:

All mandatory input fields are marked with a red asterisk.

The following parameters are specific for the webhook media type:

See common media type parameters for details on how to configure default messages and alert processing options.

Create a JIRA issue and return some info on the created issue.

try {
	Zabbix.Log(127, 'jira webhook script value='+value);
 
	var result = {
		'tags': {
			'endpoint': 'jira'
		}
	},
	params = JSON.parse(value),
	req = new CurlHttpRequest(),
        proxy = params.HTTPProxy;
        req.SetProxy(proxy);
	fields = {},
	resp;
 
	req.AddHeader('Content-Type: application/json');
	req.AddHeader('Authorization: Basic '+params.authentication);
 
	fields.summary = params.summary;
	fields.description = params.description;
	fields.project = {"key": params.project_key};
	fields.issuetype = {"id": params.issue_id};
	resp = req.Post('https://tsupport.zabbix.lan/rest/api/2/issue/',
		JSON.stringify({"fields": fields})
	);
 
	if (req.Status() != 201) {
		throw 'Response code: '+req.Status();
	}
 
	resp = JSON.parse(resp);
	result.tags.issue_id = resp.id;
	result.tags.issue_key = resp.key;
} catch (error) {
	Zabbix.Log(127, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
	Zabbix.Log(127, 'jira issue creation failed : '+error);
 
    result = {};
}
 
return JSON.stringify(result);

Send notification to a Slack channel.

var req = new CurlHttpRequest();
params = JSON.parse(value);
proxy = params.HTTPProxy;
req.SetProxy(proxy);
req.AddHeader('Content-Type: application/x-www-form-urlencoded');
 
Zabbix.Log(127, 'webhook request value='+value);
 
req.Post('https://hooks.slack.com/services/KLFDEI9KNL/ZNA76HGCF/h9MLKJMWoUcEAz8n',
  'payload='+value
);
 
Zabbix.Log(127, 'response code: '+req.Status());
 
return JSON.stringify({
  'tags': {
    'delivered': 'slack'
  }
});

Once the webhook media type is configured, go to the Administration → Users section and edit a user profile to assign media of this type to the user. Steps for setting up user media, being common for all media types, are described in this section.

Note, that when defining a user media, a Send to field cannot be empty. If this field will not be used by a webhook, enter any combination of supported characters to bypass validation requirements.