Connect Telegram (channel or group)

Telegram does not use OAuth. You connect by creating a bot via BotFather and pasting the bot token into Unison. The bot becomes a member of your channel or group and posts on your behalf.

1. 1

   In Telegram, message @BotFather and send /newbot. Pick a display name and a username (must end in bot).

2. 2

   BotFather replies with a bot token that looks like 123456789:ABCdefGhIJKlmNoPQRstuVWxyZ-12345. Copy it.

3. 3

   Add the bot to your channel or group as an administrator. For channels, grant Post messages permission. For groups, grant Send messages.

4. 4

   In Unison open Settings → Channels → Add channel → Telegram. Paste the bot token, give the channel a label, and click Connect.

5. 5

   Unison verifies the token, lists every channel and group the bot is in, and lets you pick which one this channel record will publish to.

What you can publish

• Text posts up to 4,096 characters
• Markdown and HTML formatting
• Images, videos, documents (any size up to Telegram's bot upload limit)
• Pin on publish, with optional auto-unpin window
• Schedule into a specific channel or group selected per draft

Removing access

Disconnect inside Unison to delete the bot token from our database. To disable the bot at Telegram, message @BotFather → /token and revoke or regenerate the token.

Common errors

• Forbidden: bot was kicked from the chat means the bot was removed from the channel or group. Re-add it as an admin and reconnect.
• Bad Request: chat not found usually means the channel ID stored on the channel record has changed (eg the channel was made private). Re-pick the target chat in Settings.