Deploy Your AI Agent to Telegram
Hey there,
Your Second Brain OS agent is configured and your tools are live. Now let’s put it on Telegram. By the end of this guide, your customers will be able to message a Telegram bot and interact with your AI agent — check availability, book appointments, ask questions, or whatever your agent is set up to do.
This is one of the fastest channel deployments. If you’ve ever created a Telegram bot before, the first part will be familiar. If you haven’t, don’t worry — it takes about 2 minutes.
What You’ll Need
- A Telegram account (personal or business — either works)
- Your Second Brain OS account (setup completed from the main guide)
Step 1: Create Your Bot with BotFather
BotFather is Telegram’s official tool for creating bots. It’s a bot itself — you chat with it inside Telegram.
- Open Telegram and search for @BotFather (or go to t.me/BotFather)
- Start a conversation and send
/newbot - BotFather will ask you for:
- A display name for your bot (e.g. “Acme Booking Assistant” or “Sarah – AI Receptionist”). This is what customers see at the top of the chat
- A username for your bot (must end in
bot, e.g.acme_booking_bot). This is the unique handle people use to find it
- BotFather will respond with your bot token — a long string that looks like
7482918374:AAH3kf8sjd_Kd93jfKsdj3. Copy this token
If you’re a business owner: Think of BotFather as the Telegram equivalent of registering a business phone number. You’re creating an identity that customers can message — the bot token is like the SIM card that connects it to your AI agent.
If you’ve used Zapier or n8n: This is identical to the “Create a Telegram Bot” step you’d do in any integration. The token is the API credential that SBOS uses to send and receive messages on your bot’s behalf.
Step 2: Connect Your Bot to Second Brain OS
- Go to secondbrainos.com/telegram-integration
- Paste your bot token in the field
- Click “Install Telegram Integration”
That’s it. Your Telegram bot is now connected to your Second Brain OS agent. Every message sent to your bot is handled by your AI agent, with full access to all your public tools, knowledge, and skills.
Step 3: Test Your Bot
- Open Telegram and search for your bot by its username (e.g.
@acme_booking_bot) - Start a conversation and send a message — try something your agent is designed to handle:
- “What times are available tomorrow?”
- “I’d like to book an appointment”
- “Tell me about your services”
- Your AI agent should respond using the same system prompt, tools, and knowledge you configured in your SBOS profile
Step 4: Share Your Bot
Once you’re happy with how it’s working, share your bot with customers:
- Direct link:
https://t.me/your_bot_username— customers tap this and land directly in the chat - QR code: Generate a QR code from the link above and add it to your business card, storefront, or marketing materials
- Telegram group: Add your bot to a Telegram group where it can respond to messages from multiple people (useful for community-based businesses)
If you’re a business owner: This is like putting your phone number on your website, your business card, and your Google listing — except instead of a phone that rings, it’s an AI that responds instantly, 24/7.
How It Works Under the Hood
- A customer messages your Telegram bot
- Telegram forwards the message to Second Brain OS via webhook
- SBOS processes the message using your system prompt and LLM
- When the AI needs to take an action (book, reschedule, search, etc.), it calls your tools server-side
- The response is sent back to the customer through Telegram
Your tools, knowledge, and skills are the same ones powering your website chat and voice agent. Telegram is just another window into the same AI.
Customising Your Bot
Bot profile:
- Send
/mybotsto BotFather, select your bot, and click Edit Bot - You can update the display name, description, about text, and profile picture
- Add a description that tells customers what your bot can do (e.g. “Book appointments, check availability, and ask questions — powered by AI”)
Bot commands (optional):
- Send
/setcommandsto BotFather to add menu commands like/book,/availability,/cancel - These appear as quick-action buttons in the Telegram chat — but they’re not required. Your AI agent handles free-form messages naturally, so customers can just type what they want
If you’re a business owner: Customising the bot profile is like setting up your Google Business listing — name, photo, description. It takes 2 minutes and makes a big difference in first impressions.
Troubleshooting
| Issue | Fix |
|---|---|
| Bot doesn’t respond | Verify the token was pasted correctly at secondbrainos.com/telegram-integration. Try reinstalling the integration |
| Responses are slow | Check that your LLM model is set correctly in your SBOS AI Agent Settings. Some models are faster than others |
| Tools not working | Make sure the relevant tools are set to public and active in My Actions |
| Wrong personality/tone | Update your system prompt in Profile → AI Agent Settings — this controls how the agent behaves across all channels including Telegram |
Your AI agent is now live on Telegram. Customers can message your bot anytime, and the same agent that powers your website and voice handles the conversation.
Next up: check out the other channel deployment guides:
- Website chat widget (ChatKit)
- Voice AI (ElevenLabs)
- ChatGPT Custom GPT
- Claude Desktop & Claude Code
- CLI & Agent URL
