🎨 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

Premium Feature

Bot Customization is available to premium users and is perfect for projects, brands, and organizations that want to maintain their own identity while using Fren One's comprehensive moderation and engagement features.

Important Limitation

You cannot combine Fren One with other custom bot scripts. Your custom bot will run exclusively on Fren One's platform.

Why Use Custom Bot

Benefits

Brand Consistency:

• Bot matches your project name
• Custom profile picture with your logo
• Reinforces brand identity
• Professional appearance

Trust Building:

• Members interact with your official bot
• No third-party bot names
• Enhanced credibility
• Direct brand association

Complete Control:

• You own the bot token
• Manage bot profile directly
• Change name/picture anytime
• Bot under your Telegram account

White-Label Solution:

• Remove Fren One branding
• Present as your own solution
• Enterprise-ready appearance
• Custom identity

Use Cases

Crypto Projects:

• Official project bot
• Token name as bot name
• Project logo as avatar
• Professional community management

Brands & Companies:

• Corporate bot identity
• Company logo and colors
• Professional moderation
• Brand-aligned communication

Large Communities:

• Established community name
• Recognizable avatar
• Consistent branding
• Trust and familiarity

Agencies & Consultants:

• Client-specific bots
• White-label service
• Professional delivery
• Agency branding

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

BotFather conversation example:

You: /newbot

BotFather: Alright, a new bot. How are we going to call it? 
Please choose a name for your bot.

You: My Group Assistant

BotFather: Good. Now let's choose a username for your bot. 
It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.

You: mygroupassistantbot

BotFather: Done! Congratulations on your new bot. You will find it at 
t.me/mygroupassistantbot. You can now add a description, about section and 
profile picture for your bot, see /help for a list of commands.

Use this token to access the HTTP API:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Keep your token secure and store it safely, it can be used by anyone 
to control your bot.

For a description of the Bot API, see this page: 
https://core.telegram.org/bots/api

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.

Example customization:

You: /mybots

BotFather: Choose a bot to edit.

You: @mygroupassistantbot

BotFather: What do you want to do with the bot?
[Edit Bot] [Bot Settings] [Delete Bot]

You: Edit Bot

BotFather: 
- Edit Name
- Edit Description
- Edit About
- Edit Botpic
- Edit Commands

You: Edit Botpic

BotFather: Ok. Send me a photo.

[Send your logo/avatar image]

BotFather: Success! Profile photo updated.

Professional Appearance

A custom profile picture and description make your bot look official and trustworthy. Use your project logo and clear description for best results.

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

Token format:

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Confirmation:

✅ Bot token successfully updated!

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. Kick the original Fren One bot from your group (this avoids conflicts)
2. 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
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.

Admin Permissions Required

The bot must be an administrator with all required permissions to function properly. Without these, moderation and management features won't work.

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)

Test features:

• Try a moderation action
• Send a test message
• Check bot responses
• Verify notifications work
• Confirm XP tracking works
• Test any custom features you have enabled

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

Managing Your Custom Bot

Bot Customization Options

In the Bot Customization menu, you have two main options:

📝 Edit Bot Token:

• Update your bot token
• Switch to a different custom bot
• Sent via private chat for security

➖ Remove Bot Token:

• Revert back to default Fren One bot
• Removes your custom bot configuration
• Settings are preserved

Updating Bot Profile

Change Profile Picture:

1. Go to @BotFather
2. Send /mybots
3. Select your bot
4. Choose Edit Bot → Edit Botpic
5. Upload new image

Change Description:

1. Go to @BotFather
2. Send /mybots
3. Select your bot
4. Choose Edit Bot → Edit Description
5. Enter new description

Change About Text:

1. Go to @BotFather
2. Send /mybots
3. Select your bot
4. Choose Edit Bot → Edit About
5. Enter new about text

Update Commands:

1. Go to @BotFather
2. Send /mybots
3. Select your bot
4. Choose Edit Bot → Edit Commands
5. Add/update command list

Bot Username Cannot Change

Note: You cannot change the bot's username after creation. Only the display name, profile picture, description, and commands can be updated.

Switching to a Different Custom Bot

To switch to a different bot:

1. Create new bot with BotFather (Steps 1-2 above)
2. Navigate to Chat Settings → 🎨 Bot Customization
3. Click 📝 Edit Bot Token
4. Send new bot token in private chat
5. Remove old custom bot from group
6. Add new custom bot to group
7. Grant admin permissions

Result: Settings automatically transfer to the new bot!

Removing Custom Bot (Revert to Default)

To remove your custom bot and use Fren One's default bot:

1. Navigate to Chat Settings → 🎨 Bot Customization
2. Click ➖ Remove Bot Token
3. Confirm removal
4. Remove your custom bot from group
5. Add default Fren One bot back to group
6. Grant admin permissions

Result: All settings remain and work with the default bot.

Managing Multiple Communities with Fren One

If you manage multiple Telegram groups using Fren One, you can easily switch between them when configuring settings.

Using the /switch Command

When you're changing settings in a direct message (DM) with the non-customized Fren One Bot, you can use the /switch command to change which community you're configuring.

How it works:

1. Open a private chat with the Fren One bot (non-customized)
2. Type /switch
3. Bot displays a list of all communities where you're an admin
4. Select the community you want to manage
5. Bot switches context to that community
6. Continue configuring settings for the selected community

Example scenario:

You: /switch

Fren One Bot: Please select which community you want to manage:

1. 🚀 Project Alpha Community
2. 💎 Token Holders Group
3. 🎮 Gaming Community
4. 📈 Trading Signals

[Select buttons appear]

You: [Click "🚀 Project Alpha Community"]

Fren One Bot: ✅ Switched to Project Alpha Community. 
You can now configure settings for this group.

When to Use /switch

Use /switch when:

• You manage multiple communities with Fren One
• You're in a DM with the non-customized Fren One bot
• You want to configure settings for a different group
• You need to check settings across multiple communities

Not needed when:

• Using custom bots (each custom bot is tied to one community)
• Sending commands in the group chat (context is automatic)
• Managing only one community

Benefits of Multiple Community Management

Centralized Control:

• Manage all your communities from one bot
• Switch between groups easily
• Consistent interface across all communities
• Single DM for all configurations

Efficient Workflow:

• Quick switching with /switch command
• No need to find each group chat
• Configure settings in private
• Compare settings across communities

Custom Bots per Community:

• Each community can have its own custom bot
• Custom bots maintain their own identity
• Settings remain separate per community
• Professional appearance for each group

Best Practices for Multiple Communities

Effective Multi-Community Management

• Use Descriptive Names: Give each community a clear, recognizable name
• Document Differences: Note unique settings for each community
• Test Before Applying: Verify settings in one group before copying to others
• Custom Bots for Branding: Use custom bots for each major community
• Consistent Core Settings: Maintain similar moderation rules where appropriate
• Group-Specific Tweaks: Customize XP rates, roles, and filters per community needs
• Regular Audits: Periodically review settings across all communities
• Use /switch Efficiently: Switch to the correct community before making changes

Example Multi-Community Setup

Scenario: Managing 3 different communities with Fren One

Community 1: Main Project Group (Custom Bot)

• Custom bot: @ProjectOfficialBot
• Settings: Balanced moderation, active gamification
• Token gating enabled
• High XP rewards

Community 2: Token Holders Only (Custom Bot)

• Custom bot: @ProjectHoldersBot
• Settings: Relaxed moderation, exclusive content
• Strict token gating
• Premium perks

Community 3: Support Group (Default Fren One Bot)

• Bot: Default Fren One
• Settings: Strict moderation, FAQ focus
• No gamification
• Support-oriented

Managing them:

• Use custom bots for branded communities (1 & 2)
• Use /switch in DM for quick setting checks
• Each maintains independent settings
• Consistent admin team across all

Best Practices

Effective Bot Customization

• Choose Clear Name: Bot name should clearly represent your project
• Professional Avatar: Use high-quality logo/image
• Secure Token: Store token securely, don't share
• Complete Profile: Fill out description and about text
• Test Thoroughly: Verify all features before launch
• Document for Team: Share bot details with admins
• Monitor Activity: Ensure bot stays online and functional
• Update Profile: Keep description current with project changes
• Backup Token: Store token safely in multiple secure locations
• Professional Identity: Maintain consistent branding

Common Mistakes

• Sharing Token: Never post token publicly or in code
• Weak Permissions: Not granting full admin permissions
• Generic Name: Using unclear or unprofessional bot name
• No Profile Picture: Leaving default avatar
• Testing in Production: Test in private group first
• Lost Token: Not backing up token securely
• Wrong Token: Entering incorrect or expired token
• Forgotten Bot: Not removing old bots from group

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
• Try re-creating invitation link

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
• Verify Fren One service status
• 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

Security Considerations

Token Security

Do:

• ✅ Store token in secure password manager
• ✅ Limit access to token
• ✅ Back up token securely
• ✅ Use token only in Fren One
• ✅ Monitor bot activity

Don't:

• ❌ Share token publicly
• ❌ Commit token to version control (Git)
• ❌ Post token in chats
• ❌ Share token with untrusted parties
• ❌ Use token in multiple services

Bot Account Security

Protect your bot:

• Enable 2FA on your Telegram account
• Use strong Telegram password
• Don't share @BotFather access
• Regularly check bot activity
• Revoke token if compromised

Compromised Token

If token is leaked:

1. Go to @BotFather immediately
2. Use /revoke command
3. Select your bot
4. Generate new token
5. Update token in Fren One
6. Monitor for unauthorized activity
7. Inform your team

Advanced Configuration

Multiple Bots

You can create multiple bots for different purposes:

Use cases:

• Different bots for different communities
• Staging bot for testing
• Backup bot for redundancy
• Regional bots for language-specific communities

Management:

• Each bot needs its own token
• Each bot configured separately in Fren One
• Each bot added to respective groups

Bot Commands

Customize bot commands via @BotFather:

/setcommands

Choose bot: @MyProjectBot

Send commands:
settings - Open bot settings
help - Show help menu
leaderboard - View XP leaderboard
roles - View available roles
quiz - Take a quiz

This customizes the bot's command menu for users.

Bot Privacy

Control bot message access via @BotFather:

/setprivacy

Choose bot: @MyProjectBot

Enable privacy mode? (Current status: DISABLED)

Choose: Disable - bot sees all messages (recommended)

Recommendation: Disable privacy mode so bot can see all messages for moderation.

Key Reminders

Important Points to Remember

💡 Keep your bot token private — anyone with access to it could control your bot.

💡 You can always update the custom bot token in Fren One if needed by using Edit Bot Token.

💡 Your custom bot retains all Fren One features while displaying your own brand — no functionality is lost!

💡 All settings automatically transfer when you switch bots — you don't need to reconfigure anything.

💡 You cannot combine Fren One with other custom bot scripts — your bot runs exclusively on Fren One's platform.

Integration with Fren One Features

All Fren One features work seamlessly with your custom bot:

Moderation:

• Filters, triggers, warns, kicks, bans
• Word blacklist and whitelist
• Spam detection, impersonation detection
• Traffic control and notifications

Gamification:

• XP system and leaderboards
• Roles and permissions
• Quizzes and achievements

Onboarding:

• CAPTCHA and welcome messages
• User blacklist and whitelist

AI Features:

• Smart triggers
• Sentiment moderation
• Custom AI models

Web3 Tools:

• Token gating
• Crypto price feeds

Content Scaling:

• Scheduler and tweet feeds

Everything works exactly the same, just with your branding!

Related Features

• ⚙️ Chat Settings - Access Bot Customization
• 🔑 API Keys - Configure AI service keys
• 👋 Welcome Message - Custom bot welcomes
• 🔔 Notifications - Bot notification settings

Professional Identity

Bot Customization transforms Fren One from a third-party service into your own branded community management solution. Members interact with your official bot, reinforcing your brand while you leverage all of Fren One's powerful features. It's the best of both worlds: professional identity with enterprise features!