Skip to main content

➕ Adding Fren One to Your Community

Setting up Fren One on Telegram has three separate parts:

  1. Install the agent in your Telegram group. Add @FrenOneBot to the group and make it an admin. This is what lets it read and moderate messages.
  2. Connect the group to a Fren One workspace in the webapp. This adds the group to a workspace as a channel, so it shows up in the dashboard alongside your other channels and team.
  3. Configure it, either in the webapp dashboard or with /settings in Telegram.

The webapp wizard walks you through parts 1 and 2 together. You can also install the agent from Telegram alone and configure it with /settings; the group then works without appearing in a webapp workspace.

Before you start​

  • Your group must be a supergroup. Fren One only works in supergroups, and new or small groups are often regular groups. To convert one, open the group's settings and set Chat History For New Members to Visible; Telegram converts it to a supergroup instantly.
  • You need to be an admin of the Telegram group to add the agent as an admin.
  • To connect the group to a workspace, you need to be the Owner or an Admin of that workspace. See the Workspaces docs for how workspaces, teams and roles fit together.

Connect a group from the webapp​

  1. In the sidebar under Channels, select Connect a channel (it's also in the workspace switcher's menu at the top of the sidebar). To start a new workspace instead, open the workspace switcher and select Create or join a workspace: it runs the same wizard, starting with a step to name the new workspace. If you aren't in any workspace yet, select Add workspace.

  2. Choose Telegram.

    • If your Telegram account isn't linked yet, the first step is Connect: select the Log in with Telegram button to link your account. The wizard then has four steps: Connect, Add Agent, Assign, Done.
    • If your Telegram account is already linked, the wizard skips Connect and opens at Step 1 of 3 · Add Agent.

  3. On Add Agent, follow the steps shown:

    1. Open Telegram and go to your group (or create a new one).
    2. Add @FrenOneBot as a member.
    3. Promote the agent to admin. It needs admin rights to read messages.
    4. Come back to the wizard and select Check for groups.

    The wizard lists the groups it detects with the agent in them. Groups already managed in Fren One are left out of the list and counted in a note instead. If nothing is detected, check that the agent is an admin and that the group is a supergroup, then check again. When connecting a channel, you can also select Skip for now: your Telegram account stays linked and you can add groups later from the dashboard.

  4. On Assign, choose which workspace each detected group belongs to. Groups start unselected: tick each group you want to connect, then pick its workspace from the dropdown next to it. You can also choose New workspace to create one on the spot by giving it a name and URL. Select Continue to connect the ticked groups.

  5. If you created a new workspace in the previous step, an optional Invite step lets you invite teammates to it. Everyone invited here joins as a Member; you can change roles later in Settings, on the Team page.

  6. Done confirms how many groups were connected and assigned, with a Go to channel or Go to workspace button.

When you start from Create or join a workspace, the step after Add Agent is Review instead of Assign: you select the groups to add to the new workspace and create it with Create workspace. A new workspace needs at least one channel.

Add the agent from Telegram​

You can also install the agent from Telegram without using the webapp:

  1. Open Telegram and search for @FrenOneBot, or use this link: https://t.me/frenonebot
  2. Start a chat with the bot by selecting Start.
  3. Add it to your group by selecting Add Bot as Admin and choosing the group.
  4. Approve the admin permissions the bot requests.

If you added the bot as a member without admin privileges​

  1. Go to your group settings → Administrators.
  2. Add @FrenOneBot as an administrator.
  3. Enable these permissions:
    • ✅ Delete messages
    • ✅ Ban users
    • ✅ Invite users via Link
    • ✅ Pin messages
  4. Select Save or Done to confirm.

To bring a group installed this way into a webapp workspace, run the webapp wizard above: with the agent already an admin in the group, Check for groups finds it straight away.

Start configuring in Telegram​

Once the bot is an admin:

  1. Type /settings in your group chat.
  2. The bot responds with the configuration menu.
  3. Start setting up features like:

Configuration Options​

In Telegram, you can configure Fren One in two ways. Groups connected to a webapp workspace can also be configured from the dashboard.

In the Group Chat​

  • Type /settings in the group
  • Configure settings that apply to that specific group
  • All admins can see and modify settings

In Direct Message (DM)​

  • Open a private chat with @FrenOneBot
  • Type /settings
  • You will be asked to select the group you want to manage. If you want to switch to another group configuration: use /switch or /setchat to change which group you are configuring when you manage more than one group
  • Configure settings privately without cluttering the group chat
DM Configuration

Verifying Setup​

To verify Fren One is properly configured:

  1. Type /settings in your group
  2. Check that the bot responds with a settings menu
  3. Try a simple command like /help
Troubleshooting

Bot doesn't respond to /settings:

  • Verify the bot is a member of the group
  • Check that the bot has admin privileges
  • Make sure the bot isn't muted or restricted

Features not working:

  • Confirm all required admin permissions are granted
  • Check specific feature requirements in their documentation
  • Review Chat Settings for any restrictions

Can't add bot to group:

  • Verify you have admin permissions in the group
  • Check if the group allows bots (some groups restrict this)
  • Try using the direct bot link if search doesn't work

Multiple Groups​

If you manage multiple Telegram groups, you can:

  • Add Fren One to each group separately
  • Each group maintains independent settings
  • Use /switch or /setchat in DM to manage all your groups from one place
  • Consider using Custom Bots for tailored look of the Agent

Next Steps​

After adding Fren One:

  1. Set up onboarding - Configure Captcha and Welcome Messages
  2. Enable moderation - Set up Filters, Triggers, and Word Blacklist
  3. Add gamification - Enable XP, Roles, and Quizzes
  4. Configure AI - Activate Spam Detection and Sentiment Moderation
  5. Explore Web3 - Set up Token Gating if you have a token
Premium Features

Some features like Bot Customization require a premium subscription. Check the Fren One website in the near future for pricing and premium benefits.

On this page