Connect a Telegram bot
Create a Telegram bot with BotFather, paste its token and answer everyone who messages the bot from the inbox.
For owners and admins
On this page
Telegram is free and takes about two minutes to set up. You create a bot in Telegram, paste its token into Luminobot, and everyone who messages your bot appears in the inbox. You reply from there and your answer arrives in Telegram as a message from the bot.
Before you start
- You need permission to manage connected accounts and to use chat channels (workspace owners and managers have both), or be an organization owner or admin.
- The bot uses one account slot of your plan.
- Use a bot just for Luminobot. Connecting points the bot's incoming messages here, so another tool that uses the same bot stops receiving them.
1. Create your bot
- In Telegram, open @BotFather and send
/newbot. - Choose a name and a username for your bot.
- BotFather replies with a token that looks like
123456789:ABC-DEF…. Copy it.
Treat the token like a password: anyone who has it can control the bot.
2. Connect it
- Open Connect a channel and click Connect on the Telegram tile. You land on Connect a messaging channel with Telegram bot selected.
- Paste the token into Bot token.
- Click Connect bot.
You see "Telegram bot connected." and the bot is listed on the Chat channels page.
3. Let customers find it
Customers start the conversation: a bot can't message someone first. Share your bot's link, https://t.me/<your bot's username>, on your website, in your emails or on social media. Each person who writes to it becomes a conversation in the inbox.
How messages arrive
Open the channel from Chat channels in the sidebar. Receives messages via shows one of:
- Webhook (instant): messages arrive at once.
- Polling (checked every minute): Luminobot fetches new messages about once a minute.
Which one is used depends on how your Luminobot account is set up; you don't need to choose.
What you can do
- Reply to messages from the inbox, including with images.
- Photos and files customers send are saved with the conversation.
- There is no 24-hour reply window: you can answer at any time.
- Send to your Telegram contacts with Broadcasts and Drip Campaigns.
- Let an AI Employee or a workflow answer for you.
Telegram doesn't let apps read old chats, so only messages sent after you connect appear in the inbox.
The same bot in several workspaces
You can connect one bot in more than one workspace. New messages then appear in each workspace's inbox, and disconnecting it in one workspace keeps it working in the others.
Disconnecting
On the Chat channels page, click Disconnect on the bot. Its history stays in the inbox and it no longer counts toward your plan. To use the bot again, connect it with the same token.
Troubleshooting
"A Telegram bot token is required." Paste the token before clicking Connect bot.
"Could not connect: …" Telegram didn't accept the token. Copy it again from @BotFather, with no spaces before or after it. If you generated a new token in BotFather, the old one no longer works.
Messages stopped arriving. Check the channel on the Chat channels page. If it shows Error, read the message under it. If you used the bot in another tool meanwhile, connect it here again with the token: that points the bot back to Luminobot.