etke.cc
the only FOSS-based service offering Matrix chat server hosting
  etke.cc
  - the only FOSS-based service offering Matrix chat server hosting
🌓 Theme

Webhooks bridge

🌐 This page is also available in: Deutsch
Non-English support is best-effort. The English version is more complete.

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