Webhooks bridge

This page is also available in: Deutsch, Русский

The Webhooks bridge installed by us is powered by appservice-webhooks.

The Webhooks bridge provides Slack-compatible webhooks for Matrix.

It should be noted that we used to install the redoonetworks/matrix-appservice-webhooks fork, which is more maintained than the original parent project (turt2live/matrix-appservice-webhooks ).

We’re no longer installing this Webhooks bridge. Instead, we’re now installing the newer and more powerful Hookshot bridge.

Usage

  1. Create a room with the Webhooks bot (@_webhook:your-server.com) or invite the bot to an existing room.
  2. Send a !webhook message and you will receive a private message which includes a webhook link.
  3. You can use this link with external systems which support webhooks.

To verify that the webhook link works, or to make use of it from your own systems, send a new request to the webhook link. You will need to send a JSON body payload to it which looks like this:

{
    "text": "Hello world!",
    "format": "plain",
    "displayName": "My Cool Webhook",
    "avatar_url": "https://i.imgur.com/IDOBtEJ.png"
}

You can test this via curl like so:

curl --header "Content-Type: application/json" \
--data '{
"text": "Hello world!",
"format": "plain",
"displayName": "My Cool Webhook",
"avatar_url": "https://i.imgur.com/IDOBtEJ.png"
}' \
THE_WEBHOOK_LINK_YOU_RECEIVED_EARLIER