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.