Skip to content
SocialHelper
Get API key

Post to Telegram from one API.

Publish to Telegram from your app with one REST call, or let your AI agent do it over MCP. SocialHelper checks every post against Telegram’s limits before it goes out.

Live Connects with credentials Receives posts

What you can post

Telegram limits.

These are the limits the API enforces for Telegram, read straight from the code. Every post is checked against them before anything is sent.

With images attached, the text becomes a caption, which Telegram limits to 1,024 characters.
Text
4,096 UTF-16 units (most emoji count twice)
Images
Up to 10 per post · JPEG, PNG, WEBP · 9.5 MB each
Video
Not supported

Post with one request

Your first Telegram post.

Send the text and the account ID. Add an Idempotency-Key so a retried request never posts twice. The response lists each account with its own status and, once it’s live, the post’s URL.

curl https://socialhelper.app/api/v1/posts \
  -H "Authorization: Bearer $SOCIALHELPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
      "text": "We just shipped dark mode. Try it tonight 🌙",
      "accounts": [
          "ACCOUNT_ID"
      ]
  }'

Connect

Connect Telegram once.

Open Accounts in the SocialHelper dashboard and choose Telegram. The connect form asks for the details below, and explains where to find each one.

Bot token
Create a bot with @BotFather and paste the token it gives you. Then add the bot to your channel as an administrator allowed to post messages.
Channel or group
The public @username, or the numeric chat id of a private channel or group, such as -1001234567890.

SocialHelper calls Telegram’s official API for you. Telegram API reference ↗

FAQ

Telegram questions.

How long can a Telegram post be?

4,096, counted the way Telegram counts it. SocialHelper checks the length before posting, and if it doesn’t fit nothing is sent.

Can I post images or video to Telegram?

Up to 10 images per post. Video isn’t supported.

Do I need my own Telegram developer app?

No. You paste these from your own Telegram account into the connect form: bot token, channel or group.

Can my AI agent use Telegram?

Yes. Connect the SocialHelper MCP server at https://socialhelper.app/mcp and your agent can post to Telegram, after confirming the text with you.

How much does it cost?

SocialHelper is free during early access, Telegram included.

Ship your Telegram integration today.

Create a free account, connect an account and send your first post in a few minutes.