Telegram integration

What is Telegram?

Telegram is a cloud-based messaging app that allows users to send text and media messages to individuals and groups.

Telegram users especially appreciate its speed and strong emphasis on security and privacy, with fully encrypted chats and the ability to share a document or audio file for a limited period of time.

The service can be combined with Buddy to send automatic notifications and alerts to individual users, announcement channels, and group chats, keeping every chat member informed about the status of builds and deployments. For that, we use a special bot which publishes messages on your behalf.

Image loading...Example deployment pipeline with Telegram notification

Setting up Telegram integration

  1. Open the Integrations tab and click New integration.
  2. Look up and select Telegram:

Image loading...Telegram on the integrations list

  1. The configuration is super-fast and only involves inviting the Buddy Bot to the selected channel:

Image loading...Endpoint configuration

Public channels and groups

  • If you want the bot to send messages to a channel or a group, you first need to invite @BuddyTelegramBot to your channel/group
  • Next, paste the provided string in the conversation window:

Image loading...Adding bot to a public channel

Private channels

  • If you want the bot to send messages to your private channel, select User in the Telegram endpoint field.
  • Next, copy the text and click on the link in point 2. It will automatically add buddybot to your contacts.
  • Finally, paste the copied text in the conversation window to finish the configuration.

Image loading...Inviting bot to private channel

  1. Once the Telegram bot is added, go to your pipeline in Buddy and select Telegram from the actions list. The default text message contains the ID of the execution, pipeline name, and invoker details. You can choose between Markdown and HTML formatting:

Image loading...Telegram action configuration

Hint
You can define multiple Telegram integrations to be able to add more channels. You can do it in the chat selection box in the Telegram action or in the Integrations tab. Image loading...Adding more Telegram integrations
Hint

📚 Learn more about Telegram action features, integrations and alternatives.

Last modified on Sep 23, 2024