Integrations

Integrations are bots, bridges and widgets that you can add to a room in matrix. They are managed by a separate piece of software, the 'integrations manager'. We use Dimension, an open source implementation.

Configuration

Our integration manager should already be configured
otherwise got to Settings > General > Manage integrations:

• Address: dimension.mbot.ethz.ch

Usage

Add widgets, bridges & bots in the right panel:

The integration manager will open:

Known issues

• Removing bots via the manager does not work, use /kick instead
• Slack bridge provioning is currently not supported, talk to rda in #mbot:phys.ethz.ch

Bots & bridges

See bots & bridges.

Widgets

A widget is an external web application that is embedded into your room as an iframe. Any website could be embedded as a custom widget, although sometimes it is restricted by security settings.

To add a custom widget, click on Custom Widget, add a name and the URL of the page, and add it:

Experimental widgets

Collaborative online whiteboard and notepad:

• Create whitebophir whiteboard (simple, server-side storage)
• Create excalidraw whiteboard (advanced, end-to-end encrypted)
• Create etherpad notepad
• Copy the URL from your browsers address bar
• Select the room where you would like to add the whiteboard
• Open the integration manager and add a custom widget
• Paste the URL into the Widget URL field
• Set a widget name and click add