@robinpath/telegram

Telegram Bot API client for sending messages, photos, documents, locations, polls, stickers, and managing chats

Why use this module?

The telegram module lets you:

• Get info about the bot (id, first_name, username)
• Send a text message to a chat
• Send a photo from a local file to a chat
• Send a document/file from a local path to a chat
• Send a GPS location to a chat

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

robinpath add @robinpath/telegram

Quick Start

1. Set up credentials

telegram.setToken "default" "123456:ABC-DEF..."

2. Get info about the bot (id, first_name, username)

telegram.getMe "default"

Available Functions

| Function | Description | |----------|-------------| | telegram.setToken | Store a Telegram bot token for subsequent API calls | | telegram.getMe | Get info about the bot (id, first_name, username) | | telegram.send | Send a text message to a chat | | telegram.sendPhoto | Send a photo from a local file to a chat | | telegram.sendDocument | Send a document/file from a local path to a chat | | telegram.sendLocation | Send a GPS location to a chat | | telegram.sendPoll | Send a poll to a chat | | telegram.editMessage | Edit the text of an existing message | | telegram.deleteMessage | Delete a message from a chat | | telegram.getUpdates | Receive incoming updates via long polling | | telegram.sendSticker | Send a sticker by file_id to a chat | | telegram.getChat | Get up-to-date information about a chat |

Examples

Get info about the bot (id, first_name, username)

telegram.getMe "default"

Send a text message to a chat

telegram.send "default" "-100123456" "Hello from RobinPath!"

Send a photo from a local file to a chat

telegram.sendPhoto "default" "-100123456" "/tmp/photo.jpg" {"caption": "Look at this!"}

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/telegram";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  telegram.setToken "default" "123456:ABC-DEF..."
  telegram.getMe "default"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/slack — Slack module for complementary functionality
• @robinpath/discord — Discord module for complementary functionality
• @robinpath/teams — Teams module for complementary functionality
• @robinpath/whatsapp — WhatsApp module for complementary functionality
• @robinpath/json — JSON module for complementary functionality

License

MIT