Skip to main content
Kaneo can post task activity to Telegram whenever events occur in a project. Unlike Slack and Discord, Telegram uses a bot token plus a chat ID instead of an incoming webhook URL.

​
Create a Telegram bot

  1. Open Telegram and start a chat with @BotFather.
  2. Send /newbot and follow the prompts.
  3. Copy the bot token that BotFather returns. It will look like:
123456789:AAExampleBotToken1234567890
Treat the bot token like a password. Anyone with the token can send messages as your bot.

​
Add the bot to your destination

Add the bot to the private chat, group, supergroup, or channel where you want notifications.
  • Personal chat: start a conversation with the bot and send any message.
  • Add the bot to a group or supergroup, then send a message in that chat.
  • A channel may require adding the bot as an administrator so it can post updates.
  • Forum-style supergroups need the bot added to the group, plus the topic you want to post into.

​
Find the chat ID

  1. After adding the bot, send at least one message in the destination chat.
  2. Open this URL in your browser, replacing BOT_TOKEN with your real token:
https://api.telegram.org/botBOT_TOKEN/getUpdates
  1. Look for one of these fields in the JSON response:
  • Private chat or group: message.chat.id
  • Channel: channel_post.chat.id
  • Topic/thread in a forum group: use the same chat ID, and also copy message.message_thread_id
Typical values look like: 
{
  "message": {
    "chat": {
      "id": -1001234567890
    },
    "message_thread_id": 42
  }
}
If getUpdates returns an empty result, send a fresh message in Telegram and reload the URL. If you see a 404, double-check that the URL format is exactly https://api.telegram.org/bot<token>/getUpdates.

​
Connect Telegram in Kaneo

  1. Open Settings in the sidebar.
  2. Under Projects, select the project you want to connect.
  3. Open the Integrations tab.
  4. Expand the Telegram section.
  5. Paste your bot token.
  6. Enter the chat ID.
  7. Optionally enter a topic thread ID if you want messages posted into a specific Telegram forum topic.
  8. Optionally add a chat label for your own reference.
  9. Choose which events to subscribe to.
  10. Click Connect Telegram.
Once connected you can enable or disable the integration with the toggle, update event subscriptions, rotate the bot token, or disconnect entirely.

​
Supported events

EventDefaultDescription
Task createdOnA new task is created in the project
Task status changedOnA task moves to a different status column
Task priority changedOffA task’s priority is changed
Task title changedOffA task’s title is edited
Task description changedOffA task’s description is edited
Task comment createdOnA new comment is added to a task
You can change these toggles at any time in the integration settings.

​
Message format

Kaneo sends formatted Telegram messages with:
  • The event title
  • A direct link to the task in Kaneo
  • Project, status, and priority details
  • The name of the user who triggered the event when available
Make sure KANEO_CLIENT_URL is set to your public Kaneo URL so task links work correctly.

​
Updating credentials

To rotate the bot token after connecting, paste a new token in the bot token field and click Save Changes. If you leave the token field empty, Kaneo keeps the currently stored token. You can also update the chat ID, thread ID, label, and event subscriptions at any time.

​
Disconnecting

Click Disconnect to remove the integration. This deletes the stored Telegram configuration for that project. You can reconnect at any time with a new bot token and chat ID.