Verified:GitHub

Send Telegram messages, files, and approval requests via the Bot API using bash scripts.

432|47|Updated Dec 22, 2025

Search Tags:#messaging #bash #notifications #alerts #approval workflow #telegram #bot api

Ready to run

npx skills add https://github.com/sanjay3290/ai-skills --skill telegram-sanjay3290

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: telegram
Source: https://github.com/sanjay3290/ai-skills/tree/main/skills/telegram
Command: npx skills add https://github.com/sanjay3290/ai-skills --skill telegram-sanjay3290

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) components.

What problem does it solve? Getting notified when long-running tasks finish or obtaining human approval for automated workflows requires leaving your terminal and checking dashboards. This Skill lets an AI agent send Telegram alerts, files, and ask-and-wait approval questions directly to your phone, and read replies back. ## Core Features & Use Cases - Send Messages and Files: Deliver plain text, MarkdownV2, or HTML messages (auto-split over 4096 characters) and documents, with images auto-detected and sent as photos. - Ask-and-Wait Approvals: Ask a question with inline buttons and block until a tap or free-text reply arrives, enabling approve-from-phone gates in scripts and CI. - Multi-Bot and Multi-Target Routing: Register named bots and route messages to named chats, groups, or channels, with replies only accepted from configured chat IDs. - Use Case: Wire Claude Code hooks so your phone pings when the agent needs input and when it finishes, or gate a production deploy behind a Yes/No Telegram confirmation. ## Quick Start Ask the AI to run scripts/telegram.sh setup to register a bot token, then send yourself a Telegram message saying the task is done.

Frequently Asked Questions about telegram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I send a Telegram message from a bash script?▼

Use the Telegram Bot API sendMessage endpoint with curl, passing your bot token, chat ID, and URL-encoded text. This Skill wraps that in scripts/telegram.sh send, which also auto-splits messages over 4096 characters and falls back to plain text if markup is rejected.

How to get approval from my phone before running a deploy script?▼

Use the ask command with inline Yes/No buttons and a timeout, then check the printed answer in a shell conditional. Exit code 0 means answered with the reply on stdout, and exit code 2 means the timeout elapsed with no response.

What dependencies are required to use the Telegram Bot API from the terminal?▼

Only bash, curl, and jq are required. macOS ships bash and curl by default, so typically only jq needs installing via brew install jq or apt install jq.

Can I send messages to Telegram groups or channels with a bot?▼

Yes, add the bot to the group or channel, send any message there, then run read --all to discover the chat ID. Save it as TARGET_<NAME> in the config file and reference it with --to <name>.

Why can't my Telegram bot read all messages in a group chat?▼

By default, bots in groups only see messages that mention them or reply to them due to privacy mode. Make the bot a group admin or disable privacy mode via @BotFather's /setprivacy command to read all group messages.

Is it safe to store a Telegram bot token in a config file?▼

The token grants full control of the bot, so treat it like a password. This Skill writes the config to ~/.config/telegram/config with mode 600 (owner read/write only), and only honors replies from configured chat IDs.