kellya/matrix-webhook
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Post a message to a matrix room with a simple HTTP POST
36 commits 1 branch 7 tags 452 KiB
Python 96%
Dockerfile 4%
Find a file
Guilhem Saurel 4b1acd874a markdown 
ref https://matrix.org/docs/spec/client_server/r0.6.0#m-room-message-msgtypes
2020-03-14 17:26:57 +01:00
.pre-commit-config.yaml pre-commit 2020-03-08 22:15:48 +01:00
docker-compose.yml update DNS 2019-02-17 12:44:00 +01:00
Dockerfile markdown 2020-03-14 17:26:57 +01:00
LICENSE license details 2019-02-10 22:04:46 +01:00
matrix_webhook.py markdown 2020-03-14 17:26:57 +01:00
README.md markdown 2020-03-14 17:26:57 +01:00

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
  • API_KEY: a secret to share with the users of the service

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: [44](http://radio.localhost/map/#44)", "key": "secret"}' 'matrixwebhook.localhost/!FwpsPdeIYWcXDVpRmO:matrix.org'

(or localhost:4785 without docker)