Workboard 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

Open Telegram and start a chat with @BotFather.
Send /newbot and follow the prompts.
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

After adding the bot, send at least one message in the destination chat.
Open this URL in your browser, replacing BOT_TOKEN with your real token:

https://api.telegram.org/botBOT_TOKEN/getUpdates

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 Workboard

Open Settings in the sidebar.
Under Projects, select the project you want to connect.
Open the Integrations tab.
Expand the Telegram section.
Paste your bot token.
Enter the chat ID.
Optionally enter a topic thread ID if you want messages posted into a specific Telegram forum topic.
Optionally add a chat label for your own reference.
Choose which events to subscribe to.
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

Event	Default	Description
Task created	On	A new task is created in the project
Task status changed	On	A task moves to a different status column
Task priority changed	Off	A task's priority is changed
Task title changed	Off	A task's title is edited
Task description changed	Off	A task's description is edited
Task comment created	On	A new comment is added to a task

You can change these toggles at any time in the integration settings.

Message format

Workboard sends formatted Telegram messages with:

The event title
A direct link to the task in Workboard
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 Workboard 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, Workboard 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.