Send messages, images, and marketing content to Telegram channels and groups via Bot API. Create formatted posts, polls, and media content for Telegram communities. Trigger phrases: "post to telegram", "telegram message", "telegram channel", "telegram bot", "telegram marketing", "send to telegram", "telegram announcement", "telegram broadcast".
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Send messages, images, and marketing content to Telegram channels and groups via Bot API. Create formatted posts, polls, and media content for Telegram communities. Trigger phrases: "post to telegram", "telegram message", "telegram channel", "telegram bot", "telegram marketing", "send to telegram", "telegram announcement", "telegram broadcast".
allowed-tools
["Bash","WebFetch","WebSearch"]
Telegram Bot Skill
You are a Telegram marketing specialist. Your job is to help users send messages, media, polls,
and marketing content to Telegram channels and groups using the Telegram Bot API. You handle
formatting, inline keyboards, and content templates for effective channel management.
Prerequisites
Environment Variables
Check for required credentials before any API call:
source ~/.claude/.env.global 2>/dev/null
source .env 2>/dev/null
source .env.local 2>/dev/null
if [ -z "$TELEGRAM_BOT_TOKEN" ]; thenecho"TELEGRAM_BOT_TOKEN is not set."echo"To create a bot and get a token:"echo" 1. Open Telegram and search for @BotFather"echo" 2. Send /newbot and follow the prompts"
1
[ -z ];
echo
" 3. Copy the token and add it to your .env or ~/.claude/.env.global:"
Response: Returns a JSON object with ok: true and the sent message object on success. Check ok to confirm delivery. The message.message_id can be saved for later editing or deletion.
sendPhoto - Images
Send a photo by URL or file ID:
# Send photo by URL
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPhoto" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"photo": "https://example.com/image.jpg",
"caption": "Image caption with <b>HTML</b> formatting",
"parse_mode": "HTML"
}'
# Send photo from local file
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPhoto" \
-F "chat_id=${TELEGRAM_CHAT_ID}" \
-F "photo=@/path/to/image.jpg" \
-F "caption=Image caption here" \
-F "parse_mode=HTML"
Photo limits: Maximum file size 10 MB. The photo will be compressed. For uncompressed images up to 50 MB, use sendDocument instead.
sendDocument - Files and Documents
Send any file (PDF, ZIP, uncompressed images, etc.):
# Quiz mode (one correct answer)
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPoll" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"question": "Which programming language was created first?",
"options": ["Python", "JavaScript", "C", "Java"],
"type": "quiz",
"correct_option_id": 2,
"explanation": "C was created by Dennis Ritchie in 1972, well before the others.",
"explanation_parse_mode": "HTML"
}'
Poll limits: Question text 1-300 characters. 2-10 options, each 1-100 characters. Explanation up to 200 characters.
Inline Keyboard Buttons (CTAs)
Add clickable buttons below any message for calls-to-action:
HTML escaping rules: Replace & with &, < with <, > with > in all text that is not part of an HTML tag. Unrecognized tags are stripped. Tags must be properly closed.
MarkdownV2 Mode
Set "parse_mode": "MarkdownV2" and use this syntax:
Syntax
Result
*bold*
Bold
_italic_
Italic
__underline__
Underline
~strikethrough~
Strikethrough
`code`
Monospace
```code block```
Code block
[text](url)
Link
`
>blockquote
Block quote (start of line)
MarkdownV2 escaping rules: These characters MUST be escaped with a preceding backslash outside of code blocks: _ * [ ] ( ) ~ > # + - = | { } . !. This makes MarkdownV2 error-prone. HTML mode is recommended for most use cases to avoid escaping issues.
Formatting Tips
Use blank lines (\n\n) to separate sections visually.
Emoji work natively in message text. No special handling needed.
Combine formatting: <b><i>bold italic</i></b> works in HTML mode.
Links can be hidden behind text: <a href="https://example.com">Click here</a>.
For silent messages (no notification), add "disable_notification": true to the request body.
Marketing Content Templates
Template 1: Product Announcement
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"parse_mode": "HTML",
"text": "🚀 <b>Introducing [Product Name]</b>\n\n[One-sentence value proposition that answers: what is it and why should I care?]\n\n<b>What'"'"'s new:</b>\n✅ [Feature 1] — [Benefit in user terms]\n✅ [Feature 2] — [Benefit in user terms]\n✅ [Feature 3] — [Benefit in user terms]\n\n💡 <i>[Short sentence about who this is for or what problem it solves]</i>\n\n👉 <a href=\"https://example.com\">Try it now</a>",
"reply_markup": {
"inline_keyboard": [
[
{"text": "🔗 Try It Now", "url": "https://example.com"},
{"text": "📖 Learn More", "url": "https://example.com/blog"}
]
]
}
}'
Template 2: Blog Post Share
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"parse_mode": "HTML",
"text": "📝 <b>New on the blog:</b> [Blog Post Title]\n\n[2-3 sentence summary that highlights the key takeaway and why the reader should care. Pull out the most surprising insight or actionable tip.]\n\n<b>Key takeaways:</b>\n🔹 [Takeaway 1]\n🔹 [Takeaway 2]\n🔹 [Takeaway 3]\n\n⏱ [X] min read",
"reply_markup": {
"inline_keyboard": [
[
{"text": "📖 Read the Full Post", "url": "https://example.com/blog/post-slug"}
]
]
}
}'
Template 3: Community Update / Newsletter Digest
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"parse_mode": "HTML",
"text": "📢 <b>[Brand] Weekly Update — [Date]</b>\n\nHey everyone! Here'"'"'s what happened this week:\n\n<b>🔧 Product</b>\n• [Update 1]\n• [Update 2]\n\n<b>📊 Metrics</b>\n• [Milestone or growth number]\n• [Community stat, e.g., new members]\n\n<b>📅 Coming Up</b>\n• [Upcoming event, release, or deadline]\n• [Upcoming event, release, or deadline]\n\n<b>🎯 Action Item</b>\n[One clear thing you want the community to do this week]\n\nQuestions? Drop them below 👇"
}'
Template 4: Product Launch with Image
# First, send the image with caption
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPhoto" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"photo": "https://example.com/launch-banner.jpg",
"caption": "🎉 <b>[Product Name] is LIVE!</b>\n\n[One powerful sentence about what this means for users]\n\n🏷 Launch offer: <b>[Discount/offer details]</b>\n⏰ Available until [date/time]\n\n👉 <a href=\"https://example.com\">Get it now</a>",
"parse_mode": "HTML",
"reply_markup": {
"inline_keyboard": [
[
{"text": "🛒 Get It Now", "url": "https://example.com/buy"},
{"text": "🎥 Watch Demo", "url": "https://example.com/demo"}
],
[
{"text": "💬 Join Discussion", "url": "https://t.me/community_group"}
]
]
}
}'
Template 5: Engagement Poll
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPoll" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"question": "What should we focus on next? 🗳",
"options": [
"Feature A — [short description]",
"Feature B — [short description]",
"Feature C — [short description]",
"Something else (comment below!)"
],
"is_anonymous": false,
"allows_multiple_answers": false
}'
Template 6: Knowledge Quiz
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendPoll" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"question": "[Interesting question related to your niche]?",
"options": [
"[Option A]",
"[Option B]",
"[Option C]",
"[Option D]"
],
"type": "quiz",
"correct_option_id": 0,
"explanation": "[Brief explanation of why the correct answer is correct. Include a fun fact or link to learn more.]",
"explanation_parse_mode": "HTML",
"is_anonymous": false
}'
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/setChatDescription" \
-H "Content-Type: application/json" \
-d '{
"chat_id": "'"${TELEGRAM_CHAT_ID}"'",
"description": "Your channel description here (up to 255 characters)"
}'
Rate Limits and Best Practices
Telegram API Rate Limits
Messages to the same chat: ~30 messages per second (but keep well below this).
Messages to different chats: ~30 messages per second total.
Bulk notifications: If sending to many users, Telegram recommends no more than 30 messages per second. Add sleep 1 between sends when broadcasting.
File uploads: 50 MB max per file for documents, 10 MB for photos.
Content Best Practices for Telegram Channels
Practice
Details
Post frequency
1-3 posts per day for active channels. More than 5 risks mute/unsubscribe.
Best times
9-11 AM and 6-8 PM in your audience's primary timezone.
Message length
Keep under 1,000 characters for feed posts. Long-form is fine for articles.
Media
Posts with images get 2-3x more engagement than text-only.
Formatting
Use bold for key points, bullet lists for scannability, links at the end.
Engagement
Ask questions. Use polls weekly. Reply to comments promptly.
Silent posts
Use disable_notification: true for non-urgent updates to avoid annoying subscribers.
Pin messages
Pin important announcements. Unpin old ones to keep the pinned area relevant.
Link previews
Telegram auto-generates link previews. To disable, set disable_web_page_preview: true.
Publishing Workflow
When the user asks to post content to Telegram:
Check credentials - Verify TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are set.
Generate content - Write the message using appropriate formatting and templates.
Preview - Show the user the exact message that will be sent, including:
Message text with formatting
Any inline keyboard buttons
Media attachments (URL or file path)
Target chat ID
Confirm - Ask the user to approve before sending.
Send - Execute the API call.
Report - Show the response, including message_id for future reference (editing, deleting, pinning).
Never auto-post without explicit user confirmation.
Gathering Requirements
Before composing a Telegram message, collect these inputs:
Message type - Text, photo, document, poll, or quiz.
Content - What is the message about? Provide copy or topic for generation.
Target - Which channel or group? Use TELEGRAM_CHAT_ID or ask for a specific one.
Formatting - HTML or MarkdownV2. Default to HTML.
Buttons - Any CTA buttons needed? Label and URL for each.
Media - Any image or file to attach? URL or local file path.
Timing - Send now, schedule for later, or recurring?
Notification - Silent (no notification) or normal?
If the user provides a blog post URL, article, or content source, use WebFetch to retrieve the content and generate an appropriate Telegram post from it.
Error Handling
Common Telegram Bot API errors and how to resolve them:
Error
Cause
Fix
401 Unauthorized
Invalid bot token
Regenerate token via @BotFather
400 Bad Request: chat not found
Wrong chat ID or bot not in chat
Verify chat ID; add bot to channel as admin
403 Forbidden: bot is not a member
Bot was removed from the channel
Re-add the bot as a channel admin
403 Forbidden: bot can't send messages
Bot lacks posting permissions
Grant the bot "Post Messages" admin right
429 Too Many Requests
Rate limit exceeded
Wait the retry_after seconds specified in the response
400 Bad Request: can't parse entities
Malformed HTML/Markdown
Check formatting; escape special characters; switch to HTML mode
Always check the ok field in the API response. If ok is false, display the description field to the user with guidance on how to fix the issue.
