Chatwoot <-> Matrix Help Bot Integration

A bot which logs in as a help user in Matrix and mirrors all messages sent to it from Matrix into Chatwoot and allows Chatwoot agents to respond.

Matrix chat: #chatwoot-matrix:nevarro.space

Supported features

• Chatwoot -> Matrix

  • Plain text
  • Message formatting
  • Attachments
    • Images
    • Files
  • Private messages are ignored
  • Redactions
  • Append message sender to message that gets mirrored into Matrix

• Matrix -> Chatwoot

  • Text
  • Message formatting
  • Attachments
    • Images/GIFs
    • Files
  • Edits *
  • Reactions *
  • Redactions
  • Mark the canonical DM with a label

• Multiple chats with help bot supported

• Error notifications as private messages when bridging fails in either direction

* indicates that a textual representation is used because Chatwoot does not support the feature

Configuration

See example-config.yaml for details about each config option.