Automate Telegram with Paperclip
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 Paperclip?
Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.
Agent Teams
Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.
Single Dashboard
Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.
Orchestration
Schedule recurring tasks with cron jobs. Paperclip can post to your Telegram channels on a schedule without you having to ask each time.
How Postiz Works with Paperclip
When you install Postiz Agent globally, Paperclip automatically discovers it by reading the bundled SKILL.md file. This file tells Paperclip what commands are available, what environment variables are needed, and how to send Telegram messages with the right integration.
- ✓Install Postiz Agent and set your POSTIZ_API_KEY
- ✓Paperclip discovers Postiz through tool integration
- ✓Assign Postiz commands to specialized agents in your team
- ✓Orchestrate multi-step workflows with approval chains
- ✓Monitor everything from the Paperclip dashboard
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent
# Set your API key
export POSTIZ_API_KEY=your_api_key
# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teamsTelegram Posting with Paperclip
Message Paperclip from any platform — it reads the Postiz skill, discovers your Telegram integration, and handles the entire messaging workflow autonomously.
From Any Chat App
Paperclip assigns specialized agents to ...
Send a message to Paperclip from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Telegram channel via Postiz, and sends the message — all while you go about your day.
WhatsApp / Slack
You: Post "New episode is live!" to
my Telegram channel, schedule for 3pm
Paperclip: Got it! Here's what I'll do:
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-123Scheduled & Proactive
Cron jobs for recurring channel content
Paperclip supports cron-based heartbeat tasks. Set up a recurring job that sends daily updates to your Telegram channel automatically — no manual trigger needed.
paperclip.yaml (pipeline)
pipelines:
daily_social:
schedule: "0 9 * * 1-5"
agents:
- role: content_creator
task: "Draft a Telegram post
about trending industry topics"
- role: reviewer
task: "Review and polish the
draft for engagement"
- role: publisher
task: "Schedule via Postiz
for today at noon"Why Paperclip + Postiz for Telegram
Paperclip makes Postiz a natural fit for your Telegram workflow. The agent discovers all available commands and autonomously chains them together.
- ✓Multi-agent teams for quality Telegram content — draft, review, publish
- ✓Single dashboard to monitor all social media automation
- ✓Orchestrated pipelines from content creation to publishing
- ✓Scheduled pipelines for hands-free daily posting
- ✓Cross-post to Telegram + other platforms in a single pipeline
- ✓Open-source — fully customizable agent workflows
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Telegram
metadata:
paperclip:
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
