README.md

@@ -166,19 +166,28 @@ THX to the previous work of @decentral1se @knooflok @3wc @cellarspoon @mirsal
 ```
 COMPOSE_FILE="$COMPOSE_FILE:compose.matrix-alertmanager-receiver.yml"
 ```
+2. Create a matrix bot account and get an access token:
 
-2. Insert the matrix access token secret:
+```
+abra app run matrix.example.com app -- sh -c 'register_new_matrix_user -u <botusername> --no-admin -k "$(cat /var/run/secrets/registration)" http://localhost:8008'
+curl -XPOST --json '{"type": "m.login.password", "identifier": {"user": "botusername", "type": "m.id.user"}, "password": "passwordforuser"}' "https://matrix.example.com/_matrix/client/v3/login" 
+```
+
+3. Insert the matrix access token secret:
 ```
 abra app secret insert monitoring.marx.klasse-methode.it matrix_token v1
 ```
 
-3. Set required configurations:
+4. Set required configurations:
 ```
-GF_MATRIX_USER_ID=
-GF_MATRIX_ROOM_ID=
-GF_MATRIX_HOME_SERVER_URL=
+GF_MATRIX_USER_ID=<botusername>
+GF_MATRIX_ROOM_ID=<room-id>
+GF_MATRIX_HOME_SERVER_URL=matrix.example.com
 ```
-4. Configure Alertmanager webhook and set the url to `http://matrix-alertmanager-receiver:12345/alerts/<room-id>`
+5. Configure Alertmanager webhook:
+  - Create contact point under Grafana → Alerting → Contact Points → New Contact Point
+  - Set Integration to "Webhook"
+  - Set the url to `http://matrix-alertmanager-receiver:12345/alerts/<room-id>`
 
 ### Alerts