telegram

Name: telegram
Author: sanjay3290

SKILL·CB179C

sanjay3290

更新于 8 days ago

1 次查看

347

在 GitHub 上查看

开发aiapi

关于

This Claude Skill enables sending Telegram messages, files, and interactive alerts via the Bot API, and can read replies for approval workflows. It's useful for notifications from scripts, cron jobs, or CI/CD pipelines, and for creating ask-and-wait approval flows. The tool is implemented in pure bash with curl and jq, requiring only a bot token for setup.

快速安装

Claude Code

技能文档

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

GitHub 仓库

sanjay3290/ai-skills

路径: skills/telegram

agent-skillsai-skillsatlassianazure-devopsclaude-codeclaude-skills

FAQ

Frequently asked questions

What is the telegram skill?

telegram is a Claude Skill by sanjay3290. Skills package instructions and resources that Claude loads on demand, so Claude can perform telegram-related tasks without extra prompting.

How do I install telegram?

Use the install commands on this page: add telegram to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does telegram belong to?

telegram is in the Development category, tagged ai and api.

Is telegram free to use?

Yes. telegram is listed on AIMCP and free to install. It runs inside Claude, so no separate service account is required to use the skill itself.