Skip to content

Configure Matrix alerts

FlaskTrack can send alerts to a Matrix room using the Matrix client-server API.

Required values

  • Homeserver URL, such as https://matrix.example.org.
  • Access token for the Matrix user or service account that will send messages.
  • Room ID, typically beginning with ! and including the homeserver name.

Use a dedicated service account where possible. Invite it to the room and grant only the permissions required to post messages.

Configure FlaskTrack

  1. Open the organization’s alert integration settings.
  2. Choose Matrix.
  3. Enter the homeserver URL, access token, and room ID.
  4. Select the enabled alert types.
  5. Save and send a test notification.

Troubleshooting

  • Confirm the access token is valid and belongs to a user joined to the room.
  • Use the internal room ID, not only a human-readable room alias.
  • Verify the homeserver URL is reachable from the FlaskTrack deployment.
  • Confirm the room permits the service account to send m.room.message events.
  • Rotate the token after exposure or account changes.

Matrix client-server API