matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-mautrix-telegram.md

22 lines
1020 B
Markdown
Raw Normal View History

# Setting up Mautrix Telegram (optional)
2018-09-02 14:14:14 +00:00
The playbook can install and configure [mautrix-telegram](https://github.com/tulir/mautrix-telegram) for you.
2018-10-24 16:12:24 +00:00
See the project's [documentation](https://github.com/tulir/mautrix-telegram/wiki#usage) to learn what it does and why it might be useful to you.
You'll need to obtain API keys from `https://my.telegram.org/apps` and then use the following playbook configuration:
```yaml
matrix_mautrix_telegram_enabled: true
matrix_mautrix_telegram_api_id: YOUR_TELEGRAM_APP_ID
matrix_mautrix_telegram_api_hash: YOUR_TELEGRAM_API_HASH
```
2018-10-24 16:12:24 +00:00
2019-02-28 09:51:09 +00:00
You then need to start a chat with `@telegrambot:YOUR_DOMAIN` (where `YOUR_DOMAIN` is your base domain, not the `matrix.` domain).
If you want to use the relay-bot feature ([relay bot documentation](https://github.com/tulir/mautrix-telegram/wiki/Relay-bot)), which allows anonymous user to chat with telegram users, use the following addtional playbook configuration:
```yaml
matrix_mautrix_telegram_bot_token: YOUT_TELEGRAM_BOT_TOKEN
```