matrix

Matrix plugin

Posts each alert to a Matrix room with a bot access token. A retried send reuses its transaction id, so a room never gets a duplicate.

Kind notification_channel, ability read, outbound hosts: matrix.example.com placeholder, see the self-hosted note in docs/plugins-first-party.md.

Config

Plugin-wide, non-secret, passed at install with --config:

{"homeserver": "https://matrix.example.com", "room_id": "!abc123:example.com"}

Channel target

The channel's target field holds the bot's access token. It is sealed like any channel credential and sent per call. The plugin never stores or logs it.

levelrail-cli plugins install --manifest plugin.yaml --signature plugin.sig --config config.json --approve read
levelrail-cli channels create --name ops-matrix --kind plugin:matrix --notify-url syt_ACCESS_TOKEN

Behaviour

• 401 and 403 are permanent ("authentication failed").
• 429 waits out a short Retry-After and retries, otherwise reports retryable.
• 5xx and network errors retry twice, then report retryable.
• Other 4xx are permanent and the response excerpt is shown with the credential redacted.

Build and sign locally with scripts/plugins-build.sh all matrix. Tests: go test ./plugins/matrix.