# Topdesk Alarm Callback

**URL:** <https://community.graylog.org/t/topdesk-alarm-callback/22694>\
**Category:** Plug-Ins\
**Tags:** plug-in\
**Created:** [February 17, 2022, 7:34pm UTC](https://community.graylog.org/t/topdesk-alarm-callback/22694 "2022-02-17T19:34:17Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![dscryber](https://sea2.discourse-cdn.com/flex016/user_avatar/community.graylog.org/dscryber/32/14178_2.png) [@dscryber](https://community.graylog.org/u/dscryber)\
**Post date:** [February 17, 2022, 7:34pm UTC](https://community.graylog.org/t/topdesk-alarm-callback/22694/1 "2022-02-17T19:34:17Z")

</div>

# [Topdesk Alarm Callback](https://marketplace.graylog.org/addons/85f1a1cf-5bc0-4fd7-8bd1-193e03c81c8d)

@cvtienhoven

- [Download from Github](https://github.com/cvtienhoven/graylog-plugin-topdesk/releases/tag/1.0.10)
- [View on Github](https://github.com/cvtienhoven/graylog-plugin-topdesk)
- [Issues](https://github.com/cvtienhoven/graylog-plugin-topdesk/issues)
- [Stargazers](https://github.com/cvtienhoven/graylog-plugin-topdesk/stargazers)

### Plugin 1.0.10

Topdesk Alarm Callback for Graylog

- [alarmcallback](https://marketplace.graylog.org/addons?tag=alarmcallback)
- [Topdesk](https://marketplace.graylog.org/addons?tag=Topdesk)
- [incident](https://marketplace.graylog.org/addons?tag=incident)

@cvtienhoven

# Topdesk Plugin for Graylog

[![Build Status](https://camo.githubusercontent.com/4cb7562f897ba2fef949cb1f3cc734eaea756b3aeafaac14f7597c16fad34e5b/68747470733a2f2f7472617669732d63692e6f72672f63767469656e686f76656e2f677261796c6f672d706c7567696e2d746f706465736b2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/cvtienhoven/graylog-plugin-topdesk)

**Required Graylog version:** 2.4 and later

This plugin enables you to call the Topdesk API to create incidents.

## Installation

[Download the plugin](https://github.com/https://github.com/cvtienhoven/graylog-plugin-nexmo.git/releases) and place the `.jar` file in your Graylog plugin directory. The plugin directory is the `plugins/` folder relative from your `graylog-server` directory by default and can be configured in your `graylog.conf` file.

Restart `graylog-server` and you are done.

## Use cases

This plugin is useful when you need to create incidents in Topdesk.

## Usage

### Configure the alarm callback

You can configure an alert condition in Graylog and add the `Topdesk Alarm Callback` as the Callback Type. In the popup that occurs you can configure the options to send the incident. Not all optional API request fields are implemented, but this should get you going. Also some find and replace in the description makes it possible to define a template and replace the placeholders with a field value for the first message. You can also use some basic HTML tags as described in the [Topdesk API](https://developers.topdesk.com/documentation/index.html#api-Incident-CreateIncident) for the `request` field.

**Note** : Currently an HTTPS connection is established over without verifying certificates. Connection options might be extended in the future.

## Getting started

This project is using Maven 3 and requires Java 8 or higher.

- Clone this repository.
- Run `mvn package` to build a JAR file.
- Optional: Run `mvn jdeb:jdeb` and `mvn rpm:rpm` to create a DEB and RPM package respectively.
- Copy generated JAR file in target directory to your Graylog plugin directory.
- Restart the Graylog.

## Plugin Release

We are using the maven release plugin:

```auto
$ mvn release:prepare
[...]
$ mvn release:perform

```

This sets the version numbers, creates a tag and pushes to GitHub. Travis CI will build the release artifacts and upload to GitHub automatically.