Skip to main content

​
Telegram Setup

Connect your Vecbase agent to Telegram so users can chat with it directly in Telegram.

​
Prerequisites

  • A Telegram account
  • A Vecbase agent created

​
Step 1: Create a Bot with BotFather

1

Open BotFather

Open Telegram and search for @BotFather (the official Telegram bot management bot).
2

Create a new bot

Send /newbot to BotFather. It will ask you for:
  • Bot name: A display name (e.g., “My Company Assistant”)
  • Bot username: Must end with bot (e.g., mycompany_assistant_bot)
3

Copy the bot token

BotFather will reply with your bot token. It looks like:
8737604196:AAFspi44trCXi3fxDr50-v1g6gIdvageZQA
Keep this token secure — anyone with it can control your bot.

​
Step 2: Connect in Vecbase

1

Open agent settings

Open your agent, tap Settings in the top right, then select Channels.
2

Add Telegram channel

Click Add Channel next to Telegram.
3

Enter credentials

  • Display Name: A name to identify this channel (e.g., “Customer Support Bot”)
  • Bot Token: Paste the token from BotFather
4

Create

Click Create. The status will change to Connected within a few seconds.

​
Step 3: Test

Open Telegram, find your bot by searching its username, and send a message. Your Vecbase agent will respond automatically.

​
Bot Settings (Optional)

You can customize your bot in BotFather:
CommandDescription
/setdescriptionSet the bot’s description
/setabouttextSet the “About” text
/setuserpicSet the bot’s profile picture
/setcommandsSet custom command menu

​
Limitations

LimitValue
File upload50 MB (Bot API)
File download20 MB (getFile API)
Message length4,096 characters
Telegram bots can work in both private chats and group chats. In groups, the bot responds when mentioned with @botusername.