Skip to content

Management commands

Tulir Asokan edited this page Mar 22, 2019 · 20 revisions

These commands can be used to interact with the bridge and Telegram in ways not supported by native Matrix actions.

Management commands only work if the bridge bot is in the room. This means that private chat portals do not currently support management commands.

If the room you send the command to does not have users other than you and the bridge bot, you do not have to prefix commands, i.e. you can literally write help to get the help message. If the room has more users, you must use the command prefix (!tg by default). For example: !tg help. The command prefix is always allowed even if it's not required.

Generic bridge commands

Command Usage
help Show this help message.
cancel Cancel an ongoing action (such as login).


Commands to authenticate with Telegram.

Command Usage
login [mxid] Get instructions on how to log in. Admins can use the mxid parameter to log in as another user.
register <phone> <full name> Register to Telegram.
logout Log out from Telegram.
login-matrix Replace your Telegram account's Matrix puppet with your own Matrix account.
ping-matrix Pings the server with the stored matrix authentication.
ping Check if you're logged into Telegram.
ping-bot Get info of the message relay Telegram bot.
username <new username> Change your Telegram username.
session <list|terminate> [hash] View or delete other Telegram sessions.

Creating portals

Commands to make connections to Telegram chats.

Command Usage
bridge [id] Bridge the current Matrix room to the Telegram chat with the given ID. The ID must be the prefixed version that you get with the /id command of the Telegram-side bot.
create [type] Create a Telegram chat of the given type for the current Matrix. type is either group, supergroup or channel. Defaults to group
pm <identifier> Open a private chat with the given Telegram user. identifier is either the internal ID, the username or the phone number of the Telegram user. N.B. The phone numbers you start chats with must already be in your contacts.
join <link> Join a chat with an invite link. link is a complete invite link, e.g.

Portal management

Commands to manage the Telegram chats linked to portals. These can only be used in portal rooms and will directly affect the Telegram chat linked to the portal.

Most of these commands require some admin privileges in the Telegram chat: The bot will inform you if you do not have sufficient permissions.

Command Usage
invite-link Get a Telegram invite link to the current chat.
upgrade Upgrade a normal Telegram group to a supergroup.
group-name <name|-> Change the username of a supergroup/channel. To disable, use a dash (-) as the name.
delete-portal Remove all users from the current portal room and forget the portal. Only works for group chats; to delete a private chat portal, simply leave the room.
unbridge Remove puppets from the current portal room and forget the portal.

Portal configuration

Some bridge settings can be set on a per-portal basis. The !tg config command is used for that.

Command Usage
help View this help text.
view View the current config data.
defaults View the default config values.
set <key> <value> Set a config value.
unset <key> Remove a config value.
add <key> <value> Add a value to an array.
del <key> <value> Remove a value from an array.

Miscellaneous things

Command Usage
search [-r|--remote] <query> Search your contacts or the Telegram servers for users.
sync [chats|contacts|me] Synchronize your chat portals, contacts and/or own info.
sync-state Fetch Matrix room state to ensure the bridge has up-to-date info.
id Get the ID of the Telegram chat where this room is bridged.
play <play ID> Play a Telegram game.


Bridge admin commands that do advanced things.

Command Usage
filter-mode <whitelist|blacklist> Change whether the bridge will allow or disallow bridging rooms by default.
filter <whitelist|blacklist> <chat ID> Allow or disallow bridging a specific chat.
clean-rooms Clean up unused portal/management rooms.
set-pl <level> [mxid] Set a temporary power level without affecting Telegram.
clear-db-cache <portal|puppet|user> Clear internal database caches
reload-user [mxid] Reload and reconnect a user
You can’t perform that action at this time.