Telegram

Jutsu sends notifications to a Telegram chat or group through a bot, so your team gets a short summary and a link back into Jutsu wherever they already chat. Telegram delivery is configured at the organization level.

Overview

To deliver to Telegram, Jutsu needs a bot token and the chat ID of the destination conversation. The bot posts messages into the chat or group; the chat ID tells Jutsu where to send them. This sits alongside per-user email preferences—see Notifications & SLAs for how delivery channels and individual preferences fit together.

Create a bot and get the chat ID

  1. In Telegram, message @BotFather, create a new bot with /newbot, and copy the bot token it gives you.
  2. Add the bot to the group you want notifications in—or start a direct chat with it—and send it any message so it has a conversation to read.
  3. Find the chat ID for that conversation. A common way is to call the Telegram Bot API's getUpdates method for your bot and read the chat.id value from the most recent message. Group chat IDs are typically negative numbers.
The exact way to retrieve a chat ID varies, and group IDs differ from direct-message IDs. Confirm the value posts to the right conversation with a test before relying on it.

Connect in Jutsu

In your organization's notification settings, choose Telegram as a delivery channel and enter the bot token and chat ID. Save, then send a test notification if available to confirm the bot posts to the intended chat. As with other channels, you choose which categories—such as alerts, incidents, cases, and reports—are delivered to Telegram.

Troubleshooting

  • No messages arrive — confirm the bot token is correct and the bot is a member of the target group (and not removed or blocked).
  • Wrong conversation — re-check the chat ID; a direct-message ID and a group ID are different, and group IDs are usually negative.
  • Stopped after a change — if you recreated the bot or the group, regenerate the token or chat ID and update it in Jutsu.