Setup · 3 min read

How to Connect a Telegram Bot to Your AI Agent

Step-by-step guide: create a Telegram bot via BotFather and connect it to your Auralix AI agent — no code needed, done in 5 minutes.

How to Connect a Telegram Bot to Your AI Agent

Table of contents

What You'll Need

  • An Auralix account with an active project
  • A Telegram account
  • 5–10 minutes

Step 1: Create a Bot via BotFather

Open Telegram and find @BotFather — the official bot creation service.

  1. Send the command /newbot
  2. Enter a display name for your bot, e.g. Company Support
  3. Enter a username (Latin letters, digits, and _, must end in bot), e.g. mycompany_support_bot
  4. BotFather will send you a token like 1234567890:AABBccDDee... — copy it

The token is your bot's password. Never share it publicly.

Step 2: Connect the Bot in Auralix

  1. Log in to Auralix and open your project
  2. Go to Channels → Telegram
  3. Paste the token into the Bot Token field
  4. Click Save

Auralix verifies the token and activates the channel — the status will change to "Connected."

Step 3: Test the Bot

Open Telegram, find your bot by username, and send any message. The AI agent will reply within 1–2 seconds using data from your knowledge base.

Bot not responding? Check that:

  • Your project has an active knowledge base
  • The agent is enabled under Project → Agent

Step 4: Set a Welcome Message (Optional)

Under Channels → Telegram, you can set the message your bot sends when a user types /start — the first touchpoint for every new user.

Example:

Hi! I'm the AI assistant for [Company Name]. Ask me anything — I'll answer instantly, 24/7.

A good welcome message sets context and reduces off-topic questions.

Common Mistakes

ProblemSolution
Token not acceptedRecopy it from BotFather — no leading or trailing spaces
Bot not respondingCheck that the agent is active and the knowledge base is loaded
One token, two projectsNot possible — each project needs its own bot
Bot giving off-topic answersRefine the agent's instructions in project settings

FAQ

Can I connect one Telegram bot to multiple Auralix projects? No. A single token works in one project only. Create a separate bot via BotFather for each project.

Is the Telegram Bot API free? Yes, the Bot API is free with no message limits.

Can I change the bot's name or username after creation? The display name can be changed via /setname in BotFather. The username can be changed via /setusername if the new name is available.

Will the bot respond in group chats? Not by default. For groups, adjust privacy settings via /setprivacy in BotFather.

Summary

Connecting a Telegram bot takes 5 minutes. After that, your AI agent handles customer questions in Telegram — around the clock, with no operator involvement.

Haven't set up your knowledge base yet? Read the guide →

Create a free project →