Publishing API

Telegram publishing API with one SocialClaw workspace.

Telegram is connected manually with a bot token and a numeric chat id or @channel username, then stored in the SocialClaw workspace for later CLI or API use. SocialClaw supports Telegram text messages, text plus one image, or text plus one video through bot-connected targets.

Works with Claude, ChatGPT, OpenClaw ClaudeChatGPTOpenClaw

What SocialClaw supports for this workflow

A quick overview of what this workflow supports.

Account target Bot-connected channel, group, supergroup, or chat SocialClaw supports Telegram text messages, text plus one image, or text plus one video through bot-connected targets.
Auth model Manual connect Telegram is connected manually with a bot token and a numeric chat id or @channel username, then stored in the SocialClaw workspace for later CLI or API use.
Media envelope Telegram supports text-only posts or one image or one video per post. Telegram fetches the public image or video URL during publish.
Inspection Validate, apply, inspect Analytics snapshots are available, but Telegram provider-native analytics are not implemented. Telegram reconciliation is not implemented yet.

What the payload needs

The main fields and constraints to account for.

How the workflow runs

Connect the account, validate the post, then publish.

01

Authenticate the workspace

Use the workspace API key with the CLI or hosted HTTP API so the publishing workflow stays attached to the same customer workspace.

02

Connect Telegram

Telegram is connected manually with a bot token and a numeric chat id or @channel username, then stored in the SocialClaw workspace for later CLI or API use.

03

Inspect account capabilities and settings

Read the current settings surface, including parseMode, disableNotification, protectContent, disableLinkPreview, before generating the final payload.

04

Validate before apply

Validation should happen before create-run or apply. Telegram supports text-only posts or one image or one video per post.

05

Inspect the resulting run or post

Telegram reconciliation is not implemented yet. Analytics snapshots are available, but Telegram provider-native analytics are not implemented.

CLI and HTTP examples

Example commands and requests for this route.

socialclaw login --api-key <workspace-key> --base-url https://getsocialclaw.com
socialclaw accounts connect --provider telegram --bot-token <bot-token> --chat-id @yourchannel --json
socialclaw accounts capabilities --provider telegram --json
socialclaw validate -f schedule.json --json
socialclaw apply -f schedule.json --idempotency-key launch_1 --json
socialclaw runs inspect --run-id <run-id> --json

Current limitations

A few practical limits to keep in mind.

Related routes

Related integrations and use cases.

What builders are saying

Real quotes from Reddit, G2, Trustpilot, and Instagram.

Works with every major platform

Connect once, then schedule and publish everywhere from the same workspace.

Frequently Asked Questions

Telegram uses the Bot-connected channel, group, supergroup, or chat route in SocialClaw. Telegram is connected manually with a bot token and a numeric chat id or @channel username, then stored in the SocialClaw workspace for later CLI or API use.

Run the Telegram publishing API workflow in SocialClaw

Connect the account once, validate before publish, and keep everything in one workspace.

Supported social platforms
Schedule to social media Works with Claude ChatGPT Codex OpenClaw
Start free