Telegram Integration

Real-time notifications to your Telegram groups. Every stage of the feedback loop posts automatically — your team sees progress as it happens.

Overview

Yocoolab sends rich notifications to Telegram at every thread lifecycle stage: new feedback, Claude working, PR created, and resolved. Each message includes the thread summary, priority, element context, and direct links. Your team stays informed right where they already communicate.

Prerequisites

  • A Telegram account
  • A Telegram group where you want notifications
  • Access to @BotFather on Telegram

Setup Steps

  1. 1

    Create a Telegram bot

    Open Telegram and message @BotFather. Send /newbot and follow the prompts:

    • Choose a display name (e.g., "Yocoolab Notifications")
    • Choose a username (e.g., "yocoolab_your_team_bot")

    BotFather will give you a bot token. Copy it.

  2. 2

    Add the bot to your group

    Open the Telegram group where you want notifications. Add the bot as a member by searching for its username.

  3. 3

    Get the chat ID

    Send any message in the group, then open this URL in your browser (replace YOUR_TOKEN with your bot token):

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

    Find the chat.id value in the response. Group chat IDs are negative numbers (e.g., -1001234567890).

  4. 4

    Enter credentials in Yocoolab

    In the admin dashboard, go to Settings → Integrations → Telegram. Paste the bot token and click Save.

  5. 5

    Test the connection

    Click Test Connection. You should see the bot's username confirming the token is valid.

  6. 6

    Map repositories to Telegram chats

    For each Yocoolab repository, enter the Telegram chat ID. All thread notifications for that repo will post to the mapped group.

What Gets Notified

Thread created
New feedback with summary, priority, and element context
Claude Code working
Real-time status update with thread reference
PR created
Pull request link with branch name
Thread resolved
Confirmation with resolution summary

API Reference

MethodEndpointDescription
POST/api/v1/telegram/configSave Telegram bot token
GET/api/v1/telegram/configGet current Telegram configuration status
GET/api/v1/telegram/testTest stored Telegram credentials
POST/api/v1/telegram/mappingsCreate or update a repo-to-chat mapping
GET/api/v1/telegram/mappingsList all repo-to-chat mappings
DELETE/api/v1/telegram/configDisconnect Telegram integration

Troubleshooting

Warning

Bot not posting — Make sure the bot is added to the group. Telegram bots can only send messages to groups they're a member of.

Warning

Chat ID format — Group chat IDs are negative numbers. If you're using a supergroup, the ID starts with -100.

Note

DM notifications — You can also use a personal chat ID (positive number) to receive notifications as direct messages from the bot.

Ready to start reviewing on the real product?

Install the free Chrome Extension, connect your tools, and start shipping faster — in under a minute.

Install Extension — FreeOr sign in to the dashboard →

No seat fees. Every team member is free — designers, developers, PMs, stakeholders.