It is possible to publish events to a Telegram channel during Live capture or Replay tagging using the automation rules for events


Table of content

Requirements

Set up Telegram

Set up Dartfish software

Retrieve the Chat ID of a private channel

Requirements

  • myDartfish Pro S software
  • Admin rights on a Telegram Channel
  • A Telgram bot


Set up Telegram

  • Download the desktop version of Telegram on the same PC that is running Dartfish https://desktop.telegram.org/
  • Create your own Telegram bot using BotFather. To do so, open the link https://botostore.com/c/botfather/ and click on Open in Telegram. This will open the BotFather channel in the Telegram desktop app
  • Type /newbot in this channel to create a new bot. BotFather will ask you to choose a name and a username for this bot
  • Write down the Bot API key (highlighted in red here above). You will need it in Dartfish software. Keep it secure as it can be used by anyone to control the bot.
  • Add your bot to your Telegram channel and grant him admin rights


Set up Dartfish software

  • Launch Dartfish Pro S software and go to Replay or Live
  • In the event pane, open the Automation Rule Manager
  • Set the conditions of the rule and under "Perform the following actions" select "Publish events to Telegram"


  • Enter the Bot API Key and the Chat ID

  • Bot API Key: paste here the token given by BotFather
  • Chat ID: paste the channel name in the Telegram invitation link, starting with "@" for public channels


If the channel is private, additional steps are required in order to find the Chat ID. See at the end of this article how to proceed in that case


MacroResulting text
$(Title)Name of the event
$(Description)Description of the event
$(Keywords)All the keywords of the event
$(Keywords:Category)All the keywords of the specified category of the event
$(Keyword1:Category)The first keyword of the specified category (same logic for the 2nd, 3rd, etc.. keyword)
$(PublishDate)Current date
Example: 
  • Caption: $(PublishDate) - Point won by $(Keyword:Point Winner)
  • Title on Telegram: 01.05.2022 - Point won by Roger Federer


Retrieve the Chat ID of a private channel

Private channels are handled a bit differently by Telegram. Simply copying the characters in the invite link doesn't work. We need to know the exact Chat ID that consists in a serie of digits following a minus sign (e.g. -153624574). To find this ID, we will need to briefly switch the channel to public before setting it back to private. We will also need to use the bot 

@username_to_id that will find the Chat ID of our channel

  • Set your channel to public
  • Copy the public invite link
  • Open in Telegram desktop the bot https://t.me/username_to_id_bot
  • Send the public invite link of your channel to this bot
  • The bot will answer the ID of the channel. Copy it and make sure to include the "-"


  • Set your channel back to private