Matrix

ActionsFrom Community

• Trigger
• Message

Matrix

#alarme:matrix.org · at most every 4 h

This is how the node looks on the board: inputs on the left. As an action it sits at the end of the chain.

Like a courier with a key of its own to the clubhouse: your bot account brings every alert into your Matrix room, whichever server it is on.

Message to a Matrix room. Sends the alert through a bot account of your own to a room on Matrix, for example in Element. Create a second Matrix account for the bot, invite it to the room and enter its access token and the room here; the guide explains how to get the token. Matrix comes with the Community plan. Example: the alert “BTC Dip Buyer: RSI 14: 28.7 · Price: $81,616” appears as a message in the room.

What it looks like

• signal true
• alert goes out
• held back
• cooldown running

The alert comes when the trigger switches from false to true. If it stays true, no second one comes. If it switches again during the cooldown, Bellchain holds the alert back (circle); the replay counts such cases as “held back by the cooldown”.

Settings

The settings appear on the right under “Properties” once you click the node on the board. Below each field you find the same explanation as here.

Homeserver

Default: https://matrix.org · https address, at most 200 characters

The bot account’s server, such as https://matrix.org. It must be reachable from the internet.

Access token

Default: empty · any text, at most 512 characters, must be filled in before activating, empty when you export a chain

The bot account’s access token. Treat it like a password: anyone who knows it can write as the bot. That is why you should use an account just for the bot, never your own. It stays empty when you export the chain.

Room

Default: empty · any text, at most 300 characters, must be filled in before activating

The room as an address such as #alerts:matrix.org or as the ID from Element (room settings, Advanced). Invite the bot account to the room first.

Notify

Default: With sound · under “More”

Whether room members get a sound.

• With sound (default): As a normal message, as set for the room.
• Silent: As a notice (m.notice) that clients show without sound.

At most every … hours

Default: 4 h · from 0 to 168 h

Cooldown: after an alert the action waits at least this long before the next one. 4 hours suit most chains. 0 means an alert every time the condition turns true.

Message

Default: {{chain}}: {{values}} · any text, at most 1,000 characters, multi-line

The alert text. {{chain}} inserts the chain’s name, {{values}} the values of the nodes, {{price}} the price; there are also {{pair}}, {{coin}} and {{time}}. Use **bold**, _italic_ and `code` to highlight text. If a message template is connected to the Message input, its text is used instead.

Example

Sends the message through your bot account to a room on Matrix (Community plan).

How to connect the nodes:

1. Candle (Price) → RSI (Value)
2. RSI (RSI) → Compare (Value)
3. Compare (true/false) → Matrix (Trigger)

On the board it reads: #alarme:matrix.org · at most every 4 h

Chain as JSON

To try it, copy it and paste it in the editor under “Import”. Importing creates a new chain.

matrix.json

{
  "name": "Example: Matrix",
  "version": 1,
  "nodes": [
    { "id": "c1", "type": "core.candle", "position": { "x": 40, "y": 40 }, "settings": { "pair": "BTC/USDT", "timeframe": "1h" } },
    { "id": "r1", "type": "core.rsi", "position": { "x": 260, "y": 40 }, "settings": { "length": 14 } },
    { "id": "k1", "type": "core.compare", "position": { "x": 480, "y": 40 }, "settings": { "operator": "below", "value": 30 } },
    { "id": "x1", "type": "core.matrix", "position": { "x": 700, "y": 40 }, "settings": { "homeserver": "https://matrix.org", "token": "syt_example_bot_token_000000", "room": "#alarme:matrix.org" } }
  ],
  "edges": [
    { "from": "c1.close", "to": "r1.in" },
    { "from": "r1.out", "to": "k1.in" },
    { "from": "k1.out", "to": "x1.in" }
  ]
}

Inputs and outputs

Only matching types connect: number series to number series (round pin), signal to signal (square), message to message (diamond).

Direction	Pin	Type	Note
Input	Trigger	Signal (true/false)	required
Input	Message	Message	optional
Output	–	–	No outputs.

Good to know

• Search also finds it under: notification, message, alert, matrix, element, room, group.

Technical details

Client-server API: PUT …/rooms/{room}/send/m.room.message with text and HTML, without mentions (empty m.mentions). The first time, the bot account joins the room if it is invited. Bellchain finds the homeserver via .well-known. The delivery log keeps only the room.

• Type in the chain: core.matrix · Version 1.0.0 · Category key act
• Settings in the chain: homeserver (Homeserver), token (Access token), room (Room), kind (Notify), cooldown (At most every … hours), message (Message)
• Pins in the chain: Input in, message
• Effect: notifies via Matrix
• How a node is built