Bridges

For the full list of available bridges and to get help, join #bridges:mbot.ethz.ch. New bridges and updates will be posted in this room.

Hookshot

The source code for the bridge is available at matrix-hookshot on Github. Currently enabled features:

  • Generic webhooks

Generic webhooks

Base URL: https://hookshot.mbot.ethz.ch/webhook/<hook>

  1. Invite hookshot (@hookshot:mbot.ethz.ch) to your unencrypted room
  2. Give the bot permissions (Moderator)
  3. Send the message !hookshot webhook <name> (replace <name>)
  4. The bridge will send you an URL

The bridge accepts GET, POST or PUT requests. See docs for details or the example below.

Example usage

Example json payloads:

{"text":"Hello world!"}
{"text":"Hello **world**!"}
{"text":"Hello world!","html":"Hello <b>world</b>!"}
{"text":"Hello world!","username":"Jay Doe"}

Example using httpie:

http POST "<url>" <<<'<payload>'

Example using curl:

curl --header "Content-Type: application/json" --data '<payload>' "<url>"

Example using GET request:

http GET "<url>?text=Hello+world"

Webhook API (Grafana, Slack)

Base URL: https://webhooks.mbot.ethz.ch/webhook/<api>/<hook>

This API translates incoming webhooks into generic webhooks (hookshot). The source code is available at webhook-to-matrix-hookshot on the ETH Gitlab.

  1. Create a generic webhook using hookshot (see above)
  2. Use the <hook> URL part from hookshot with the base URLs listed below

Grafana webhook notification

Base URL: https://webhooks.mbot.ethz.ch/webhook/grafana/<hook>

  1. Create a new notification channel for the room: Alerting > Notification channels
  2. Select Type: webhook
  3. Paste the url into the Url field
  4. Disable Notification settings > Include image

Grafana Slack notification

Base URL: https://webhooks.mbot.ethz.ch/webhook/slack/<hook>

  1. Create a new notification channel for the room: Alerting > Notification channels
  2. Select Type: Slack
  3. Paste the url into the Webhook Url field
  4. Disable Notification settings > Include image
  5. Optional: Set Optional Slack settings > Username to Grafana

Heisenbridge

A bouncer-style Matrix IRC bridge. Can be used as an alternative to existing bridges using matrix-appservice-irc which already bridge many IRC networks to Matrix.

The source code is available at hifi/heisenbridge on Github.

  1. Start a DM with heisenbridge (@heisenbridge:mbot.ethz.ch)
  2. Type help or <command> -h to get started

Webhooks (slack-compatible) deprecated!

Deprecated: This bridge is replaced by hookshot (and optionally our webhook api to translate Slack/Grafana webhooks). Do not use it anymore and migrate existing notification channels to the new bridge.

Base URL: https://webhooks.mbot.ethz.ch/<hook>

The source code for the bridge is available at turt2live/matrix-appservice-webhooks on Github.

Slack

Talk to rda in #bridges:mbot.ethz.ch if you want to bridge your Slack channels to Matrix. Our integration manager does currently not support bridge provisioning.

A fully functioning bridge can be tested in #isg-slack-bridge:phys.ethz.ch.