How do I install the Telegram skill?

Run npx skillmds@latest add sanjay3290/telegram in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Telegram safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Telegram?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Telegram free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Telegram?

sanjay3290 (@sanjay3290) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Telegram by sanjay3290 — Agent Skill

Name: Telegram
Rating: 4.2 (5 reviews)
Author: sanjay3290

Send Telegram messages, files, and alerts via bot API; read replies; ask questions with inline buttons and wait for the answer (approve-from-phone). Supports multiple bots and named chat targets. Use when the user wants to send a Telegram message or alert, get notified on Telegram when a task finishes or needs input, ask for approval via Telegram, or wire Telegram notifications into hooks, cron jobs, or CI. Triggers: 'telegram', 'send me a telegram', 'alert me on telegram', 'ask me on telegram', 'notify me when done'.

sanjay3290 cb8fd89 3 files · 21.9 KB Updated Sep 9, 2026

File contents

Send updates, alerts, and files to Telegram; read replies; run ask-and-wait approval flows. Pure bash + curl + jq — no install beyond a bot token.

First run: scripts/telegram.sh setup (guided BotFather walkthrough).

Commands

scripts/telegram.sh send "Deploy finished ✅"                    # basic alert
scripts/telegram.sh send "low priority" --silent                # no notification sound
scripts/telegram.sh send "*bold* alert" --format md             # MarkdownV2 (falls back to plain)
scripts/telegram.sh send "hi" --to alerts --bot work            # named target + named bot
scripts/telegram.sh file report.pdf "Q3 report"                 # document (photos auto-detected)
scripts/telegram.sh read                                        # new incoming messages since last read
ANSWER=$(scripts/telegram.sh ask "Deploy to prod?" --options "Yes,No" --timeout 300)
# exit 0 = answered (stdout = answer), 2 = timeout

Config

Env vars win, then ~/.config/telegram/config (mode 600):

TELEGRAM_BOT_TOKEN=123:ABC...     # default bot
TELEGRAM_CHAT_ID=987654321        # default target
BOT_ALERTS_TOKEN=456:DEF...       # --bot alerts   (add via: setup --bot alerts)
TARGET_FAMILY=-100987...          # --to family    (any chat/group/channel id)

Replies and answers are only accepted from configured chat IDs.

Claude Code hooks (settings.json)

Ping your phone when Claude needs input, and when it finishes:

{
  "hooks": {
    "Notification": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"🔔 Claude needs input in $(basename \\\"$PWD\\\")\""}]}],
    "Stop": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"✅ Claude finished in $(basename \\\"$PWD\\\")\" --silent"}]}]
  }
}

Approval gate in any script/automation:

if [ "$(scripts/telegram.sh ask 'Deploy to prod?' --options 'Yes,No')" = "Yes" ]; then
  ./deploy.sh
fi

---name: telegramdescription: Send Telegram messages, files, and alerts via bot API; read replies; ask questions with inline buttons and wait for the answer (approve-from-phone). Supports multiple bots and named chat targets. Use when the user wants to send a Telegram message or alert, get notified on Telegram when a task finishes or needs input, ask for approval via Telegram, or wire Telegram notifications into hooks, cron jobs, or CI. Triggers: 'telegram', 'send me a telegram', 'alert me on telegram', 'ask me on telegram', 'notify me when done'.--- # Telegram Send updates, alerts, and files to Telegram; read replies; run ask-and-wait approval flows. Pure bash + curl + jq — no install beyond a bot token. First run: `scripts/telegram.sh setup` (guided BotFather walkthrough). ## Commands ```bash scripts/telegram.sh send "Deploy finished ✅" # basic alert scripts/telegram.sh send "low priority" --silent # no notification sound scripts/telegram.sh send "*bold* alert" --format md # MarkdownV2 (falls back to plain) scripts/telegram.sh send "hi" --to alerts --bot work # named target + named bot scripts/telegram.sh file report.pdf "Q3 report" # document (photos auto-detected) scripts/telegram.sh read # new incoming messages since last read ANSWER=$(scripts/telegram.sh ask "Deploy to prod?" --options "Yes,No" --timeout 300) # exit 0 = answered (stdout = answer), 2 = timeout ``` ## Config Env vars win, then `~/.config/telegram/config` (mode 600): ``` TELEGRAM_BOT_TOKEN=123:ABC... # default bot TELEGRAM_CHAT_ID=987654321 # default target BOT_ALERTS_TOKEN=456:DEF... # --bot alerts (add via: setup --bot alerts) TARGET_FAMILY=-100987... # --to family (any chat/group/channel id) ``` Replies and answers are only accepted from configured chat IDs. ## Claude Code hooks (settings.json) Ping your phone when Claude needs input, and when it finishes: ```json { "hooks": { "Notification": [{"hooks": [{"type": "command", "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"🔔 Claude needs input in $(basename \\\"$PWD\\\")\""}]}], "Stop": [{"hooks": [{"type": "command", "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"✅ Claude finished in $(basename \\\"$PWD\\\")\" --silent"}]}] } } ``` Approval gate in any script/automation: ```bash if [ "$(scripts/telegram.sh ask 'Deploy to prod?' --options 'Yes,No')" = "Yes" ]; then ./deploy.sh fi ```

Frequently asked questions

Telegram