Automate Telegram with Grok Bot
Send messages to channels and groups, share media, schedule posts with precise timing, and automate your Telegram presence — all from the command line or through your AI agent via the Bot API.
Please make sure there is always a human in the loop.
Post to Telegram in Seconds
Grok Bot
# In any Bot chat, add the Postiz plugin
/add-plugin postiz
# Store POSTIZ_API_KEY as a Bot secret when prompted.
# Your Bot can now run Postiz on its cloud computer:
# Find your Telegram integration
postiz integrations:list
# Send a message to your channel/group
postiz posts:create \
-c "Hello Telegram!" \
-s "2025-01-15T09:00:00Z" \
-i "telegram-id"Telegram-Specific Features
Channel Messaging
Post messages directly to your Telegram channels. Reach all subscribers with announcements, updates, and content.
Group Messaging
Send messages to Telegram groups. Keep your community engaged with scheduled posts and automated content delivery.
Bot-Powered
Powered by the Telegram Bot API via BotFather. Create a bot, add it to your channel or group, and start posting programmatically.
Media Sharing
Share images, videos, and documents alongside your messages. Upload media through Postiz and include it in your Telegram posts.
Scheduled Messages
Schedule messages for optimal delivery times with ISO timestamps. Plan your Telegram content calendar in advance.
Minimal Config
Telegram uses a streamlined setup — just your integration ID handles routing. No complex platform-specific settings required.
How It Works
Set Up Your Telegram Bot
Create a bot using BotFather on Telegram, then add it to your channel or group as an administrator. Connect it to Postiz through the dashboard to get your integration ID.
Bot Setup
# 1. Open Telegram and message @BotFather
# 2. Send /newbot and follow the prompts
# 3. Copy the bot token
# 4. Add the bot to your channel/group
# 5. Make it an admin (for channels)
# 6. Connect in Postiz dashboard
# Then find your integration
postiz integrations:list
# Filter for Telegram
postiz integrations:list | jq \
'.[] | select(.identifier=="telegram")'Send Your First Message
Post a message to your Telegram channel or group. The integration ID handles all the routing — no additional settings needed for basic text messages.
First Message
# Simple text message
postiz posts:create \
-c "Hello from Postiz! 🚀" \
-i "telegram-id"
# With media attachment
RESULT=$(postiz upload photo.jpg)
MEDIA_URL=$(echo "$RESULT" | jq -r '.path')
postiz posts:create \
-c "Check out this photo!" \
-m "$MEDIA_URL" \
-i "telegram-id"Schedule Messages
Schedule Telegram messages for future delivery using ISO timestamps. Perfect for content calendars, announcements, and automated updates.
Scheduling
# Schedule a message for tomorrow morning
postiz posts:create \
-c "Good morning! Here's your daily update." \
-s "2025-03-02T09:00:00Z" \
-i "telegram-id"
# Schedule with media
postiz posts:create \
-c "New product launch tomorrow!" \
-m "$MEDIA_URL" \
-s "2025-03-01T18:00:00Z" \
-i "telegram-id"Telegram Settings Reference
Telegram uses a minimal configuration. The integration ID handles channel and group routing. Use the --settings flag if you need to specify the platform type explicitly.
| Field | Type | Description |
|---|---|---|
__type | string | Must be "telegram" to identify the platform (if using settings) |
Telegram's simplicity is a feature — your bot token and channel/group association are configured once in the Postiz dashboard. After that, just use the integration ID to route messages.
Common Configurations
Copy-paste these commands for common Telegram posting scenarios.
Simple Channel Announcement
Terminal
postiz posts:create \
-c "📢 Big news! We just hit 10k subscribers. Thank you all!" \
-i "telegram-id"Scheduled Morning Update
Terminal
postiz posts:create \
-c "Good morning! Here's your daily market briefing..." \
-s "2025-03-02T07:00:00Z" \
-i "telegram-id"Media Post with Caption
Terminal
# Upload the image first
RESULT=$(postiz upload announcement.jpg)
MEDIA_URL=$(echo "$RESULT" | jq -r '.path')
# Post with media
postiz posts:create \
-c "Check out our new product design!" \
-m "$MEDIA_URL" \
-s "2025-03-01T12:00:00Z" \
-i "telegram-id"Multi-Channel Broadcast
Terminal
# Post to multiple Telegram channels at once
postiz posts:create \
-c "New blog post: How to automate your workflow" \
-s "2025-03-01T15:00:00Z" \
-i "telegram-channel-1,telegram-channel-2"What is Grok Bot?
Grok Bot is the always-on AI teammate product from xAI and Cursor. You create named Bots, give each one a job, and they work 24/7 on their own persistent cloud computer — with a browser, a filesystem, and a terminal — pinging you only when they need approval.
Grok Bot is not the Grok chatbot. Grok is the assistant you chat with on X and grok.com. Grok Bot is a separate app for delegating real, multi-step work — like running your Telegram presence with Postiz.
Own Cloud Computer
Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so your Telegram posts go out even when your laptop is closed.
Routines
Turn any task into a routine that runs on a schedule. Your Bot drafts, schedules, and reports on Telegram content without being asked twice.
Approvals Built In
Bots ask before changing external systems. Review the Telegram posts your Bot prepared in Postiz, approve, and it publishes.
How Postiz Works with Grok Bot
Postiz is listed on the Grok Bot plugin marketplace. Add it to a Bot and the Postiz skill, CLI, and command reference are installed on its cloud computer — the Bot can then manage your Telegram workflow on its own.
- ✓Type /add-plugin postiz in a Bot chat, or add it from the Plugins sidebar
- ✓Store your POSTIZ_API_KEY as a Bot secret when prompted
- ✓The Bot reads the bundled SKILL.md and learns every Postiz command
- ✓Works in every Bot on your shared workspace, on desktop and iPhone
- ✓Approvals keep a human in the loop before anything is published
Grok Bot
# 1. Add the plugin to your Bot
/add-plugin postiz
# 2. Store your Postiz API key
# as a secret when prompted
# 3. Ask your Bot to verify
You: Find my Telegram channel in Postiz
Bot: Running postiz integrations:list
Found your Telegram integration.
All Postiz commands are ready.Telegram Posting with Grok Bot
Your Bot reads the Postiz skill, discovers your Telegram integration, and handles the entire posting workflow — from content creation to scheduling — on its own cloud computer.
Message Your Bot
Desktop, iPhone, or a group chat
Send a message to your Bot from the desktop app or your iPhone. It runs on its own cloud computer, so it picks up your message, discovers your Telegram account via Postiz, uploads your media, and schedules the post — then asks you to approve before it goes live.
Grok Bot
You: Post "New episode is live!" to
my Telegram channel, schedule for 3pm
Bot: Got it! Here's the plan:
1. Find your Telegram integration
2. Schedule for 2025-03-01T15:00:00Z
3. Post message to your channel
Done! Your Telegram message is scheduled.
Post ID: abc-123Routines
Recurring work on a schedule
Save the task as a routine. Your Bot runs it on a schedule from the cloud, checks for new content, and posts it to Telegram automatically — no manual trigger needed.
Grok Bot routine
Routine: daily-telegram-posts
Schedule: Weekdays at 9:00 AM
Instructions:
Check ~/content/posts on your cloud
computer for new .txt files. For
each one, read the content and
schedule a post to Telegram for
today at noon via Postiz. Move
posted files to ~/content/published
and send me a summary.Why Grok Bot + Postiz for Telegram
Grok Bot makes Postiz a natural fit for your Telegram workflow. The Bot reads the plugin's skill, chains the right commands together, and keeps running from the cloud.
- ✓Official plugin — one command install from the marketplace
- ✓Always on — posts to Telegram from the cloud while you are away
- ✓Terminal access runs Postiz commands directly on the Bot's computer
- ✓Routines for hands-free daily posting
- ✓Cross-post to Telegram + other platforms in a single conversation
- ✓Approvals keep a human in the loop before publishing
SKILL.md (bundled in the plugin)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Telegram
metadata:
grok-bot:
plugin: postiz
secrets:
- POSTIZ_API_KEY
binaries:
- postiz
---
# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>
# Telegram
# Minimal settings — integration ID
# handles channel/group routing.
# Bot setup via BotFather.Also Works with Claude Code
Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.
Claude Code
by Anthropic
Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Telegram integration, composes your message, uploads any media if needed, and sends it to your channel or group.
Claude Code
> Send an announcement to my Telegram
channel about our new feature launch,
include the screenshot, schedule for 3pm
Claude will automatically run:
postiz integrations:list
postiz upload ./screenshot.png
postiz posts:create \
-c "🚀 New feature launch!
Check out our latest update..." \
-m "uploaded-url" \
-s "2025-03-01T15:00:00Z" \
-i "telegram-id"Telegram + Other Platforms
Send a Telegram message and post to social media simultaneously. Each platform gets its own settings.
Terminal
# Post to Telegram and social media simultaneously
postiz posts:create \
-c "New blog post: How to automate your workflow" \
-s "2025-03-01T09:00:00Z" \
-i "telegram-id,twitter-id,linkedin-id"
# Batch schedule a week of daily Telegram updates
for day in 1 2 3 4 5; do
postiz posts:create \
-c "Day $day tip: Stay productive!" \
-s "2025-03-0${day}T08:00:00Z" \
-i "telegram-id"
doneStart posting to Telegram
Install Postiz Agent and automate your Telegram channel messaging with AI-powered scheduling and delivery.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Open-source social media scheduling tool
Tools
