mirror of
				https://github.com/spantaleev/matrix-docker-ansible-deploy.git
				synced 2025-10-31 07:17:57 +01:00 
			
		
		
		
	Use common expressions for using a bridge
"To use the bridge, you need to start a chat with …" is well used among the documentation. Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
This commit is contained in:
		| @@ -79,4 +79,4 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@irc_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@irc_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|   | ||||
| @@ -50,7 +50,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Start a chat with `@kakaotalkbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@kakaotalkbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login --save EMAIL_OR_PHONE_NUMBER` to the bridge bot to enable bridging for your Kakaotalk account. The `--save` flag may be omitted, if you'd rather not save your password. | ||||
|  | ||||
|   | ||||
| @@ -82,7 +82,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Send `/invite @slackbot:example.com` to invite the bridge bot user into the admin room. | ||||
| To use the bridge, you need to send `/invite @slackbot:example.com` to invite the bridge bot user into the admin room. | ||||
|  | ||||
| If Team Sync is not enabled, for each channel you would like to bridge, perform the following steps: | ||||
|  | ||||
|   | ||||
| @@ -43,7 +43,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Invite the bridge bot user to your room in either way. | ||||
| To use the bridge, you need to invite the bridge bot user to your room in either way. | ||||
|  | ||||
| - Send `/invite @_webhook:example.com` (**Note**: Make sure you have administration permissions in your room) | ||||
| - Add the bridge bot to a private channel (personal channels imply you being an administrator) | ||||
|   | ||||
| @@ -59,7 +59,7 @@ Enabling double puppeting by enabling the [Shared Secret Auth](configuring-playb | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@linkedinbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@linkedinbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login YOUR_LINKEDIN_EMAIL_ADDRESS` to the bridge bot to enable bridging for your LinkedIn account. | ||||
|  | ||||
|   | ||||
| @@ -31,6 +31,6 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled, you need to start a chat with `Skype bridge bot` with the handle `@skypebridgebot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Skype bridge bot` with the handle `@skypebridgebot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `help` to the bot to see the commands available. | ||||
|   | ||||
| @@ -66,7 +66,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| After the bridge is successfully running just DM `@heisenbridge:example.com` to start setting it up. If the bridge ignores you and a DM is not accepted then the owner setting may be wrong. | ||||
| To use the bridge, you need to start a chat with `@heisenbridge:example.com` (where `example.com` is your base domain, not the `matrix.` domain). If the bridge ignores you and a DM is not accepted then the owner setting may be wrong. | ||||
|  | ||||
| Help is available for all commands with the `-h` switch. | ||||
|  | ||||
|   | ||||
| @@ -30,7 +30,7 @@ Should the crypto store be corrupted, you can reset it by executing this Ansible | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Create a room and invite the Hookshot bot (`@hookshot:example.com`) to it. | ||||
| To use the bridge, you need to create a room and invite the Hookshot bot (`@hookshot:example.com`) to it. | ||||
|  | ||||
| Make sure the bot is able to send state events (usually the Moderator power level in clients). | ||||
|  | ||||
|   | ||||
| @@ -74,7 +74,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@facebookbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@facebookbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login YOUR_FACEBOOK_EMAIL_ADDRESS` to the bridge bot to enable bridging for your Facebook Messenger account. You can learn more here about authentication from the bridge's [official documentation on Authentication](https://docs.mau.fi/bridges/python/facebook/authentication.html). | ||||
|  | ||||
|   | ||||
| @@ -37,7 +37,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@gmessagesbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@gmessagesbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| ### 💡 Set up Double Puppeting | ||||
|  | ||||
|   | ||||
| @@ -37,7 +37,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `googlechat bridge bot` with handle `@googlechatbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `googlechat bridge bot` with handle `@googlechatbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login` to the bridge bot to receive a link to the portal from which you can enable the bridging. Open the link sent by the bot and follow the instructions. | ||||
|  | ||||
|   | ||||
| @@ -39,7 +39,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `Hangouts bridge bot` with handle `@hangoutsbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Hangouts bridge bot` with handle `@hangoutsbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login` to the bridge bot to receive a link to the portal from which you can enable the bridging. Open the link sent by the bot and follow the instructions. | ||||
|  | ||||
|   | ||||
| @@ -61,7 +61,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login YOUR_INSTAGRAM_EMAIL_ADDRESS YOUR_INSTAGRAM_PASSWORD` to the bridge bot to enable bridging for your instagram/Messenger account. | ||||
|  | ||||
|   | ||||
| @@ -86,7 +86,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@instagrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| ### 💡 Set up Double Puppeting | ||||
|  | ||||
|   | ||||
| @@ -99,7 +99,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@messengerbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). Note that the user ID of the bridge's bot is not `@facebookbot:example.com`. | ||||
| To use the bridge, you need to start a chat with `@messengerbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). Note that the user ID of the bridge's bot is not `@facebookbot:example.com`. | ||||
|  | ||||
| You then need to send a `login` command and follow the bridge bot's instructions. | ||||
|  | ||||
|   | ||||
| @@ -88,7 +88,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@signalbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@signalbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| ### 💡 Set up Double Puppeting | ||||
|  | ||||
|   | ||||
| @@ -39,7 +39,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@telegrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@telegrambot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| If you want to use the relay-bot feature ([relay bot documentation](https://docs.mau.fi/bridges/python/telegram/relay-bot.html)), which allows anonymous user to chat with telegram users, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file: | ||||
|  | ||||
|   | ||||
| @@ -53,7 +53,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@whatsappbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@whatsappbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| ### 💡 Set up Double Puppeting | ||||
|  | ||||
|   | ||||
| @@ -35,7 +35,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `Discord Puppet Bridge` with the handle `@_discordpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Discord Puppet Bridge` with the handle `@_discordpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-discord [documentation](https://gitlab.com/mx-puppet/discord/mx-puppet-discord) for more information about how to configure the bridge. | ||||
|  | ||||
|   | ||||
| @@ -31,7 +31,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `GroupMe Puppet Bridge` with the handle `@_groupmepuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `GroupMe Puppet Bridge` with the handle `@_groupmepuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| One authentication method is available. | ||||
|  | ||||
|   | ||||
| @@ -31,7 +31,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled, you need to start a chat with `Instagram Puppet Bridge` with the handle `@_instagrampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Instagram Puppet Bridge` with the handle `@_instagrampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `link <username> <password>` to the bridge bot to link your instagram account. | ||||
|  | ||||
|   | ||||
| @@ -40,7 +40,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `Slack Puppet Bridge` with the handle `@_slackpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Slack Puppet Bridge` with the handle `@_slackpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-slack [documentation](https://gitlab.com/mx-puppet/slack/mx-puppet-slack) for more information about how to configure the bridge. | ||||
|  | ||||
|   | ||||
| @@ -31,7 +31,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `Steam Puppet Bridge` with the handle `@_steampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Steam Puppet Bridge` with the handle `@_steampuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Three authentication methods are available, Legacy Token, OAuth and xoxc token. See mx-puppet-steam [documentation](https://github.com/icewind1991/mx-puppet-steam) for more information about how to configure the bridge. | ||||
|  | ||||
|   | ||||
| @@ -42,7 +42,7 @@ ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-use | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| Once the bot is enabled you need to start a chat with `Twitter Puppet Bridge` with the handle `@_twitterpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `Twitter Puppet Bridge` with the handle `@_twitterpuppet_bot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| To log in, use `link` and click the link. | ||||
|  | ||||
|   | ||||
| @@ -132,7 +132,7 @@ If you have issues with a service, and are requesting support, the higher levels | ||||
|  | ||||
| ## Usage | ||||
|  | ||||
| You then need to start a chat with `@SERVICENAMEbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
| To use the bridge, you need to start a chat with `@SERVICENAMEbot:example.com` (where `example.com` is your base domain, not the `matrix.` domain). | ||||
|  | ||||
| Send `login` to the bridge bot to get started. You can learn more here about authentication from the bridge's official documentation on Authentication: https://docs.mau.fi/bridges/python/SERVICENAME/authentication.html | ||||
|  | ||||
|   | ||||
		Reference in New Issue
	
	Block a user