Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vecbase.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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
By default, Telegram bots can only see commands (messages starting with /) in group chats. To allow your agent to read all messages:
1

Open BotFather

In Telegram, open a chat with @BotFather.
2

Select your bot

Send /mybots, then select your bot from the list.
3

Open Bot Settings

Tap Bot Settings → Group Privacy.
4

Turn off privacy

Tap Turn off. BotFather will confirm: “Privacy mode is disabled.”
With privacy mode disabled, the bot can read all messages in groups it’s added to. This is required for the agent to respond to non-command messages.

​
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.