Connecting Telegram
Telegram is connected via a bot that you create in Telegram itself, then paste the bot token into wrrk.
Create the bot
- In Telegram, search for @BotFather
- Send
/newbot - Choose a display name (e.g. "Acme Support")
- Choose a username, must end in
bot (e.g. acme_support_bot) - BotFather replies with a token: a long string like
123456:ABC-DEF.... Copy it
Connect to wrrk
- Go to Telegram in the wrrk sidebar
- Paste the bot token into the input field
- Click Connect
wrrk verifies the token with Telegram. Once connected, the bot is live, anyone who messages the bot username on Telegram appears in your wrrk inbox.
Using the inbox
After connection, the page switches to a two-pane view:
- Left: chat list (everyone who's messaged your bot)
- Right: message thread for the selected chat
Send messages, attach files, react with emojis. Notifications fire when a new message arrives.
Limitations
- A Telegram bot can only message users who message it first, Telegram restricts unsolicited bot outreach
- For group chats, add the bot to the group manually; group messages then surface in wrrk
- One bot per org. To switch bots, disconnect first (gear icon → Disconnect)
Troubleshooting
- "Invalid token": make sure you copied the entire string after
HTTP API: from BotFather - No messages arriving: Telegram bots have a webhook; if you've connected the same bot to another service, only one webhook will receive messages. Disconnect from the other service first.