Skip to main content

🧩 Captcha

The Captcha Settings menu allows administrators to configure advanced verification methods to ensure only legitimate users join your community.

Overview​

When enabled, the Fren One bot will verify all new members using configurable captcha challenges. This helps prevent spam, bots, and malicious users from joining your community.

Configuration​

To set up captcha verification:

  1. Use the /settings command in your chat
  2. Navigate to 👋 Onboarding → 🧩 Captcha
  3. Toggle the feature 🟢 ON to enable captcha verification
  4. Configure your preferred captcha type and settings

Captcha Type​

Choose the type of captcha challenge users will need to solve to verify their humanity. The available options include:

✅ Simple​

A basic captcha that asks the user to click a button to verify them.

Example

👋 Hello {user}! Please click the button below to verify you're human.

🔢 Math​

A math-based captcha that asks the user to solve a simple arithmetic equation.

Example

🔢 Hello {user}! What is 3 + 7? Please select the correct answer.

😀 Emoji​

Users are prompted to select a specific emoji from a set of options.

Example

🔐 Hello {user}! Please click on the BALLOON emoji to verify you're human.

⚙️ Custom​

Allows community admins to create tailored captcha questions. These questions can include:

  • Text-based questions: e.g., "Are you a developer?"
  • Image-based questions: e.g., asking users to identify an object in an uploaded image.
  • Admins can create multiple-choice buttons and specify which (if any) answer is correct.
tip

Custom captchas are ideal for protecting against flooding and can be linked to roles via the Fren One gamification system.

For more information - check the Questions section below ⬇️

🔗 Combo​

Allows admins to combine two captcha types (e.g., Math + Emoji) for additional security. When selected, the bot will prompt users to solve both challenges.

Captcha Mode​

Define where the captcha will appear:

  • Main Chat: Displays the captcha publicly in the group chat.
  • Direct Message (DM): Sends the captcha privately to the user.
tip

Direct Message Mode is recommended for Custom Captchas, especially when onboarding involves questions about user preferences.

Time Limit​

Set the maximum amount of time (in seconds) users have to complete the captcha before they are removed from the group.

Default: 60 seconds.

This ensures the verification process is efficient and prevents spammers from lingering in the group.

Questions (Custom Captchas)​

Available only when Custom Captcha is selected. This feature lets admins create and manage pre-join questions, which can serve various purposes:

  • Verification: Challenge users with questions specific to the group or its theme.
  • Statistics: Collect user data for insights (e.g., interests, skills).
  • Role Assignment: Assign roles based on user responses, mimicking Discord's onboarding flow.

Managing Questions​

Creating a Question​

  1. Select "+ Create Question"
  2. When prompted: "📝 Please send the new question." Write your question in the chat. Add optional images to accompany the question.
  3. The bot will send another prompt: "📝 Now, add options for this question separated by commas." Define your answers in the chat.
  4. Specify the correct answer (if applicable) or mark the question as open-ended (There is no correct answer!)
  5. After the question is created, you can preview it by selecting Preview, or you can go back to the main menu.
important

New questions need to be selected to be displayed to user, after creation, go back to Captcha Type menu and select Questions.

Then select questions you want to appear in captchas served to new users.

Editing or Deleting Questions​

Use the Questions interface to choose which questions should be used for verification or removal.

Best Practices​

Effective Captcha Configuration
  • Use Simple or Math captchas for basic verification
  • Deploy Custom captchas for role-based onboarding
  • Set appropriate time limits based on captcha complexity
  • Use DM Mode for custom questions to avoid cluttering the main chat
  • Test captcha flows before deploying to ensure smooth user experience
Security Considerations
  • Combo mode provides the strongest protection against automated bots
  • Monitor completion rates to ensure captchas aren't too difficult
  • Adjust time limits if legitimate users are frequently failing
  • Consider your community's demographics when choosing captcha types

Troubleshooting​

Captcha not appearing for new members?

  • Ensure the bot has admin privileges
  • Check that the feature is toggled 🟢 ON
  • Verify the bot can send messages (and DMs if using DM mode)

Users failing captcha verification?

  • Check if the time limit is too short
  • Verify the captcha difficulty is appropriate for your audience
  • Ensure correct answers are properly configured (for Custom captchas)

DM captcha not working?

  • Users must have DMs enabled for the bot
  • Consider switching to Main Chat mode if many users block DMs