get_bot_status

Read Telegram bot connection status for a project. Returns connected bool and bot details (id, name, url).

Purpose

Read the Telegram bot connection status for a project. Returns connected and, when connected, the bot's id, name, and url. The bot secret token is never surfaced — connect/rotate flows stay dashboard-only since each requires a round-trip to Telegram's Bot API with the plaintext token.

Required ability

project:view

Input schema

{
  "type": "object",
  "required": ["project_id"],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "UUID of the project to check."
    }
  }
}

Output shape

{
  "data": {
    "project_id": "prj_01HX...",
    "connected": true,
    "bot": {
      "id": "bot_01HX...",
      "name": "Research Bot",
      "url": "https://t.me/research_bot"
    }
  }
}

When no bot is linked, connected is false and bot is null.

Example prompts

"Is project prj_01HX... connected to a Telegram bot?"

"What's the bot URL for my Research Premium project?"

Failure modes

RESOURCE_NOT_FOUND — project_id is not a valid UUID, or the project belongs to a team outside the token's scope.
TOKEN_MISSING_ABILITY — token lacks project:view.

get_deep_link — build sharable links against the connected bot.
get_project
Bot API