telegram.bot.validate-token

Validate a Telegram bot token via getMe and return bot metadata (bot_ref, username, first_name, is_bot)

Call Telegram getMe to validate a bot token and return bot metadata.

PENDING (auto_advance=execute) → COMPLETED with bot metadata ↘ FAILED on any error

Overview

Property	Value
Workflow type	Atomic
Library	App-telegram
Version	1.0

Input Schema

Field	Type	Required	Default	Description
bot_token	string	Yes	—	Telegram Bot API token issued by BotFather (format: <bot_id>:<token_secret>)
workflow_run_id	string	No	—	Engine-stamped parent run id (DAG step target)

Output Schema

Field	Type	Required	Default	Description
bot_ref	integer	Yes	—	Telegram integer bot reference returned by getMe
username	string	Yes	—	Bot @username (without @) returned by getMe
first_name	string	No	—	Display name of the bot returned by getMe (may be absent)
is_bot	boolean	Yes	—	Always True for a valid bot token; surfaced for schema completeness
failure_reason	string	No	—	Engine-stamped human-readable failure reason
failure_type	string	No	—	Engine-stamped failure category
failed_action	string	No	—	Engine-stamped action that raised
failed_at_state	string	No	—	Engine-stamped state when the workflow failed
failed_step	string	No	—	Engine-stamped step name (DAG path)
failed_layer	string	No	—	Engine-stamped layer index (DAG path)
error	string	No	—	Engine-stamped exception message
error_type	string	No	—	Engine-stamped exception class name

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	Validate bot token via Telegram getMe
completed	No	Yes	Yes	—	Token valid; bot metadata captured
failed	No	Yes	No	—	Token validation failed

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "telegram.bot.validate-token",
  "initial_data": {
    "bot_token": "value"
  }
}