the only FOSS-based service offering Matrix chat server hosting
Hookshot bridge
The Hookshot bridge installed by us is powered by hookshot
.
We previously used to install the appservice-webhooks bridge, but that one is less maintained and more limited in terms of functionality.
Hookshot supports integration with popular software project management services such as GitHub , GitLab , JIRA , and Figma , as well as generic webhooks .
Below, we describe the basic Hookshot usage for:
- creating webhooks to receive arbitrary data in Matrix rooms
- subscribing to RSS/Atom feeds to receive updates in Matrix rooms
Usage
Create a room and invite @hookshot:your-server.com
. When it joins, type !hookshot help
in the chat to see instructions.
Make sure the bot is able to send state events (usually the Moderator power level in clients).
Webhooks
Now that you’ve invited the bot to the room and ensured the permission level is adequate, send a !hookshot webhook yourwebhook
room message and you will receive a webhook link in a private message.
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 message via the webhook link. You will need to send a JSON body payload to it which looks like this:
{
"text": "Hello world!",
"username": "MyBot"
}
You can test this via curl
like so:
curl --header "Content-Type: application/json" \
--data '{
"text": "Hello world!",
"username": "MyBot"
}' \
THE_WEBHOOK_LINK_YOU_RECEIVED_EARLIER
For more information about webhook payloads and handling, see the Hookshot documentation about Webhooks .
Feeds (RSS, Atom)
Now that you’ve invited the bot to the room and ensured the permission level is adequate, send a !hookshot feed URL_HERE
message to register a new URL feed. (URL_HERE
needs to point to an RSS
or Atom
feed).
To list feeds that the bot currently subscribes to, use !hookshot feed list
.
To remove feeds from the list, use !hookshot feed remove URL_HERE
.
For more information about feed handling, see the Hookshot documentation about Feeds .