# Working with Issues and Articles in Telegram The YouTrack bot for Telegram lets you interact with issues and articles directly from the Telegram messaging app. When this feature is active in your YouTrack installation, the following features are available: Link Previews : The YouTrack bot shows previews when a user posts a link a public issue or article. This lets other users view content directly in Telegram and determine whether they get all the information they need from the preview or need to click the link. Notifications : Get notified whenever someone creates, updates, or adds a comment to an issue based on the subscription settings stored in your YouTrack profile. Never miss another update! Slash Commands : Update issues without leaving the channel where you receive notifications by giving commands to the YouTrack bot. Add a comment to the issue and apply other updates with YouTrack commands. Discussion Mode : Need to work through an issue with your colleagues on the go? Convert a Telegram channel into a dedicated forum for discussing a specific issue. When discussion mode is active, messages sent to the Telegram channel are posted to the issue as new comments. Drafts : Whenever you have an idea for a new issue or article, create a draft without leaving the Telegram app. Open the draft in YouTrack to finish where you left off. To learn how to activate this feature in YouTrack, see [YouTrack Bot for Telegram](telegram-integration.html). ## Authorize the YouTrack Bot in Telegram Before you can work with YouTrack issues and articles in Telegram, you need to authorize the bot by logging in with your YouTrack account. Procedure: To authorize the YouTrack bot: 1. In YouTrack, click your avatar in the main navigation menu, then select Profile. 2. Switch to the Notifications tab. 3. Next to the option that lets you Send notifications to the YouTrack bot for Telegram, click the Connect my account link. ![Profile Notifications tab with YouTrack bot for Telegram and Connect my account highlighted.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/authorize-youtrack-bot-telegram.png) * A page opens in a new browser tab that prompts you to send a message to the Telegram app. Your browser should prompt you to open the authorization link in the Telegram Desktop. Select the Open Telegram Desktop option to continue. ![Telegram bot authorization page with SEND MESSAGE available.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/prompt-to-send-message-to-telegram.png) If you haven't already installed the Telegram Desktop application on the workstation you use to authorize the bot, you will need to download the desktop app and try again. 4. Open the message from the YouTrack bot in Telegram and click the START button at the bottom of the screen. ![Telegram YouTrack bot welcome message with the START action.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/youtrack-bot-telegram-message.png) * The YouTrack is authorized for use with your Telegram account. ## Draft an Issue The YouTrack bot supports a slash command that lets you create an issue draft in YouTrack. The message is copied to the summary, so all you need to do in YouTrack is pick a project, add an optional description, set the values for fields, and report the issue. Procedure: To create an issue draft in Telegram: 1. Open the menu for the YouTrack bot and select the `/issue` slash command. 2. Enter the text that you want to use as the issue summary. 3. Send your message to the channel. You can also enter the slash command and the issue summary in a single message. For example: ``` /issue Update pricing for premium features in the FAQ ``` Once the draft has been created, you can open it directly in YouTrack and finish reporting the issue. To learn more about issue drafts in YouTrack, see [Load Issue Drafts](issue-drafts.html). The issue is automatically assigned to the project where you most recently reported an issue in YouTrack. If you've never reported an issue before, YouTrack chooses the first project it finds where you have been granted the Create Issue permission. ## Draft an Article The YouTrack bot also supports a slash command that lets you create a draft for an article in the YouTrack knowledge base. The selected message is used as the title for the new article. To get the draft ready for publication, just add whatever content you want to share and choose the project where you want to publish it. Procedure: To create an article draft in Telegram: 1. Open the menu for the YouTrack bot and select the `/article` slash command. 2. Enter the text that you want to use as the title for the article. 3. Send your message to the channel. You can also enter the slash command and the article title in a single message as shown below. ![Telegram YouTrack bot confirming an article draft was created from a slash command.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/telegram-article.png) Once the draft has been created, you can open it directly in YouTrack and publish it. To learn how to work with article drafts in YouTrack, see [Update an Article Draft](edit-article-content.html#update-article-draft). ## Add Comments to Issues and Articles The YouTrack bot lets you interact with issues and articles by adding your comments with the `/comment` command. Procedure: To add a comment to an issue in Telegram: 1. Open the menu for the YouTrack bot and select the `/comment` slash command. 2. Type the ID of the issue or article where you want to add a comment followed by your comment text. 3. Send your message to the channel. ![Telegram YouTrack bot confirming a comment was added to issue WEB-23.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/telegram-comment.png) You can also enter the slash command, the issue ID, and your comment in a single message. For example: ``` /comment WEB-23 It should be available in the staging environment. Please have a look. ``` ## Update Issues with Commands You can update an issue directly from Telegram using the `/update` command. Procedure: To update an issue in Telegram: 1. Open the menu for the YouTrack bot and select the `/update` slash command. 2. Type the ID of the issue you want to update followed by the command that you want to apply to the issue. You can also enter the slash command, the ID of the issue you want to update, and the YouTrack command in a single message as shown below. ![Telegram YouTrack bot confirming a command updated issue WEB-23.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/telegram-update.png) For example, if you get a notification that a new issue was created and you want to assign it to yourself, apply the command: ``` /update ID-22 for me ``` If someone adds a comment to an issue asking that it gets resolved as soon as possible, raise its priority with the following command: ``` /update ID-22 priority critical ``` ## Discuss an Issue in a Group Chat Groups are a very popular tool for interacting with customers and building communities in the Telegram platform. With the YouTrack bot, you can turn any group chat into a dedicated form for discussing an issue with the `/discuss` command. > **Note: Prerequisites** > Before you start a discussion for a YouTrack issue, perform these actions: > > > > * Add the YouTrack bot to the group chat. > > * Open the group info for the channel and add the bot to the list of administrators. > > * Use the `/authorize` command to activate the YouTrack bot in the channel. Procedure: To discuss a YouTrack issue in a Telegram group chat: 1. Enter the slash command `/discuss` in a Telegram group channel. 2. Type the ID of the issue you want to discuss. 3. Send your message to the channel. This command activates discussion mode for the specified issue. As long as discussion mode is active, messages that are posted to the group chat are added as comments to the issue. ![Telegram group discussion with the YouTrack bot applying a command to issue WEB-23.](https://resources.jetbrains.com.cn/help/img/youtrack/2026.2/telegram-discuss.png) Comments are only posted on behalf or users who have authorized the YouTrack bot and have a registered account in the YouTrack site where the issue was created. The bot ignores all messages posted by people who don't meet these conditions. To exit discussion mode, use the `/wrapup` command. ## Slash Commands For a list of available commands, enter `/help`. The following slash commands are supported by the bot: | Command | Description | | --- | --- | | update | Updates a target issue by applying the specified command. Enter this command in the format `/update `. | | comment | Adds a comment to a target issue or article. Use the format `/comment ` or `/comment
`. | | discuss | Activates discussion mode for a specific issue. Use the format `/discuss `. | | wrapup | Exits discussion mode. You are only able to have one active discussion at a time, so there's no need to specify the issue ID. | | article | Creates a draft for a new article using the specified text as its title. Use the format `/article ` | | issue | Creates a draft for a new issue using the specified text as its summary. Use the format `/issue <summary>` | | cancel | Discard any active slash commands and reset the bot. | | start | Activates the YouTrack bot and connects it to the YouTrack service where the request to enable the integration was sent. | | authorize | Initiates an authorization request from the bot to your YouTrack account. The app replies to this command with an authorization link that you can use to log in. You also use this slash command to activate the YouTrack bot in a group chat where you want to discuss an issue. To learn more about this feature, see [Discuss an Issue in a Group Chat](#discuss-issue-group-chat). Use the format `/authorize <the base URL for your YouTrack site>` |