@radzor/telegram-bot

Telegram bot component using the Bot API. Send messages, photos, reply keyboards, and inline keyboards.

Chat & Messagingv0.1.0typescriptpythonServertelegrambotchatmessagingsocialby Radzor

Install

$npx radzor@latest add telegram-bot

⚠ Constraints: Requires a Telegram Bot Token from @BotFather. Uses long-polling by default. For production, prefer webhook mode with HTTPS.

Inputs

Name	Type	Default	Description
botToken*	string	—	Telegram Bot API token from @BotFather.TELEGRAM_BOT_TOKEN

botToken*string

Telegram Bot API token from @BotFather.

TELEGRAM_BOT_TOKEN

Outputs

Name	Type	Description
messageResult	{ messageId: number; chatId: number }	Sent message ID and chat ID.

messageResult{ messageId: number; chatId: number }

{ "llm": { "constraints": "Requires a Telegram Bot Token from @BotFather. Uses long-polling by default. For production, prefer webhook mode with HTTPS.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/telegram-bot", "tags": [ "telegram", "bot", "chat", "messaging", "social" ], "events": [ { "name": "onMessageSent", "payload": { "chatId": "string", "messageId": "number" }, "description": "Fired when a message is successfully sent." }, { "name": "onError", "payload": { "code": "string", "message": "string" }, "description": "Fired on API error." } ], "inputs": [ { "name": "botToken", "type": "string", "envVar": "TELEGRAM_BOT_TOKEN", "required": true, "description": "Telegram Bot API token from @BotFather." } ], "radzor": "1.0.0", "actions": [ { "name": "sendMessage", "params": [ { "name": "chatId", "type": "number | string", "description": "Target chat ID or @username." }, { "name": "text", "type": "string", "description": "Message text (supports Markdown or HTML)." }, { "name": "parseMode", "type": "'Markdown' | 'HTML'", "required": false, "description": "Text formatting mode." } ], "returns": "Promise<{ messageId: number; chatId: number }>", "description": "Send a text message to a chat." }, { "name": "sendPhoto", "params": [ { "name": "chatId", "type": "number | string", "description": "Target chat ID or @username." }, { "name": "photo", "type": "Buffer | string", "description": "Photo as Buffer or public URL." }, { "name": "caption", "type": "string", "required": false, "description": "Optional caption text." } ], "returns": "Promise<{ messageId: number; chatId: number }>", "description": "Send a photo to a chat." }, { "name": "sendReplyKeyboard", "params": [ { "name": "chatId", "type": "number | string", "description": "Target chat ID." }, { "name": "text", "type": "string", "description": "Message text." }, { "name": "keyboard", "type": "string[][]", "description": "2D array of button labels." } ], "returns": "Promise<{ messageId: number; chatId: number }>", "description": "Send a message with a reply keyboard." }, { "name": "sendInlineKeyboard", "params": [ { "name": "chatId", "type": "number | string", "description": "Target chat ID." }, { "name": "text", "type": "string", "description": "Message text." }, { "name": "keyboard", "type": "Array<Array<{ text: string; callbackData: string }>>", "description": "Inline keyboard button rows." } ], "returns": "Promise<{ messageId: number; chatId: number }>", "description": "Send a message with inline keyboard buttons." } ], "outputs": [ { "name": "messageResult", "type": "{ messageId: number; chatId: number }", "description": "Sent message ID and chat ID." } ], "runtime": "server", "version": "0.1.0", "category": "chat", "languages": [ "typescript", "python" ], "description": "Telegram bot component using the Bot API. Send messages, photos, reply keyboards, and inline keyboards.", "dependencies": { "packages": {} }, "composability": { "connectsTo": [ { "event": "onMessageSent", "description": "Track Telegram message delivery", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] }, { "event": "onError", "description": "Track Telegram bot errors", "compatibleWith": [ "@radzor/error-tracker.action.captureMessage.message" ] } ] } }

@radzor/telegram-bot

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History