Compare commits

...

2 Commits

Author SHA1 Message Date
Julian-Samuel Gebühr 742ca95d84 [feature] Document using the hosted alertbot 2023-03-15 07:08:57 +01:00
Julian-Samuel Gebühr ae6e49b75d ![refactor] Bot does now respond with full webhook URL 2023-03-15 07:04:30 +01:00
3 changed files with 15 additions and 3 deletions

View File

@ -1,3 +1,7 @@
# March 2023
Change `!url` to display the full webhook url not just the base
# December 2022
* Handle sending an alert to a room where the bot is not allowed to send messages [#2](https://github.com/moan0s/alertbot/issues/2)

View File

@ -8,8 +8,16 @@ join the [Alertbot room on matrix](https://matrix.to/#/#alertbot:hyteck.de)
# Getting Started
## OPTION 1: Use provided alertbot
* Create a Matrix room and invite @alertbot:hyteck.de
* Send `!url` to the room. The bot will answer with the webhook URL
* Put the Webhook URL into your monitoring solution (see below)
## OPTION 2: Selfhost alertbot
**Prerequisites:**
* A maubot instance: Please [refer to the docs](https://docs.mau.fi/maubot/usage/setup/index.html) for setting up one
* A Matrix server where you have access to a maubot instance: Please [refer to the docs](https://docs.mau.fi/maubot/usage/setup/index.html) for setting up one
* An instance of alertmanager or grafana or a similar alerting program that is able to send webhooks
**Getting the code**
@ -84,7 +92,7 @@ curl --header "Content-Type: application/json" \
# Local testing Setup
Also you might want to test the bot on your local machine but send webhooks to a public server. To do that use a domain
You might want to test the bot on your local machine but send webhooks to a public server. To do that use a domain
e.g. webbhook.example.com and configure nginx as reverse proxy for port 4242 for this domain.
## Connect

View File

@ -208,7 +208,7 @@ class AlertBot(Plugin):
@command.new()
async def url(self, evt: MessageEvent) -> None:
"""Answers with the url of the webhook"""
await evt.reply(f"`{self.webapp_url}/webhook`")
await evt.reply(f"`{self.webapp_url}/webhook/{evt.room_id}`")
@command.new()
async def raw(self, evt: MessageEvent) -> None: