Skip to content

beeper/chatwoot

Repository files navigation

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.