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": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "connected": true,
    "bot": {
      "id": "5e93b1d7-4a20-4c68-8f51-9b0d27e6a34c",
      "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 7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13 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