stage	Manage
group	Import and Integrate
info	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments

Telegram (FREE ALL)

Introduced in GitLab 16.1.

You can configure GitLab to send notifications to a Telegram chat or channel. To set up the Telegram integration, you must:

Create a Telegram bot

To create a bot in Telegram:

When you create a bot, BotFather provides you with an API token. Keep this token secure as you need it to authenticate the bot in Telegram.

To configure the bot in Telegram:

Add the bot as an administrator to a new or existing channel.
Assign the bot Post Messages rights to receive events.
Create an identifier for the channel.
- For public channels, enter a public link and copy the channel identifier (for example, https:/t.me/MY_IDENTIFIER).
- For private channels, use the getUpdates method with your API token and copy the channel identifier.

After you invite the bot to a Telegram channel, you can configure GitLab to send notifications:

To enable the integration:
- For your group or project:
  1. On the left sidebar, select Search or go to and find your project or group.
  2. Select Settings > Integrations.
- For your instance:
  1. On the left sidebar, select Search or go to.
  2. Select Admin Area.
  3. Select Settings > Integrations.
Select Telegram.
Under Enable integration, select the Active checkbox.
In New token, paste the token value from the Telegram bot.
In the Trigger section, select the checkboxes for the GitLab events you want to receive in Telegram.
In Channel identifier, paste the Telegram channel identifier.
Optional. Select Test settings.
Select Save changes.

The Telegram channel can now receive all selected GitLab events.