mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-22 12:35:51 +00:00
Fix some minor Markdown rendering issues
This commit is contained in:
parent
219663f02e
commit
0ffe821cfb
@ -7,52 +7,53 @@ Setup Instructions:
|
|||||||
loosely based on [this](https://github.com/turt2live/matrix-appservice-webhooks/blob/master/README.md)
|
loosely based on [this](https://github.com/turt2live/matrix-appservice-webhooks/blob/master/README.md)
|
||||||
|
|
||||||
1. All you basically need is to adjust your `inventory/host_vars/matrix.<domain-name>/vars.yml`:
|
1. All you basically need is to adjust your `inventory/host_vars/matrix.<domain-name>/vars.yml`:
|
||||||
```yaml
|
|
||||||
matrix_appservice_webhooks_enabled: true
|
```yaml
|
||||||
matrix_appservice_webhooks_api_secret: '<your_secret>'
|
matrix_appservice_webhooks_enabled: true
|
||||||
```
|
matrix_appservice_webhooks_api_secret: '<your_secret>'
|
||||||
|
```
|
||||||
|
|
||||||
2. In case you want to change the verbosity of logging via `journalctl -fu matrix-appservice-webhooks.service`
|
2. In case you want to change the verbosity of logging via `journalctl -fu matrix-appservice-webhooks.service`
|
||||||
you can adjust this in `inventory/host_vars/matrix.<domain-name>/vars.yml` as well.
|
you can adjust this in `inventory/host_vars/matrix.<domain-name>/vars.yml` as well.
|
||||||
<br>
|
|
||||||
*Note*: default value is: `info` and availabe log levels are : `info, verbose`
|
|
||||||
|
|
||||||
```yaml
|
*Note*: default value is: `info` and availabe log levels are : `info`, `verbose`
|
||||||
matrix_appservice_webhooks_log_level: '<log_level>'
|
|
||||||
```
|
```yaml
|
||||||
|
matrix_appservice_webhooks_log_level: '<log_level>'
|
||||||
|
```
|
||||||
|
|
||||||
3. If you've already installed Matrix services using the playbook before, you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with [configuring other playbook services](configuring-playbook.md) and then with [Installing](installing.md). Get back to this guide once ready.
|
3. If you've already installed Matrix services using the playbook before, you'll need to re-run it (`--tags=setup-all,start`). If not, proceed with [configuring other playbook services](configuring-playbook.md) and then with [Installing](installing.md). Get back to this guide once ready.
|
||||||
|
|
||||||
4. Invite the bridge bot user to your room:
|
4. Invite the bridge bot user to your room:
|
||||||
- either with:
|
|
||||||
```
|
- either with `/invite @_webhook:<domain.name>` (*Note*: Make sure you have administration permissions in your room)
|
||||||
/invite @_webhook:<domain.name>
|
|
||||||
```
|
|
||||||
*Note*: Make sure you have administration permissions in your room
|
|
||||||
- or simply add the bridge bot to a private channel (personal channels imply you being an administrator)
|
- or simply add the bridge bot to a private channel (personal channels imply you being an administrator)
|
||||||
|
|
||||||
5. Send a message to the bridge bot in order to receive a private message including the webhook link.
|
5. Send a message to the bridge bot in order to receive a private message including the webhook link.
|
||||||
```
|
```
|
||||||
!webhook
|
!webhook
|
||||||
```
|
```
|
||||||
|
|
||||||
6. The JSON body for posting messages will have to look like this:
|
6. The JSON body for posting messages will have to look like this:
|
||||||
```
|
```json
|
||||||
{
|
{
|
||||||
"text": "Hello world!",
|
"text": "Hello world!",
|
||||||
"format": "plain",
|
"format": "plain",
|
||||||
"displayName": "My Cool Webhook",
|
"displayName": "My Cool Webhook",
|
||||||
"avatarUrl": "http://i.imgur.com/IDOBtEJ.png"
|
"avatarUrl": "http://i.imgur.com/IDOBtEJ.png"
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
- You can test this via curl like so:
|
|
||||||
```
|
You can test this via curl like so:
|
||||||
curl --header "Content-Type: application/json" \
|
|
||||||
--data '{
|
```
|
||||||
"text": "Hello world!",
|
curl --header "Content-Type: application/json" \
|
||||||
"format": "plain",
|
--data '{
|
||||||
"displayName": "My Cool Webhook",
|
"text": "Hello world!",
|
||||||
"avatarUrl": "http://i.imgur.com/IDOBtEJ.png"
|
"format": "plain",
|
||||||
}' \
|
"displayName": "My Cool Webhook",
|
||||||
<the link you've gotten in 5.>
|
"avatarUrl": "http://i.imgur.com/IDOBtEJ.png"
|
||||||
```
|
}' \
|
||||||
|
<the link you've gotten in 5.>
|
||||||
|
```
|
||||||
|
Loading…
Reference in New Issue
Block a user