Schedule content

Schedule Telegram bot posts from one workspace-stored bot target.

SocialClaw supports Telegram bot posting into channels, groups, supergroups, and direct chats through one workspace-stored bot target, with text-only or one-image or one-video messages.

Try the CLI Open dashboard

Account type Telegram bot-connected channel, group, supergroup, or chat Text-only, text plus one image, or text plus one video

Best fit AI agents Telegram does not use OAuth in SocialClaw.

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target Bot token plus chat target Telegram is connected manually with a bot token and chat_id or @channelusername.

Media rule Text-only or one asset The current route supports text-only posts or text plus one image or one video.

Settings parseMode and delivery toggles Inspect parseMode, disableNotification, protectContent, and disableLinkPreview before apply.

Inspection Capabilities and validation Use capabilities before scheduling so the workflow confirms the connected Telegram target is publishable.

What the payload needs

The main fields and constraints to account for.

telegram:@username or telegram:chat:<id> target in the workspace
Message text with zero or one image or video asset
Optional parseMode, disableNotification, protectContent, and disableLinkPreview settings
Validation before apply

How the workflow runs

Connect the account, validate the post, then publish.

Step 1

Store the Telegram target in the workspace

Connect Telegram manually with the bot token and chat id or @channelusername so later runs reuse the stored target.

Step 2

Prepare message text and one optional asset

The current route supports text-only messages or message text plus one image or one video.

Step 3

Validate the publish shape

Validation confirms the bot target, the current settings envelope, and the one-asset limit before apply.

Step 4

Apply and inspect the run

Create the scheduled Telegram post and inspect the resulting post or run after publish.

CLI and HTTP examples

Example commands and requests for this route.

CLI flow Schedule posts on Telegram

socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
socialclaw validate -f telegram-schedule.json --json
socialclaw apply -f telegram-schedule.json --idempotency-key telegram_ops_1 --json
socialclaw runs inspect --run-id <run-id> --json

HTTP API flow Hosted SocialClaw endpoints

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"telegram","botToken":"<bot-token>","chatId":"@yourchannel"}' \
  "https://getsocialclaw.com/v1/connections/start"

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d @telegram-schedule.json \
  "https://getsocialclaw.com/v1/posts/validate"