Configure Telegram

Configure a Telegram bot in Kora to receive task notifications and reply from your phone.

Setup

Create a Telegram bot

Open @BotFather on Telegram and send /newbot. Follow the prompts and copy the bot token.
Configure in Kora

Open Settings → Telegram Bot, paste the token, and save.
Register your chat

From your phone, open the bot’s chat and send /start. Kora registers your chat_id at the next polling cycle.
Verify

A test notification appears in the Telegram chat. From this point the channel is active.

Notifications sent by Kora

Agent turn completion
Confirmation requests (ask_confirmation, ask_user)
Execution errors
Sub-agent completion
System messages

Reply from Telegram

Reply directly to the Telegram message. Kora sends the reply to the corresponding session after the current turn finishes.

Move between projects and sessions

Use the bot commands when you need to reach a different conversation without returning to the Mac:

/projects lists the available projects.
/sessions lists the sessions in the current project.
/switch changes the active session; /rename renames it.
/status and /last show the current state and latest response.
/stop interrupts the active turn; /help lists the available commands.

Troubleshooting

Telegram settings are locked → connect a valid Kora key, then reopen Settings → Telegram Bot.
Bot not responding → check the bot token in Settings → Telegram Bot and save it again.
Test notification doesn’t arrive → confirm the chat is the right one. Send /start again from the bot chat to re-register the chat_id.
Replies are not delivered → keep Kora open and check its network connection.

See also: Sessions for session management.