Skip to main content

🎨 Bot Customization

Run the Fren One agent in your group under your own Telegram bot, with your bot's name and picture. This is a premium feature.

Where to configure it​

In the webapp: Open your workspace, select the Telegram group under Channels in the sidebar, then select Agent Settings, then the General tab, and find the Custom Bot card. The card doesn't take a token: setup continues in your DM with @FrenOneBot.

The Custom Bot card runs the agent under your own branded Telegram bot, with your bot's name and picture instead of ours. Telegram can create the bot for you, or you can connect one you already made with BotFather. Everything happens in your DM with the agent: no token is ever entered on the website.

In Telegram (bot menu): the /settings menus described below still work.

Before you start​

  • Your bot keeps every Fren One feature and your existing settings, but shows your bot's name, username and picture.
  • One bot token can't be shared with another custom bot integration.
  • Mini App captchas (Slider, Custom Mini App and Snake) only work with the main Fren One bot. With your own bot, use the inline captcha types instead. See Captcha: Mini App types.

How to Create Your Custom Bot​

First create a bot with Telegram's BotFather, then connect it to Fren One.

Step 1: Create a New Bot with BotFather​

Telegram's BotFather is the official tool for creating bots.

Steps:

  1. Open Telegram and search for @BotFather
  2. Click Start and type /newbot
  3. Choose a Bot Name (e.g., My Group Assistant)
  4. Choose a Bot Username (must end with bot, e.g., mygroupassistantbot)
  5. You will receive a bot token. Copy it
Keep Token Secure

This token will be used to link your bot to Fren One. Never share this bot token with anyone! Anyone with access to it could control your bot.

Step 2: Customize Your Bot (Optional)​

Using the /mybots command in BotFather, you can further personalize your bot. This helps make your bot look more polished and branded for your community.

Steps:

  1. In BotFather, send /mybots
  2. Select your bot from the list
  3. Choose Edit Bot to access customization options

Available customization options:

  • Change Profile Picture: Upload your logo or brand image
  • Edit Bot Description: Set the description users see in bot info
  • Edit Description Image: Add a cover image for bot description
  • Edit Bot About Info: Add about text for your bot
  • Set Default Commands: Add commands like /quiz, /leaderboard, etc.

Step 3: Connect Your Bot to Fren One​

Now connect your bot to Fren One's backend:

Steps:

  1. Open your Fren One bot (the default bot currently in your group)
  2. Type /settings and navigate to Chat Settings
  3. Select 🎨 Bot Customization
  4. Click 📝 Add Bot Token
  5. The bot will prompt: "📝 In private chat, please send me the bot token that you wish to use."
  6. Open a private chat with Fren One bot
  7. Paste the bot token you copied from BotFather
  8. Send the token
Private Chat Required

For security reasons, the bot token must be sent in a private chat with Fren One, not in the group. This keeps your token secure.

Easy Token Update

You can always update the custom bot token in Fren One if needed by repeating these steps. Simply use Edit Bot Token to change it.

Step 4: Replace Fren One with Your Custom Bot​

Now that your token is configured, switch to your custom bot:

Steps:

  1. Add your custom bot to the group:
    • Click group name → Add Members
    • Search for your bot username (e.g., @mygroupassistantbot)
    • Add the bot to the group
  2. Kick the original Fren One bot from your group (this avoids conflicts)
  3. Promote bot to Administrator with required permissions
  4. Type /settings with your new bot to continue setup

Required admin permissions:

  • Delete messages
  • Ban users
  • Invite users via link
  • Pin messages
  • Manage topics (if using supergroup topics)
Automatic Settings Transfer

All your previous settings will automatically transfer to the new bot! You don't need to reconfigure anything. Your filters, triggers, XP settings, roles, and all other configurations carry over seamlessly.

Step 5: Test Your Custom Bot​

Verify everything works with your new branded bot:

Test commands:

/settings - Should open Fren One settings menu
/help - Should show available commands
/leaderboard - Should display XP leaderboard (if enabled)

If everything responds correctly, your custom bot is ready! 🎉

Troubleshooting

Bot not responding?

  • Verify bot is in the group
  • Check bot has admin permissions
  • Ensure token is correct
  • Verify bot hasn't been deleted from Telegram
  • Check with BotFather bot is still active

Can't add bot to group?

  • Check you have admin rights in group
  • Verify bot isn't already in group
  • Ensure bot username is correct

Token rejected?

  • Verify token format is correct
  • Check no extra spaces or characters
  • Ensure token is from active bot
  • Verify bot hasn't been deleted
  • Get new token from BotFather if needed

Features not working?

  • Confirm bot has all required admin permissions
  • Check permissions include: delete, ban, invite, pin
  • Verify bot is in the correct group
  • Test with simple command first
  • Review error messages

Bot offline/unresponsive?

  • Check token is still valid with BotFather
  • Ensure bot wasn't removed accidentally
  • Try re-entering token in Bot Customization
  • Contact support if persistent

Profile changes not showing?

  • Wait a few minutes for Telegram to update
  • Clear Telegram cache
  • Restart Telegram app
  • Check changes were saved with BotFather

On this page