🏗️Guide: How to Deploy Your Telegram AI Agent

Guide: Deploying Your Telegram AI Agent

Welcome to the Telegram AI Agent setup guide. The goal here is to create an official "bot" identity on Telegram that AICORA can use to power your AI-driven community moderator.

Compared to Discord, the Telegram process is refreshingly simple. You'll be talking to a special bot called "BotFather" to get everything done. Let's begin.

Step 1: Meet the BotFather

All official Telegram bots are born through a conversation with the one and only BotFather.

  1. Find BotFather: Open your Telegram app (desktop or mobile) and in the search bar, type @BotFather. Look for the official account with the blue verified checkmark.

  1. Alternative Method: If you're on a computer, you can also use this direct link in your browser: https://telegram.me/BotFather. Clicking "SEND MESSAGE" on that page will open the chat directly in your Telegram app.

  1. Start the Conversation: Open a chat with BotFather and click the Start button or type and send the command: /start

Step 2: Create Your New Bot

Now, we'll give the command to create a new bot.

  1. In the chat with BotFather, type and send the command: /newbot

  1. Choose a Display Name: BotFather will ask for a name. This is the friendly, human-readable name that users will see. For example: AICORA AI Mod. Send your desired name.

  1. Choose a Unique Username: Next, BotFather will ask for a username. This is the bot's unique ID on Telegram.

Username Rules: It must be globally unique.

It must be between 5 and 32 characters long.

It can only contain letters (a-z), numbers (0-9), and underscores (_).

Most importantly: It must end in bot (e.g., MyProject_AI_bot). This is not optional.

  • If the username is taken, BotFather will tell you. Just try a different one.

Step 3: Secure Your Token (The Final Prize)

Once you provide a valid, unique username, BotFather will congratulate you and, most importantly, give you your API Token.

  1. Look for the message that starts with "Done! Congratulations on your new bot."

  2. In that message, find the section that says "Use this token to access the HTTP API:".

  3. The long string of numbers and letters right below it is your token. Copy this entire token.

🔒 Security First: This token is the master key to your bot. Treat it like a password and never, ever share it publicly.

Step 4: Customizing Your Bot (Recommended)

A bot with a profile picture and description looks far more professional. BotFather makes this easy. You can send these commands to him at any time:

  • /setuserpic - To upload a profile picture for your bot.

  • /setdescription - To set the short description people see before they start a chat.

  • /setabouttext - To set the more detailed "About" text on your bot's profile page.

Don't be afraid to experiment! BotFather will guide you through each step. A complete profile builds trust with your community.

Step 5: Invite Your Bot to Your Group

Your bot now exists, but it needs to be a member of your group to read messages and help users.

  1. Go to your target Telegram group.

  2. Click on the group's name at the top to open its profile/info page.

  3. Click on the Add Members option.

  1. In the search bar that appears, paste your bot's unique username (the one ending in _bot that you created in Step 2).

  1. Select your bot from the search results and confirm to add it to the group.

💡 Pro-Tip: For the AI Agent to function correctly, it's best to make your bot an administrator in the group. This ensures it has all the necessary permissions to see and reply to messages. You can do this in your group's "Manage Group" > "Administrators" settings.

Step 6: Launching from AICORA

The final step. Let's bring your bot to life.

  1. Open the AICORA application and go to the AI AGENT tab.

  2. Select the TELEGRAM sub-tab.

  3. Telegram Bot Token: Paste the secret token you copied from BotFather.

  4. Your Project Name: Enter your project's name. As the code shows, this name is sent to our AI backend to provide better context for answering questions.

  1. Click the purple RUN BOT button.

The Running Logs will confirm that the bot has connected successfully. It is now live in your group!

How it works:

The Telegram AI Agent is designed to be a helpful, non-intrusive presence. Based on its programming, it will not respond to every single message. Instead, it will intelligently activate when it detects a user's message is highly relevant to the information stored in your KNOWLEDGE tab.

It uses a smart filtering system to determine when to engage, ensuring it only joins conversations where it can add real value.

PreviousGuide: How to Deploy Your Discord AI AgentNextAutochat Engine: The Vibe Machine

Last updated