n8n-nodes-matrix-persona-bridge

Overview

Integrate the Matrix Persona Webhook Bridge with n8n to automate sending and receiving Matrix chat events as specific personas. Designed for users managing Matrix rooms and messages through automated workflows, this package enables interaction with Matrix rooms via a Persona Bridge webhook for messaging, file sharing, reaction handling, room management, and event triggers.

Nodes & Operations

Matrix Persona Bridge

Enables performing actions as a specific Matrix Persona using the Matrix Persona Bridge webhook API, handling a comprehensive set of messaging, file, reaction, and room management operations.

• Message · Send — Send a text message to a Matrix room through the Persona Bridge webhook. Choose a message type and optionally include HTML, Markdown formatting, a reply event ID, or a thread root event ID.
• Message · Edit — Edits a previously sent Matrix message in the specified room by posting the new text and optional HTML to the configured bridge webhook.
• Message · Redact — Redacts a Matrix event in the specified room by sending a redaction request through the configured Matrix Persona Bridge webhook.
• File · Send — Send a file attachment to a Matrix room through the Persona Bridge webhook. Choose an existing MXC URL or provide base64 file data; the node posts the file details and optional caption and threading metadata for each input item.
• Reaction · Send — Sends an emoji reaction to a Matrix event in the specified room through the Persona Bridge webhook. The node submits the room ID, target event ID, and reaction using the configured bridge credentials.
• Room · Join — Join the specified Matrix room using its unique Room ID to become a participant of that room.
• Room · Leave — Leave a Matrix room by sending a leave-room action through the configured Persona Bridge webhook.
• Room · Set Topic — Set the topic of a specified Matrix room by providing its room ID and the new topic text.
• Room · Set Name — Set the name of a specified Matrix room by providing its room ID and the new desired room name.
• Indicator · Typing — Set a Matrix room’s typing indicator to on or off by posting the selected state and timeout to the Matrix Persona Bridge webhook for each input item.
• Indicator · Read Receipt — Send a Matrix read receipt for an event in a room through the Persona Bridge webhook. The node posts the room ID and event ID with the read_receipt action, then returns the webhook response for each input item.

Matrix Persona: Message Received

Acts as a trigger to start workflows when messages of various types, including text, media, edits, and replies, are received in Matrix rooms where the configured persona is present.

• Default · Default — Trigger workflows when a Matrix room message event occurs where your persona is present, including text, media, edits, replies, and threads.

Matrix Persona: Member Event

Triggers workflows based on membership changes such as joins, leaves, invites, bans, and kicks in rooms where the Matrix persona participates.

• Default · Default — Receives Matrix room membership events through a webhook for rooms where the configured persona is present. It checks the webhook security token and emits matching events as workflow data.

Matrix Persona: Reaction Received

Detects when users react with emojis to messages in Matrix rooms where the persona is active, triggering workflows from these reaction events.

• Default · Default — Receives webhook events when someone reacts with an emoji to a message in a Matrix room where the persona is present. Requires a valid x-webhook-token matching the credential security token; ignores requests that are not m.reaction events.

Matrix Persona: Message Redacted

Triggers workflows when messages are deleted or redacted in Matrix rooms with the persona, passing redaction event details to the workflow.

• Default · Default — Receives Matrix redaction webhook events and emits their details as one workflow item. It checks the configured security token and ignores requests that are not m.room.redaction events.

Matrix Persona: Room Name Changed

Triggers workflows on Matrix room name changes in rooms where the persona is present, providing event details for automation.

• Default · Default — Receives webhook events for Matrix room name changes in rooms where the configured persona is present. It checks the incoming security token and event type, then emits the event details as workflow data.

Matrix Persona: Topic Changed

Detects changes to the topic of Matrix rooms where the persona is active, triggering workflows with information about the topic updates.

• Default · Default — Receives Matrix topic-change webhook events for rooms where the persona is present. It accepts events only when the required security token matches and the event type is m.room.topic.

Matrix Persona: Power Levels Changed

Triggers workflows when room power levels or permissions change in Matrix rooms where the persona is present, enabling permission-related automation.

• Default · Default — Receives Matrix webhook calls for power-level changes in rooms where the persona is present. Checks the x-webhook-token header against the credential’s security token, ignores events of other types, and outputs selected event details.

Installation

Install as an n8n community node: in n8n, open Settings → Community nodes → Install and enter n8n-nodes-matrix-persona-bridge.

Links

• n8n community nodes installation guide