matterbar

Matterbar

A Mattermost plugin integration with Rollbar webhook events.

Installation

Follow the Mattermost docs if necessary.

1. Go to releases and download the latest release.
2. Upload to your Mattermost server via System Console -> Plugins -> Management.

Configuration / Usage

Configure the plugin itself in System Console -> Plugins -> Matterbar.

• Default Team: if this isn't specified, a team query parameter will be expected.
• Default Channel: if this isn't specified, a channel query parameter will be expected.
• Username: (required) the user that the plugin will post as upon receiving Rollbar webhook events.
• Auth Secret: the auth string, expected in the auth query parameter to authenticate incoming requests.

At the very least, hit the auth secret Regenerate button, and input a Username. If any of these are misconfigured, e.g. a default team or channel does not exist, the plugin will log the error to the Mattermost system logs.

On the Rollbar side, configure your webhooks at

https://rollbar.com/<user-or-organization>/<project>/settings/notifications/webhook/ .

Set the URL to point to your Mattermost instance, and the plugin's custom webhook endpoint at

https://<mattermost-server-instance>.com/plugins/matterbar/notify?auth=<auth-secret>&team=<team-name>&channel=<channel-name> .

For example:

https://mattermost.example.com/plugins/matterbar/notify?auth=YT5QclfXXrLyMDl-zw2bLv0aD0TlSX13&team=developers&channel=rollbars

team and channel can be omitted if the defaults have been configured. They can also be configured on a per webhook rule basis to customize where Rollbar notifications will be posted.

/rollbar command

The plugin also comes with a custom slash command to set users who wish to @'d.

• /rollbar list: lists the users who will be @'d whenever an event is posted
• /rollbar notify @username: adds the user to the @ list
• /rollbar remove @username: removed the user from the @ list

The list of @'d users is separate per channel.