Skip to main content

🎨 Bot Customization

Integrate your own bot token to personalize the bot's appearance and brand. As a premium user, you can fully customize your bot by using your own bot token. This personalizes the appearance of Fren One in your community group while keeping all features and functionalities. Your custom bot retains all Fren One features while displaying your own brand.

Overview​

Bot Customization provides:

  • Custom Bot Identity: Your own bot name and username
  • Branded Profile Picture: Custom avatar representing your brand
  • White-Label Solution: Remove Fren One branding, use yours
  • Professional Appearance: Maintain brand consistency
  • Full Feature Access: All Fren One features with your bot
  • Independent Control: Complete ownership of bot token
  • Settings Transfer: All previous settings automatically transfer to new bot
Important Limitation

You cannot combine Fren One with other custom bot integrations within one bot token.

Captcha Mini App types

Advanced, Custom Web, and Snake captchas (Telegram Mini App) require the main Fren One bot. Communities using a custom bot token should use inline captcha types instead, or move back to the main bot for those flows. See Captcha → Mini App captchas.

How to Create Your Custom Bot​

Setting up a custom bot is easy through Fren One, but you'll need to create a new bot first using Telegram's BotFather. Let's walk through it step-by-step!

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