telegram

Overview ¶

Package telegram provides the telegram_send tool for sending messages via the Telegram Bot API.

Authentication:

• Create a bot via @BotFather on Telegram → receive a bot token.
• The bot must have been started by (or added to) the target chat.
• For private messages: the user must have sent /start to the bot first.
• For groups: add the bot to the group.

Implementation notes for contributors:

• API endpoint: https://api.telegram.org/bot<TOKEN>/sendMessage
• Telegram supports HTML and MarkdownV2 parse modes.
• For MarkdownV2: special characters must be escaped with \ (e.g. \. \- \! \( \) \[ \]). Use HTML mode to avoid this.
• sendPhoto, sendDocument, sendAudio share the same base structure — implement sendMessage first and the rest follow the same pattern.
• chat_id can be a numeric ID or a @username for public groups.
• Telegram Bot API docs: https://core.telegram.org/bots/api

Env vars:

TELEGRAM_BOT_TOKEN  — bot token from @BotFather (required)
TELEGRAM_CHAT_ID    — default chat ID to send to (optional override)

See GitHub issue for full implementation spec.