Matrix Persona Bridge icon

Matrix Persona Bridge

Perform actions as a Matrix Persona via the bridge webhook API. Send messages, files, reactions, manage rooms, and more.

Actions11

File → Send

AI-generated

Summary

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.

Inputs

  • Room ID (required) — Matrix room ID to send the attachment to.
  • Source — Choose MXC URL (the default) or Base64 Data. The selected source determines which file input is used.
  • File URL (required) — MXC URL of an already-uploaded file; used when Source is MXC URL.
  • File Data (Base64) (required) — Base64-encoded file data; used when Source is Base64 Data.
  • Text (Caption) — Optional caption included with the attachment.
  • File Name — Optional attachment filename.
  • MIME Type — Optional MIME type, such as image/png. The field description says this is used to detect the message type.
  • Additional Fields — File Size (optional, in bytes), Reply To Event ID, and Thread Root Event ID.

Output shape

One output item per input item, containing the webhook response in its json field.

The node sends a POST request to the configured inbound URL with the webhook token. It sends either the MXC URL or base64 data, along with any supplied caption, filename, MIME type, nonzero file size, reply event ID, or thread root event ID. On failure it throws an item-indexed error unless Continue On Fail is enabled, in which case that item's output contains an error field.

Links

Discussion