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

Guilhem Saurel 2a3c0e4a4f update docs 6 years ago
Dockerfile bffc7002c1 rename {main -> matrix_webhook}.py 6 years ago
LICENSE 7e6533da5e license details 6 years ago
README.md 2a3c0e4a4f update docs 6 years ago
docker-compose.yml 01a083c693 rename project into Matrix Webhook 6 years ago
matrix_webhook.py bffc7002c1 rename {main -> matrix_webhook}.py 6 years ago

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 (don't forget about CHATONS_DOMAIN, otherwise by default you will stay on localhost)
docker-compose up -d

Test / Usage

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

(or mwh.localhost:4785 without docker)