About 5 min read

Karma Telegram Bot

Karma One includes a zero-configuration Telegram bot (@karmabox7bot) that connects your Karma One account to Telegram. Once bound, you can chat with your avatars, receive task notifications, and send voice messages --- all directly from the Telegram app.

Binding Flow

Setting up the Telegram bot takes less than a minute and requires no API keys or bot configuration.

Step-by-Step

  1. Open Settings in Karma One.
  2. Navigate to Connections and find the Telegram Bot section.
  3. Tap Generate Binding Code. A unique code is created for your account.
  4. Open Telegram and search for @karmabox7bot.
  5. Start a chat with the bot and send the following command:
/start YOUR_BINDING_CODE
  1. The bot confirms the binding is complete. You are now connected.

Tip: The binding code is single-use and time-limited. Generate a new one if the previous code expires.

What Happens During Binding

  • A secure link is created between your Telegram account and your Karma One account.
  • No Telegram API tokens are needed --- the managed bot handles everything.
  • Your Telegram user ID is stored as a channel session for message routing.

Bidirectional Messaging

Once bound, you can send messages to the Karma bot in Telegram and receive responses from your avatars. The communication is fully bidirectional:

| Direction | How It Works | |---|---| | You to Karma | Send any text message to @karmabox7bot. It is routed to your default avatar. | | Karma to You | Task completions, autopilot results, and scheduled reports are pushed to your Telegram chat. |

Messages sent through Telegram are processed through the same AI pipeline as messages sent through the Karma One app. You get the same quality responses regardless of the entry point.

Multi-Avatar Routing

By default, messages sent to the Telegram bot are routed to your default conversation. You can configure which avatar handles Telegram messages:

  • Default routing --- messages go to your primary avatar.
  • Explicit routing --- use @mention syntax in Telegram to direct a message to a specific avatar.

Task Completion Push

When a background task completes --- whether triggered manually, by a schedule, or by an avatar's autopilot --- the result is automatically pushed to your Telegram chat. This includes:

  • Autopilot task results from avatar automation
  • Scheduled reports such as morning briefings
  • Long-running task completions from agent-mode or sandbox execution

For short results (under 500 characters), the full content is sent as a Telegram message. For longer results, a summary is sent with a reference back to the full output in the Karma One app.

Tip: Task push notifications only fire for tasks that were not initiated from a channel conversation (to avoid duplicate delivery).

Voice Message Support

The Karma Telegram bot supports voice-in and voice-out communication.

Voice In

Send a voice message to the bot in Telegram. Karma One transcribes the audio and processes it as a text message, then responds normally.

Voice Out

For short responses (up to 500 characters), the bot can reply with a synthesized voice message instead of text. This creates a natural voice conversation flow entirely within Telegram.

How It Works

  1. Record and send a voice message to @karmabox7bot.
  2. The audio is detected and transcribed using speech-to-text.
  3. The transcription is sent to your avatar for processing.
  4. The avatar's response is converted to audio via text-to-speech.
  5. The voice reply is sent back to your Telegram chat.

Voice responses use an OpenAI-compatible TTS engine for natural-sounding output.

Inline Query

You can use the bot's inline query feature to get quick answers from Karma One without opening a direct chat:

  1. In any Telegram chat, type @karmabox7bot followed by your question.
  2. The bot returns an answer as an inline result.
  3. Select the result to share it in the current chat.

Inline queries have an 8-second timeout for fast, lightweight lookups.

Binding Management

Viewing Binding Status

Go to Settings > Connections > Telegram Bot to see your current binding status, including your linked Telegram username.

Unbinding

To disconnect your Telegram account:

  1. Open Settings > Connections > Telegram Bot.
  2. Tap Unbind.
  3. Confirm the action.

After unbinding, messages sent to the bot will no longer be routed to your Karma One account.

Rebinding

To switch to a different Telegram account:

  1. Unbind the current account.
  2. Generate a new binding code.
  3. Complete the binding flow with the new Telegram account.

Conflict Guard

If you also run a custom Telegram bot through the Channels feature using the same bot token as the managed bot, Karma One automatically detects the conflict. The custom channel is stopped with a clear error message, and the managed bot takes priority.

Best Practices

  • Bind Telegram early to receive push notifications for all background tasks.
  • Use voice messages for hands-free interaction when you are away from your desk.
  • Check inline queries for quick lookups without switching apps.
  • Keep your binding active --- there is no cost to maintaining the connection, and it ensures you never miss a notification.