How to set up a Telegram-Mattermost link

We have a Matterbridge service, which enables you to link a Telegram channel or group to a Mattermost channel.

The purpose of this service is to reduce the number of communication tools you have to use.

Rebels who are comfortable with Mattermost can keep in touch with Telegram channels, without having to join the Telegram channel.

Likewise, rebels who do not want to use Mattermost, but want to stick with Telegram can do so, without being in a Telegram only silo.

A group that has a thriving Telegram channel, with some people who do not want to use Mattermost, could set up a two-way Matterbridge link. This enables posts to be made and shared from either platform. Subsequently, members who do use Mattermost can leave the Telegram channel, whilst remaining in the overall conversation.

Prerequisites

It is very important that people in the existing channel or group know beforehand if you intend to set up a link to or from Mattermost. You should discuss:

  • whether it is one-way or two-way
  • why you are doing it, and
  • who will get access.

This prior consultation and agreement on how the Matterbridge link will improve communications within the group, will lead to a smoother introduction of the link.

Contact DDAT Team on Mattermost, and ask the admins to set up your bridge. They will need the information detailed below, but they can help you with getting your end set up, if you find the following instructions difficult.

What you need to do first

  1. Get the Telegram channel or group administrator to join user "XRUKMatterbridge_bot" (our bot) to the Telegram channel or group.

    If it's a channel rather than a group, set the bot as Administrator - most of the admin permissions can be turned off - a Telegram->Mattermost link only needs to be able to read messages; a two-way link also needs to post messages. (NOTE: see section below for more detail).
  2. Next find the channel ID, as we need it to set up the link.
    1. Go to the channel or group on Telegram
    2. Forward a message to getidsbot (on the desktop, that's right click, Forward Message, then send it)
    3. The bot will reply with a message that looks like this:

      We just need the channel id from "Origin chat", but you can copy the whole message if it's easier.
  3. Decide what channel the data is going to on Mattermost. Visit it with a browser, and note down the team name and channel name from the browser address bar (URL). Or just copy the whole URL.
  4. Join the username @matterbridge to the destination Team (if not already in it) and channel on Mattermost.
  5. Notify the DDAT Team that you have made the changes to both your Telegram channel and the associated Mattermost channel, and request them to set up the Matterbridge link.

How to add a bot to a channel on Telegram:

Desktop:

  1. Open the desktop app
  2. Go into the channel
  3. ... menu, Manage Channel
  4. Click Administrators
  5. Click Add Administrator
  6. Type the name of the bot ("XRUKMatterbridge_bot")
  7. Click on it to add
  8. Click OK to add it
  9. Turn off all the permissions
  10. Click Save

It works the same on a phone:

  1. Open the app
  2. Go into the channel
  3. Tap on the title bar
  4. Tap administrators
  5. Tap Add Admin
  6. Tap the search icon
  7. Type the bot name ("XRUKMatterbridge_bot")
  8. Pick it from the list
  9. Turn off all the rights
  10. Tap the tick at the top

How to forward a message from a channel or group

  1. Find a (non-confidential) message
  2. Right click on it
  3. Choose Forward Message
  4. Type the name of the bot getidsbot in the search bar
  5. Click on it GetIDsBot
  6. Click on the icon to send it.
  7. Telegram will take you to the bot channel, and you should see the reply. (You may have to click on a Start button first.)

It works the same on a phone:

  1. Find a (non-confidential) message
  2. Tap on it
  3. Choose Forward
  4. Tap the search icon
  5. Type the name of the bot getidsbot in the search bar
  6. Click on it GetIDsBot
  7. Click on the icon to send it.
  8. Telegram will take you to the bot channel, and you should see the reply. (You may have to click on a Start button first.)