What you need before you start

A Telegram account and the Telegram app (phone or desktop).
A bot of your own, made with @BotFather. It is free and takes two minutes. One bot connects to one UniPostudio brand.
A channel where the bot is an admin allowed to post messages, or a group the bot is a member of.
The chat’s id: a number (a channel’s starts with -100) or the chat’s public @username.
A privacy policy link for the bot: Telegram’s Bot Developer Terms require every bot to have one.
The owner or admin role in the UniPostudio brand you are connecting, and a free channel slot on your plan.

Connect step by step

Step 1:
Create a bot: open @BotFather on Telegram and send /newbot.
Follow the prompts to name your bot. Its username must end in “bot”.
Step 2:
Copy the bot token.
BotFather replies with an HTTP API token, something like 1234567890:ABC…. Keep it private: anyone with it can post as your bot.
Step 3:
Add your privacy policy to the bot (required by Telegram).
In @BotFather send /mybots, choose your bot, open Bot Settings → Privacy Policy and add a link to your privacy policy.
Step 4:
Add the bot to your channel as an admin (or to your group).
In the channel’s settings, add the bot under Administrators and leave Post messages on. For a group, add it as a member.
Step 5:
Find the chat id.
Forward any message from the channel to @getidsbot: it replies with the id, which starts with -100 for a channel. A public channel’s @username works too.
Step 6:
In UniPostudio, open Channels and select Connect on the Telegram card.
The Connect Telegram dialog opens, with the same steps in short.
Step 7:
Paste the token and the chat id, and select Connect Telegram.
Fill Bot token and Default channel or chat id. The button says Verifying with Telegram… while UniPostudio checks that the token works and the bot can post in that chat. Then the card says Connected · healthy.

IllustrationThe Connect Telegram dialog: paste the Bot token and the Default channel or chat id, then Connect Telegram.

Once it is connected

Telegram appears in the composer’s channel list and posts go to that chat as your bot. Messages people send to the bot (and, in a group, messages the bot can see) arrive in the inbox.

To post to another chat later, disconnect Telegram and connect it again with the new chat id.

What we ask permission for, and why

Telegram has no permission screen: what UniPostudio can do comes from the bot token and the rights you give the bot in your chat.

Bot token: Lets UniPostudio act as your bot, and only your bot: post to the chats it belongs to and receive messages sent to it.
Admin right: Post messages: Needed in a channel, so the bot can publish there. No other admin right is needed.
Webhook: UniPostudio registers a webhook for the bot, so messages to it reach the inbox straight away. It is removed when you disconnect.

If something goes wrong

“Telegram rejected the bot token. Copy it again from @BotFather.”

The token was copied incompletely, or was replaced with /revoke in BotFather. Copy the current token from @BotFather (/mybots → your bot → API Token) and paste it again.

“The bot cannot see that chat.”

Add the bot to the channel (as an admin) or the group, and check the id: a channel’s id starts with -100.

“The bot cannot post there.”

In a channel the bot must be an admin with Post messages on. In a group it must be a member allowed to send messages. Fix it in Telegram, then connect again.

“Enter a numeric id such as -1001234567890, or a public @username.”

The id field takes only a number (with its minus sign) or an @username. Copy the id from @getidsbot exactly.

“This Telegram bot is already connected to another brand.”

A bot connects to one brand. Disconnect it there first, or create another bot with @BotFather for this brand.

In a group, the inbox only shows some messages

Bots in groups see only commands and mentions while their privacy mode is on. In @BotFather send /setprivacy, choose your bot and Disable, then remove the bot from the group and add it again.

Posts to a group were delayed or refused

Telegram limits bots to about 30 messages a second overall and about 20 a minute in one group. A burst of posts to one group can hit those limits; spread such posts a few minutes apart.

Connect is greyed out

The top of the screen says “Only owners and admins can connect, change or disconnect channels.” Ask an owner or admin of the brand.

What we never do

We never ask for, see or keep your password. You sign in on the platform’s own page (or paste a token the platform issued you), and the platform gives UniPostudio a token, not your password.
Every token is encrypted with AES-256-GCM before it is stored, and is never written to our logs.
We ask only for the permissions the features need, and use each one only for what this page says.
We never post or reply unless you or a teammate does, or an automation you turned on (scheduled posts, automatic AI replies) does.
Disconnecting deletes the stored token and what we synced from the account: its messages, comments, feed and analytics.

Disconnect or reconnect

Open the ⋯ menu on the Telegram card (More actions for Telegram), choose Disconnect and confirm. UniPostudio removes the bot’s webhook (when it is the one UniPostudio set), deletes the stored token, and deletes the messages synced through the bot.

The bot stays yours. To stop it completely, remove it from your channel or group, or send /revoke in @BotFather to cancel its token (reconnecting then needs the new token). To reconnect, select Connect on the card again.

Still stuck?

Write to us with the channel’s name and the exact words on the card or in the error message: that is usually enough for us to tell what happened. Never send us a password or a token.

support@codezyai.com Every way to reach us