Automate Telegram with Codex
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
Terminal
# Install the skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# 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 Codex?
Codex is OpenAI's autonomous coding agent that handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase. It works via CLI and IDE integrations, and can execute shell commands like Postiz.
CLI & IDE Native
Codex runs from your terminal or IDE. It executes shell commands directly, making Postiz integration seamless — no extra configuration needed.
Autonomous Execution
Codex works in sandboxed cloud environments, autonomously running commands, reading output, and chaining multi-step workflows like social media posting.
Parallel Tasks
Run multiple Codex tasks simultaneously. Schedule posts to different platforms in parallel while Codex handles other coding work.
How Postiz Works with Codex
Codex discovers Postiz when you install it globally. It reads the SKILL.md to understand available commands and can autonomously chain them for social media workflows.
- ✓Install Postiz Agent globally with npx skills add
- ✓Codex reads the SKILL.md and learns all Postiz commands
- ✓POSTIZ_API_KEY must be set in environment
- ✓Codex executes commands in sandboxed environments
- ✓Works alongside your coding tasks in parallel
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# Codex discovers Postiz commands
# from the SKILL.md automatically
codex "list my social media integrations"Telegram Posting with Codex
Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
CLI Workflow
Terminal and IDE integration
Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
Codex CLI
$ codex "Post to Telegram about our
new feature launch, schedule for
tomorrow at 9am"
Codex: I'll handle that.
Running: postiz integrations:list
Found your Telegram integration.
Running: postiz posts:create ...
Done! Your post is scheduled.
Post ID: abc-123Parallel Tasks
Multiple tasks at once
Codex can handle multiple tasks in parallel. Schedule posts to different platforms while it works on other coding tasks simultaneously.
Codex Parallel Tasks
# Run multiple posting tasks in parallel
$ codex "Schedule a post about our
launch to X for tomorrow 9am" &
$ codex "Write a LinkedIn article
about our new feature and schedule
for tomorrow noon" &
$ codex "Fix the bug in auth.ts"
# All three tasks run simultaneouslyWhy Codex + Postiz for Telegram
Codex's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Telegram messaging workflows.
- ✓CLI-native — runs from your terminal or IDE
- ✓Autonomous execution in sandboxed environments
- ✓Parallel task support — post while coding
- ✓Reads SKILL.md for automatic command discovery
- ✓Cross-post to Telegram + other platforms in a single session
- ✓Powered by OpenAI's most capable models
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Telegram
metadata:
codex:
requirements:
env:
- 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
