Telegram
Pair your own Telegram bot with your Chief of Staff, chat from one private chat, and approve requests with a tap.
Set up Telegram
Do the four steps in order. Each one ends with a green box that tells you it worked.
Step 1
Create a Telegram bot
- In Telegram, open BotFather. The link in Murage opens it for you.
- Send
/newbot, then follow the prompts to give your bot a name and a username. - Copy the bot token BotFather gives you.
You're done when: BotFather sends you a token.
Step 2
Save the token in Murage
- Open SettingsMessaging apps.
- In the Telegram card, paste the token into Bot token.
- Choose Save token. You'll see "Token saved. Pairing has not started."
The token is stored encrypted on your computer and isn't shown again. The status line now reads Token saved · not paired.
You're done when: the status line shows Token saved · not paired.
Step 3
Pair with your Chief
- Choose Pair with Chief. Murage shows a command:
/pairfollowed by a long code. - Choose Copy pairing command, or Open Telegram bot to jump straight to your new bot.
- Send the command to your bot in a private Telegram chat.
While Murage waits, the status updates by itself and reads Waiting for pairing. When it reads Paired, the bot replies to confirm.
You're done when: the status reads Paired and your bot replies.
Step 4
Link the account to yourself
The bot's first reply asks you to link this account before chatting. Murage doesn't assume a chat account is you, so you choose.
- Open Team map and choose Manage memory.
- Under People and verified accounts, find the row that starts "Telegram account".
- Choose This is my account.
Then send your message again. You only do this once.
Choose This is my account if you want approvals on Telegram. Approval buttons only go to an account linked to you, the workspace owner. Separate person keeps that account isolated from your own context.
You're done when: you chose This is my account and your resent message gets an answer.
Chatting
Message your bot and your Chief of Staff answers. Your messages share the Chief's current conversation, so you can pick it up on your computer later.
- Text: type as you would to a person. Replies show basic formatting: bold, italics, code and links.
- Voice: ask your Chief for a voice note and it sends one here in its own voice. Your Chief reads text messages, not voice messages or files. Voice needs Flux Router credits or your own voice keys.
- Pictures and files: share these in Murage on your computer or phone. The Telegram chat is for talking to your Chief.
Only your paired account in that one private chat is heard. Messages in groups, forwarded messages and messages from anyone else are ignored.
Approvals and questions
When your Chief needs permission in your conversation with it, Telegram shows the request with buttons:
- Approve once or Deny for ordinary requests.
- Approve once, Allow for this task or Deny for stop-line requests, such as messaging someone new. Allow for this task covers the same kind of action in the same place until the task ends.
- Approve onceSays yes to this one request.
- Allow for this taskSays yes to the same kind of action in the same place until the task ends.
- DenySays no to this request.
Each request expires after 10 minutes. After that it says:
Expired. Review this action in Murage.
When your Chief asks you a question, you get its options as buttons. Tap an answer, or tap several and then Submit. If the question allows your own words, tap Reply with text and send your answer (/cancel goes back to the options). Skip question tells your bot you didn't answer. Questions stay open for 30 minutes.
- OptionsTap an answer, or tap several and then Submit.
- Reply with textShows if the question allows your own words. Send your answer, or /cancel to go back to the options.
- Skip questionTells your bot you didn't answer.
Some things always stay in Murage: requests from other bots, anything too long to show in full, secret answers such as passwords, routine and skill proposals. Use the Inbox or menu bar for those.
Typing "approve", "yes" or /approve doesn't approve anything. You'll get this reply instead:
Review approvals in the Murage app. Telegram messages cannot approve actions.
What comes back to Telegram
- Replies to messages you sent from Telegram, and any voice notes your Chief made while answering.
- Approval requests and questions from your Chief's conversation.
Work you start in Murage, and routines such as a morning brief, report in the app, not in Telegram.
Your own messages at Full access or No limits
If your Chief's default is Full access or No limits, your own direct messages from Telegram, Slack and Discord run at that level, without cards. The switch is Also skip approvals for my messages from Telegram, Slack and Discord in Bot settingsPermissions. It's on unless you turn it off, and you can only change it in the desktop app. Group chats and other people still ask. See Permissions and the stop line.
Limits
- One of each. One Telegram bot, one private chat, one person, your Chief only.
- Long replies. A reply longer than 4,096 characters, Telegram's limit, is cut short. Read the full result in Murage.
- Three tasks at a time. Up to three unfinished tasks from Telegram at a time. Wait for one to finish, or review them in Murage.
- Retries. If a reply fails with a temporary error, Murage retries a few times, then marks it as not delivered. A reply that did go through is never sent twice.
Change or remove it
- Revoke ends the connection and cancels tasks from Telegram that haven't finished. You need to revoke before you can change the token or pair a different bot.
- If Telegram rejects your token (for example, you revoked it in BotFather), paste a new token for the same bot and choose Replace token. Your pairing is kept. A token for a different bot is refused.
Troubleshooting
Find the message you see, then do what the right column says.
You see
Pairing expired · create a new codeDo this
Choose Create new pairing code and send the new command. If you send an expired code, the bot says "This pairing code expired."
You see
Another app is receiving this botDo this
Something else, such as another program or server, is reading this bot's messages, so Murage paused. Stop it, then choose Retry now.
You see
Token rejected · paste a new token for this botDo this
Copy the current token from BotFather and choose Replace token.
You see
This token belongs to a different Telegram bot.Do this
Paste the token for the paired bot, or Revoke before pairing another bot.
You see
Chief unavailable · revoke and re-pairDo this
Your Chief changed or was removed. Choose Revoke, then pair again with the current Chief.
You see
Connection saved · retrying automaticallyDo this
Telegram couldn't be reached. Murage keeps your pairing and tries again.
You see
Link this channel account to yourself or another person...Do this
Finish step 4 above, then resend.
You see
A message delivery is uncertain. Check Telegram before sending it again.Do this
Murage can't confirm a reply arrived. Look in Telegram before repeating the request.
You see
No reply at allDo this
Check that the computer is awake and Murage is running.
Related: Approve from your phone, Channels overview, Voice notes, Approvals and the stop line.