matrix-webhook/README.md

Matrix Webhook

Post a message to a matrix room with a simple HTTP POST

Configuration

Create a matrix user for the bot, make it join the rooms you want it to talk into, and then set the following environment variables:

• MATRIX_URL: the url of the matrix homeserver
• MATRIX_ID: the user id of the bot on this server
• MATRIX_PW: the password for this user

Dev

pip3 install --user matrix-client
./matrix_webhook.py

Prod

• Use Traefik on the web docker network, eg. with proxyta.net
• Put the configuration into a .env file
• Configure your DNS for ${CHATONS_SERVICE:-matrixwebhook}.${CHATONS_DOMAIN:-localhost} and www.${CHATONS_SERVICE:-matrixwebhook}.${CHATONS_DOMAIN:-localhost}

docker-compose up -d

Test / Usage

curl -d '{"text":"new contrib from toto: http://radio.localhost/map/#44", "key": "secret"}' matrixwebhook.localhost

(or matrixwebhook.localhost:4785 without docker)