chat-inc

Bridge services for Chatwoot and Matrix.

Stack

• conduit for the Matrix homeserver
• chatwoot-bot for Matrix <-> Chatwoot mirroring
• postgres for chatwoot-bot
• caddy for Matrix and Chatwoot webhook routing

Quick Start

1. Copy .env.example to .env and fill in the Chatwoot and Matrix values.
2. Run ./deploy.sh.
3. In Chatwoot, add a webhook pointing to https://<MATRIX_DOMAIN>/_chatwoot.
4. Log into a Matrix client against https://<MATRIX_DOMAIN> and watch the bridged room.

Important Files

• deploy.sh
• docker-compose.yml
• chatwoot-bot/config.yaml.template
• conduit/conduit.toml.template
• caddy/Caddyfile.template

Notes

• deploy.sh creates the @chatwoot-bot:<MATRIX_DOMAIN> Matrix user while registration is temporarily enabled.
• After deploy, registration is turned back off automatically.
• The Chatwoot bridge is configured to allow Matrix-initiated chat creation through @chatwoot-bot:<MATRIX_DOMAIN>.