TeleChars AI User Guide

🚀 First Steps

TeleChars AI lets you create AI characters that chat on Telegram without programming.

Create account

Enter Dashboard

You'll see public telechatbots from other users

Start

Click "Create telecharbot" in the menu

🤖 Create your Telecharbot

Simple process in 6 steps:

Name

Public name and unique username

Image

Upload profile picture (JPG, PNG, GIF, WebP)

Personality

Describe how it is (maximum 5000 characters)

Description

Optional public description (1000 characters) - It will be automatically generated with AI when editing if left empty.

System instructions

Optional instructions for generating the response (2000 characters)

Conversation examples

Optional conversation examples to guide the telecharbot (2000 characters)

Example:

Name: Luna, the Librarian Username: luna-librarian Personality: You are a kind virtual librarian. You love books 📚 Instructions: Respond with short sentences.

Conversation examples:

{user}: Hello
{ai}: Hi! Do you want me to recommend a book? 😊

⚠️ The username must be unique

If it already exists, add numbers.

🎭 Personality

Personality defines how your Telecharbot speaks and acts.

Role/Profession

What is it? (assistant, friend, expert)

Character

Kind, funny, serious, curious.

Style

Formal, casual, technical.

Interests

Topics it masters.

Limits

What it does NOT know how to do.

Detailed example:

You are Alex, video game developer with 10 years of experience. You are patient and like to teach. You have geek humor and make references to games. You don't give financial or legal advice.

🧠 Memory

Two types of memory:

📝 Short-Term Memory (STM)

What it is: Remembers current conversation
Messages: 10-100 (recommended: 50)

💾 Long-Term Memory (LTM)

What it is: Saves important info between chats
Time: 1min-24h (recommended: 40min)
Maximum: 1-20 memories (recommended: 10)

⚡ Initial configuration:
• STM: Activated, 50 messages
• LTM: Activated, 40min, 10 memories

📚 Teach Knowledge

Teach specific information to your Telecharbot by organizing it in sections that only you will see.

Create section

Ex: "My History", "Technical Data".

Add content

Maximum 8000 characters per knowledge.

Configure relevance

0.1-1.0 (how similar the question should be).

Training example:

User

What can you do?

Telecharbot

I can help you create telecharbots! Are you interested in something specific? 😊

🔗 Connect to Telegram

Connect your Telecharbot to Telegram in minutes:

Open @BotFather

Search for @BotFather on Telegram.

Create bot

Send /newbot and follow the instructions.

Copy Token

Copy the token BotFather gives you.

Paste in TeleChars AI

In the "Integrations" tab of your Telecharbot.

Ready!

Search for your bot: @[your_bot_username]

🤖 BotFather Commands:

/newbot - Create bot/token - View token
/setcommands - Configure commands (TeleChars AI does it for you)

⚠️ Common problems:

• Incorrect token → Verify it's complete
• Telecharbot doesn't respond → Wait 1-2 minutes and try again
• Commands don't appear → Click "Update Commands"

Automatic commands:

/activate - Activate telecharbot in a chat
/deactivate - Deactivate telecharbot
/start - Welcome message
/wack - Delete short-term memory in a chat
/reset - Reset long-term memory in a chat
/sleep - Save long-term memory in a chat

⚙️ Configuration

Advanced options:

🧠 AI Engine

Gemini 2.5 Flash (Lite): Free, recommended for characters with history and long chats
Mistral Small 3.2 24B: Free, recommended for coherent characters without many restrictions
Sonnet 4.5 (Claude): Requires own API Key
Other engines and providers: Will be added upon user request

🌡️ Technical Parameters

Parameter	Range	Recommended
Temperature	0.0-1.5	0.7
Top P	0.1-1.0	0.9

📊 Tokens (with own API)

Each message uses ~260 base tokens, not counting:

Conversation history
Complete personality
Retrieved knowledge
LTM memories
Chat information

For creative responses:

• Temperature: 0.8-1.2

For precise responses:

• Temperature: 0.3-0.5

🔧 Own API Key: If you add your API Key, you'll have more AI engines. Token consumption includes the ~260 base + all additional content.

💻 BlitzScript

Create custom commands with simple code.

⚠️ Important: The code runs on the server with a maximum execution time of 45 seconds

📝 Essential Functions

BlitzScript

# Send message to user
SendMessage("Hello!")

BlitzScript

# Detect command
If IsCommand("/start") Then
    SendMessage("Welcome!")
    Stop  # Stops the script
EndIf

Stop is CRUCIAL after SendMessage() to avoid duplicate responses

BlitzScript

# Detect command and remove from message
If IsCommand("/search", True) Then
    # The user wrote "/search kittens" (or "/search@your_telecharbot kittens" in groups)
    # The telecharbot sees only "kittens"
    # Do NOT use Stop here, as it would make the telecharbot not send any message
EndIf

BlitzScript

# Temporary context (only this message)
SetLLMContext("Respond as a cooking expert")

BlitzScript

# Instructions to LLM (only with own API Key)
SetLLMInstructions("Translate everything {user} says to English")
# ⚠️ Consumes tokens from YOUR account

BlitzScript

# Save data
SaveSettings("points", "100")
points = LoadSettings("points")
SaveSettings("points")  # Empty data to delete them

BlitzScript

# Get IDs
userId = GetUserID()
chatId = GetChatID()

🚀 Practical Examples

BlitzScript

# Example 1: Translator
If IsCommand("/translate", True) Then
    SetLLMContext("Translate to English")
EndIf

BlitzScript

# Example 2: Response modes
If IsCommand("/serious_mode") Then
    SendMessage("Serious mode activated.")
    SetLLMContext("Respond in a serious and professional manner.")
EndIf

If IsCommand("/fun_mode") Then
    SendMessage("Fun mode! 🎉")
    SetLLMContext("Respond in a cheerful way with emojis.")
    SaveSettings("fun_" & GetChatID(), True)
EndIf

BlitzScript

# Example 3: Points system
If IsCommand("/points") Then
    points = LoadSettings("points_" & GetUserID())
    If points = "" Then points = 0
    SendMessage("You have " & points & " points")
    Stop
EndIf

If IsCommand("/addpoint") Then
    key = "points_" & GetUserID()
    points = LoadSettings(key)
    If points = "" Then points = 0
    points = points + 1
    SaveSettings(key, points)
    SendMessage("+1 point! Total: " & points)
    Stop
EndIf

BlitzScript

# Example 4: Poll with buttons
If IsCommand("/poll") Then
    keyboard = "[[{~qtext~q:~q😊 Yes~q,~qcallback_data~q:~qyes~q},{~qtext~q:~q😐 No~q,~qcallback_data~q:~qno~q}]]"
    SendMessage("Do you like TeleChars AI?", 0, keyboard)
    Stop
EndIf

# Handle button press
callbackData = GetCallbackText()
If callbackData <> "" Then
    If callbackData = "yes" Then
        SendMessage("Thank you! 😊")
    Else
        SendMessage("How can we improve?")
    EndIf
    Stop
EndIf

In strings, ~q is a simple way to put double quotes, just as ~n is a way to put a line break, and ~t are for tabs.

🚫 Common error: Forgetting Stop after SendMessage() generates duplicate responses.

💡 Command ideas:

/translate [text]
/serious_mode
/fun_mode
/points
/poll
/quiz
/remember [text]

❓ Frequent Questions

Do I need to know programming?▼

No! Everything is configured from the visual interface. BlitzScript is optional.

Is it free?▼

Yes. You can use engines like Gemini 2.5 Flash (Lite), GPT 5 Nano/Mini, or Mistral Small 3.2 24B at no cost. More powerful engines require your API Key.

Can I have several telecharbots?▼

Yes! As many as you want, each with its own personality. But keep in mind the bot limit of your Telegram account. For free users, the limit is 20 bots in total.

Are my chats private?▼

Yes, each telecharbot has separate and private conversations.

How do I update commands on Telegram?▼

In the "Integrations" section of your telecharbot, click "Update Commands on Telegram".

What does Stop do?▼

Stops the script completely. Use it after SendMessage() to avoid duplicate responses.

Does SetLLMInstructions require API Key?▼

Yes, and it consumes tokens from YOUR account. It doesn't work with the free API.

How do I save/load data between chats?▼

Use SaveSettings("name", value) to save and LoadSettings("name") to load.

A telecharbot doesn't respond on Telegram?▼

1. Check the token
2. Wait 1-2 minutes
3. Verify the telecharbot is activated with /activate
4. If it doesn't respond in DM, try deleting the token in TeleChars AI → save → put the token back.
5. If it still doesn't work, revoke the bot token in Telegram with @BotFather.

Can my telecharbot use external tools?▼

Yes, although only those added by Marcos F R Games, you can ask him to add more tools - he will add them whenever he can maintain them. For your telecharbot to be able to use the tools, you must insert your own API Key in its "Integrations" section.

🏠 Back to TeleChars AI🚀 Create my Telecharbot