Telegram Setup — bot + channel

Telegram integration works through a bot you create and add to your channel as admin. Full setup takes about 5 minutes.

Step 1 — Create a bot with BotFather

1. Open Telegram, find @BotFather
2. Send /newbot
3. Pick a display name (e.g., "Khazri Publisher")
4. Pick a username (must end with _bot, e.g., khazri_publisher_bot)
5. BotFather sends you a token — a long string like 1234567890:AA...

Step 2 — Add the bot to your channel as admin

1. Open your Telegram channel (the one you want to post to)
2. Channel settings → Administrators → Add Administrator
3. Search for your bot's username, select it
4. Grant permissions: Post Messages, Edit Messages, Delete Messages (minimum)
5. Optionally: Pin Messages if you want the bot to pin

Without admin + Post Messages, the bot can't publish.

Step 3 — Connect in Limaze

1. Open the desktop app → Integrations page
2. Find the Telegram card → Connect
3. Paste the bot token from BotFather
4. Paste the target — either @channel_username or the numeric chat id (Limaze accepts both)
5. Limaze validates: bot token OK, bot is admin in the target, target exists. Green check on success.

Step 4 — Set the control chat (optional but recommended)

The "control chat" is where Nexus sends approval buttons. Typically a private chat between you and the bot:

1. Open a DM with your bot
2. Send /start
3. Limaze auto-detects the chat as your control chat on the next message

Now approvals can be tapped from your phone via the bot — no need to open the desktop app.

Step 5 — Equip a lim with the Telegram Expert skill

1. Vault → Skills → Telegram Expert
2. Assign to the lim who should handle Telegram (usually Marcus or a similar publisher role)
3. The lim now sees publish_telegram_message in their tool kit and the Telegram channel card appears on their profile

Publishing flow

1. You ask Nexus to post something (in chat or via routine)
2. Nexus delegates to the Telegram-expert lim
3. Lim drafts the message in your studio voice
4. Approval request lands in the control chat (and desktop) with ✅ / ❌
5. You tap ✅ → bot posts to the target channel → Limaze records the message id for analytics

Approval bypass for auto-publish mode

Toggle the Telegram integration card from Approval required to Auto-publish. The lim will post directly without waiting. Recommended only for mature studios where voice is dialed in.

Troubleshooting

• "Bot is not a member of chat" — you haven't added the bot as admin, or used the wrong target
• "Chat not found" — the target is wrong. Try @channel_username first; if that fails use the numeric id from @getidsbot
• Control chat not auto-detecting — manually paste the chat id in Integrations settings