39 lines
1.1 KiB
Markdown
39 lines
1.1 KiB
Markdown
# 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](https://traefik.io/) on the `web` docker network, eg. with
|
|
[proxyta.net](https://framagit.org/oxyta.net/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/!FwpsPdeIYWcXDVpRmO:matrix.org'
|
|
```
|
|
(or localhost:4785 without docker)
|