# Vibe Trading

{% embed url="<https://streamable.com/l975ca>" %}

**Welcome to the Flooz AI Agent—your 24/7 vibe trading companion in the trenches! This guide explains what the agent is, how it works, best prompting practices, and key recommendations for optimal use.**

{% hint style="info" %}
**Disclaimer**: The Flooz AI Agent is for educational and informational purposes only and does not constitute financial advice, investment recommendations, or guarantees of any outcomes. Trading involves significant risk, and you may lose money. AI can hallucinate or provide inaccurate information—always verify insights independently, conduct your own research, and consult professionals. Use at your own risk; Flooz is not liable for any losses. Results are not guaranteed, and past performance does not predict future results.
{% endhint %}

### What is Vibe Trading

Vibe trading is empowered by the Flooz AI Agent, a conversational AI designed to be your personal trading sidekick, facilitating vibe trading through natural chat. Inspired by vibe coding (where you chat with AI to build effortlessly), vibe trading lets you converse naturally with the agent to explore signals, discuss emotional aspects of trading, and access data-driven insights without the grind. It's like ChatGPT for crypto: plugged into real-time on-chain trading data and tools for PnL analysis, top trader mirroring, and more. It can answer any crypto-related questions, making it suitable for beginners (e.g., explaining basics) and pros (e.g., discussing advanced strategies).

Key features:

* **Instant Insights**: Paste a token's contract address (CA) or link (e.g., Dexscreener) for technical analysis (TA), buy/TP/SL signals, sentiment alpha, and data-driven recommendations.
* **Personalized Guidance**: Analyzes your wallet PnL, mirrors profitable traders (sorted by win rate, chain, time frame), spots trends/new launches, and provides backtested alerts.
* **Emotion Check & Vibe Flow**: Discusses rational approaches during volatility, exploring signals through chat to consider reducing FOMO/panic—always available in Telegram for quick vibes.
* **Trade Support**: Provides information to help you understand trades, consider manual placement, and explore risk management (e.g., discuss TP/SL adjustments)—it does not execute trades on your behalf.
* **Seamless Integration**: Works with embedded wallets for manual trading; non-custodial, with accountability via notifications.

The agent is beta-free for early users on Telegram (<https://t.me/iris\\_flooz\\_bot)!\\>
*Remember, all outputs are for educational purposes only—no guarantees of performance.*

### How Does It Work?

The Flooz AI Agent operates as an intelligent chat companion, fetching and analyzing data on-demand to provide informational support for your trades. Here's the core flow:

1. **Input Your Query**: Start a conversation in Telegram by pasting a CA/link or asking a question (e.g., "Analyze this SOL token: \[CA]").
2. **Data Fetch & Analysis**: The agent pulls real-time on-chain trading data, combines with web research for sentiment, and runs TA (indicators like RSI, MACD, support/resistance).
3. **Generate Insights**: Outputs informational recommendations—e.g., entry points, TP/SL levels, risk-adjusted strategies—tailored to your vibe (from onboarding quiz or prompts). It mirrors top traders, backtests for reliability (e.g., "68% win rate"), and flags emotional biases (e.g., "Avoid FOMO: Sentiment is overhyped").
4. **Action & Feedback**: Suggests manual trades (e.g., "Set this TP in your wallet"); sends notifications for signal hits/misses. Vibe iteratively—ask follow-ups like "Update with latest data" to refine.
5. **Learning Loop**: The more you chat, the better it vibes with your style (e.g., scalp vs. swing), focusing on data over hype.

Powered by advanced AI models, it's non-advisory (not financial advice)—use for education and vibes only. Available 24/7, always in the trenches with you. No outcomes are guaranteed.

### How to Prompt It: Prompt Guide

The agent thrives on clear, structured prompts to deliver max value. Think vibe trading: Chat naturally, but include key details for precision. Basic format: \[Contract Address/Link] + \[Network] + \[Goal/Risk].

#### Prompt Tips

* **Be Specific**: Include CA/link, chain (e.g., SOL, ETH), and your intent for tailored responses.
* **Add Context**: Mention hold time, spot/perps (spot only for now), risk profile (e.g., low: conservative SL; high: aggressive entries).
* **Iterate**: Follow up for refinements (e.g., "Update with sentiment?").
* **Examples**:
  * **Basic TA**: "Analyze \[CA] on SOL—give TA, buy entry, TP/SL."
    * Response: Instant chart signals, levels based on data.
  * **With Goal**: "\[Dexscreener link] on ETH, max hold 1 hour, spot trade, my risk profile is medium."
    * Response: Short-term signals, adjusted for risk (e.g., tighter SL).
  * **PnL Vibe**: "Check my wallet PnL on SOL—mirror top traders with >70% win rate last week."
    * Response: Breakdown, simulations, emotional nudge (e.g., "Avoid overexposure").
  * **Sentiment Check**: "\[CA] on SUI, vibe on sentiment and trends—high risk profile for perps (beta)."
    * Response: Web/on-chain alpha, vibe chat to "teach" signals without hype.
  * **Emotional Guard**: "I'm feeling FOMO on this pump—analyze \[link] and keep me rational."
    * Response: Data-backed calm (e.g., "Overhyped; wait for dip").
  * **Existing Position Review**: "Here's my spot position on ETH: Entry $2,500, direction long, size 0.5 ETH, TP $3,000, SL $2,300—does this strategy make sense or need adjusting?"
    * Response: Risk assessment, suggestions (e.g., "Tighten SL to $2,400 based on support").
  * **Perps Position**: "Perps long on SOL: Entry $150, liquidation $120, size 10x leverage, TP $180, SL $140—review and suggest tweaks for medium risk."
    * Response: Volatility check, adjustments (e.g., "Lower leverage to avoid liq; new TP $175").
* **Best Practices**: Start simple, vibe deeper; use /analyze for quick starts. Avoid vague prompts (e.g., "What's good?")—specify for better vibes. All responses are educational only—no guarantees.

### Recommendations

The Flooz AI Agent shines for tokens with majority traffic on DEX (e.g., SOL, ETH L2s, SUI)—where real-time on-chain trading data is richest for accurate TA, PnL, and trends. Ideal for:

* Spot trading (perps beta soon).
* Volatile degen plays with high DEX volume.
* Short-to-medium holds (e.g., scalp/day trades); long-term HODL less optimal without more context.

Limitations: Best on supported chains (no BTC yet); not financial advice—vibe responsibly. For devs: List tokens via bot addition; build communities with our growth stack (docs.flooz.xyz).

Questions? Vibe with the agent on Telegram or hit us up! 🤑


# Prompt guide 1: Discover and analyse

I remember getting into crypto back in 2020. It was an exciting time with Bitcoin surging during the pandemic, from around $5,000 to nearly $30,000. But it was overwhelming. Figuring out wallets, exchanges, and avoiding scams felt like a full-time job. The wild price swings and lack of clear guides made every step risky. I felt the pain of endless research and trial-and-error firsthand.

This is the first in a multi-part series on getting the most from Vibe Trading. Here, we focus on finding exciting tokens to analyze and understanding strategies.

### Background

Turns out, most traders do lose money. Around 70-90% of retail crypto traders end up in the red, with studies showing 84% losing in their first year alone. New folks jumping into crypto are already swamped with stuff like blockchain basics, wallets, and exchanges. It's overwhelming, and one bad trade or scam can wipe them out. Making them swear off crypto forever.

But here's the good news. Crypto is the one financial world where mastering it can give you real freedom. Trading is key. Learn it well, and you're set for life. No matter if markets go up or down.

### Problem

Learning to trade? It's a nightmare. Gurus push pricey courses or "VIP" chat rooms, promising the moon but delivering little. Everyone starts at different spots. Some need the ABCs, others want pro tips. It's tough to find something that fits your pace.

### Solution

That's why my team created Vibe Trading. It's an AI app that breaks down how crypto markets (and finance in general) really tick. Made for total beginners and seasoned pros. Think of it as your patient teacher and smart analyst rolled into one. Always in your pocket.

The AI gets where you're at. It's chill, up 24/7. Ask silly questions at 3am? No problem. It pulls real-time info like token stats, news, and X buzz to guide you. Its job? Help you build a skill that lasts a lifetime.

Vibe mostly ingests DEX data, so it's ideal for tokens with high trading volume on decentralized exchanges, not centralized ones (CEX). Be cautious with freshly launched tokens. They're extremely volatile. The app shines for tokens with actual volume and some history or age.

Disclaimer: Vibe is for learning only. No profit promises. Always double-check with your own smarts. Trading risks money. Do your own research.

### Purpose of Post

New tools like AI need simple guides to shine. This post shares prompts we tested to get the most from Vibe. It meets you where you are. Try these tips. They're game-changers.

### Part 1: Discovering Tokens

We tried over 20 prompts to hunt tokens with upside. Here are the top 5, explained simply for newbies. They spot cheap hidden gems or solid established coins.

1. **Find Solana tokens with market cap under $5M, volume over $1M, holders over 5,000, txns over 1,000. Avoid scams.**

   This looks for cheap Solana tokens (market cap is total value) with buzz. High volume (trading amount) and holders (owners) mean real interest. Txns (transactions) show activity. Scam filter keeps it safe. Great for beginners. Finds early deals with crowd support, cutting bad risks.
2. **Scan Base chain for mature coins: Market cap $10M-$50M, 24h price change over 20%, average wallet age over 3 months.**

   On Base network, this finds reliable tokens with recent pops. Mid market cap skips tiny risks but grabs bargains. Change (price shift) shows growth. Wallet age (how long owners hold) means loyalty. Spots stable picks for longer keeps.
3. **Breakout candidates on Solana: 4h change min 30%, volume min $200K, mkt cap under $1M.**

   Hunts Solana tokens heating up. Big change (price jump) and volume mean momentum. Medium volatility (ups/downs) balances risk. Low market cap leaves growth room. Beginner-friendly. Catches tokens about to surge, teaching pattern spotting.
4. **Low-risk gems on Solana: Avoid scams on, token age under 3 months, buys min 200, sellers max 150, liquidity over $50K.**

   Scam avoidance first. Young age for fresh potential. Buy/sell imbalance shows positive vibes. Liquidity ensures trades. Perfect for novices. Teaches low-risk hunting, focusing on secure early entries.

### Understanding Strategies

Once you find tokens, these 5 prompts teach plans. Cover spot (basic buy/sell) and perps (boosted trades on Hyperliquid). Explanations build basics like entry (start price), profits (sell points), stop losses (safety nets), and leverage (multiplier for gains/risks).

1. **For spot buy: "Analyze Solana (or any other token) for a spot buy. Suggest entry price, stop loss, take profits based on my moderate risk profile. Explain why."**

   Teaches simple buying. Example: AI suggests entry at $150 (safe start), stop loss at $145 (cut losses), take profits at $160 (partial) and $170 (rest). Explains: Entry's undervalued, stop protects money, profits secure wins. Builds no-leverage basics.
2. **For perps long: "Recommend a long on ETH (or any other token) via Hyperliquid with 3x leverage. Include entry, SL, TP, and explain the risks."**

   Covers boosted buying (long). Example: Entry $3,000 (uptrend start), SL $2,900 (if wrong), TP $3,200/$3,500. Explains: Leverage multiplies wins (3% rise = 9% profit) but losses too. Teaches volatility management in leveraged trades.
3. **For perps short: "Short Pepe token (or any other token) on Hyperliquid with 2x leverage. Strategy with entry, SL, TP, and leverage impact."**

   Teaches betting on drops (short). Example: Entry $0.50 (overpriced), SL $0.55 (if rises), TP $0.45/$0.40. Impact: 2x doubles down-profits but ups liquidation odds. Explains bear plays and leverage dangers.
4. **For neutral strategy: "For a sideways token like WIF (or any other token) on spot, advise if to hold or wait. Suggest breakout levels and why."**

   Handles flat markets. Wait for $1.01 up or $0.99 down. Explains: No direction means sit tight. Teaches patience and spotting real moves without forcing trades.

We hope these prompts kickstart your wins.&#x20;

If you haven't, **download Vibe Trading** and dive in. Your freedom awaits.


# Introduction

{% embed url="<https://video.twimg.com/ext_tw_video/1875184707668783104/pu/vid/avc1/1280x720/c6_V-BEveHy8X0TJ.mp4?tag=12>" %}
Chill guy app powered by Flooz
{% endembed %}

### Flooz Apps for Teams

> Reward users for completing daily tasks in XP points or token airdrops!

**Flooz Apps are designed to convert social and web traffic to holders and turn holders into brand ambassadors.** Flooz apps provide you with all the features viral apps like NOTCOIN used to grow to millions of users!<br>

### Demo

Live Demo: Homescreen → App → Content → Charts → Swaps → Complete tasks

{% embed url="<https://video.twimg.com/amplify_video/1872403000674734080/vid/avc1/720x1560/LPn8DNFj5Dx0Qw1N.mp4?tag=16>" %}

***

### Features at a glance

Flooz is already empowering over 100k web3 communities across Telegram.&#x20;

* Onboarding → No more seed phrases, instant fiat to token, instant swaps
* App → Brand your app, add unlimited links and content
* Tasks → Reward users for completing daily tasks in XP points or token airdrops
* Airdrops → Create and manage your airdrops
* Alerts → Manage buy alerts, welcome messages, task update,s and more


# Installation

### Getting started

{% stepper %}
{% step %}
**Add `@iris_flooz_xyz` as an admin**

Link to bot  ([t.me/iris\_flooz\_xyz](https://t.me/iris_flooz_xyz)) Make sure it has admin access and can also manage members (required for the referral system)
{% endstep %}

{% step %}
**Enter  `/setup` into your community chat**

The Flooz bot replies with a link to a 1:1 chat. Click on it.&#x20;
{% endstep %}

{% step %}
**Select your account type**

* Token team → Requires a contract address
* Creator →  Does not require a contract address (perfect for KOLs/ Influencers, alpha groups, ...)
  {% endstep %}
  {% endstepper %}

Congratulations :white\_check\_mark:, the Flooz bot is now set up, and you're ready to customize your experience.

***

Once the `@iris_flooz_xyz` bot is added to your community as an admin, enter `/setup` command in your group to customize your App experience at any moment in time:

* [App](/flooz-for-token-devs/app) →  Customize your app, add unlimited links and content
* [Tasks](/flooz-for-token-devs/tasks-and-leaderboard) → Reward users for completing daily tasks in XP points or token airdrops
* [Airdrop](/flooz-for-token-devs/airdrops) → Manage your Airdrop wallet
* [Alerts](/flooz-for-token-devs/alerts)  → Manage buy alerts, welcome messages, task update,s and more
* [Premium: Clone](/flooz-for-token-devs/premium-clone)  →  Go pro and create your own branded App
* [Premium: AI Memes](/flooz-for-token-devs/premium-ai-memes) →  Let your community create and share your IP at scale!
* [Premium: DM Blasts](/flooz-for-token-devs/premium-dm-blasts)  →  Broadcast a message to all users


# App

<figure><img src="/files/Qb5lLF6IEFKAynAcMKMA" alt=""><figcaption><p>You're in good company</p></figcaption></figure>

Enter the `/app` command in your group to customize your experience including:

<details>

<summary>Logo and Banner</summary>

Personalize your logo and banners to reflect your brand by uploading custom assets, including images or videos, to your app.

**Logo Recommendations:** Use a 1:1 aspect ratio and ensure the file size is under 50 KB for best performance.

**Banner Recommendations:** The width is fixed, while the height adjusts automatically. For optimal quality, we recommend a minimum width of 600 px.

</details>

<details>

<summary>Claim your domain</summary>

By default, your group’s Telegram ID serves as your domain on Flooz and looks something like this *flooz.xyz/hub/-1001907230551*. Ugly right?

To customize your domain, simply navigate to the `/app` menu and click `Custom Domain`. After verifying your X account, your URL will be transformed into something more personalized, like *flooz.xyz/chillguyCTO*.

Rest assured, connecting your Twitter account only verifies your username for authenticity.&#x20;

</details>

<details>

<summary>Bio description</summary>

Personalize the bio in your app to showcase your brand or community. Keep it concise—under 300 characters—and use standard emojis for the best experience. Note that line breaks are not supported.

</details>

<details>

<summary>Theme and primary color</summary>

Choose between light and dark mode to match your style. You can also customize the accent color by entering a hexadecimal value, which you can find at [HTML Color Codes](https://htmlcolorcodes.com/).

</details>

<details>

<summary>External Links and social links</summary>

Easily add social links or custom links to your app.

**Social Links:** These are displayed as icons directly under your display name, perfect for showcasing your social media profiles.

**Custom Links:** Add any links you’d like to share, with support for link styling. Choose from the following styles:

* **Simple Style:** Clean button with centered text.
* **Asset Left, Text Centered:** Icon or image on the left with text centered.
* **Bigger Asset, Text Below:** A larger icon or image with centered text underneath.
* **Jumbo Size:** Extra-large icon or image with text displayed on top.

You can also customize the order of your links to prioritize the most important ones.

</details>

<details>

<summary>Top Picks</summary>

Top Picks is a curated collection of tokens you can highlight in your app. Simply add a new Top Pick by entering the token’s contract address and assigning a label. Choose from pre-set labels or create your own for a personalized touch.

You can showcase up to 10 tokens in your Top Picks collection.

</details>


# Tasks & Leaderboard

Enter the `/task` command in your group to customize daily tasks to be completed by your community. You can reward your community members with XPs and token airdrops.

For each task, you can customize

* Title and asset of a task
* Reward of a task: XP (experience points) or token rewards (requires an that an Airdrop wallet has been set up, see “Airdrops” in this guide)

## Available tasks

<figure><img src="/files/H4Kg7pMEt9o32RhIX2id" alt=""><figcaption></figcaption></figure>

<details>

<summary>Go viral</summary>

The "Go Viral" feature is a new tool to incentivize community members to create and share high-quality viral content. This feature allows admins to set up viral content submission campaigns that reward members for creating content that gains traction online. The Flooz bot tracks the engagement metrics of approved content and automatically rewards users with XP and token airdrops (if enabled by the admin).

Currently, the feature supports TikTok and X (formerly Twitter), with planned expansion to Instagram and YouTube.

### How it works for end users

1. **Access the "Go Viral" Task**
   * Visit the community’s Flooz-powered app.
   * Click on the "Earn" section.
   * Select either "Go Viral on X" or "Go Viral on TikTok."
2. **Submit Your Content**
   * Paste the link to the content piece you created.
   * Authenticate your account:
     * **For X**: Log in and authenticate your X account.
     * **For TikTok**: Copy a temporary one-time code, paste it into your TikTok bio, return to Flooz, and click "Verify."
3. **Admin Review Process**
   * Your submission is sent to the community admin for review.
   * If approved, Flooz begins tracking engagement on your post.
   * If rejected, you may or may not receive feedback.
4. **Earn XP & Rewards**
   * As your content garners more engagement, Flooz automatically distributes XP and, if applicable, token airdrops.
   * Check your earned rewards in the "Earn" section of the Flooz app.

### How it works for community admins

1. **Setup the "Go Viral" Task**
   * Navigate to your community’s chat on Telegram
   * Enter /task and select "Go Viral"
   * Chose between TikTok or X *(adding support for Instagram and Youtube soon)*
   * Select the action type, e.g. likes, views, comments, reshares, bookmarks, etc.)
   * For each of the action types you can customize (e.g. "views")
     * Min. amount and max amount (e.g. min. 100k views and max 10m views on Tiktok)
     * Steps (e.g. for every 5k additional views)
     * Reward
       * User receives XP points (e.g. for every 5k additional views, user gets 20 XP points)
       * Token airdrop (e.g. for every 5k additional views, user gets 50 $TOKENS)&#x20;
   * Click create and your campaign is live :clap:
2. **Content Submission Review**
   * Once a community member submits content, you'll get a notification from the Flooz Bot to review
   * You can always access the moderation tab by navigation to: `/tasks → Go Viral → Moderation`
   * Review the content to ensure it aligns with the brand and community goals.
   * Approve or reject the submission.
     * If rejecting, you may provide feedback (optional).
   * Approved content is added to the community’s "Meme Bank" on the Flooz App and Flooz Page.
3. **Automated Tracking & Rewards**
   * The Flooz bot tracks engagement on the approved post.
   * The submitting user automatically earns XP and potential token airdrops as the content gains traction.
   * Admins can monitor performance analytics within the dashboard.

### Why use "Go Viral"?

#### **For Community Members:**

* Get rewarded for creating viral content.
* Contribute to the growth and visibility of your favorite projects.
* Showcase your creativity and earn XP and tokens.

#### **For Community Admins:**

* Automate content-driven marketing efforts.
* Incentivize community participation without constant manual effort.
* Build an organic "Meme Bank" with community-generated content.

</details>

<details>

<summary>Join Telegram Group</summary>

*No more unnecessary portal channels!*

Your app includes a built-in portal designed to safeguard your community from bots and malicious users. Before granting access to your Telegram group, we use AI in partnership with Cloudflare to assess whether a user is genuine. If flagged as a bot, the user will not receive the invite link to your community.

</details>

<details>

<summary>Invite friends</summary>

Your app comes with a powerful, pre-built referral system. Reward users with experience points (XP) or token airdrops for inviting others to join your community. By default, the referral system is double-sided, meaning both the inviter (User A) and the invitee (User B) receive rewards (XP or tokens,

</details>

<details>

<summary>Follow socials</summary>

Reward users for following or joining your social media platforms, including:

* X/ Twitter
* Instagram
* TikTok
* Farcaster
* Youtube
* Discord

To create a new “follow socials” task, simple select the social media channel, add your link, customize the branding and you’re ready to go!

*Note: These tasks are “soft-checked” for seamless user experience.*

</details>

<details>

<summary>Watch a video</summary>

Reward users for watching your latest content on platforms like Twitch, Kick, TikTok, YouTube, X, and more.

For additional verification, you can set a password that users must enter after watching the video—perfect for live streams or exclusive content.

</details>

<details>

<summary>Join a live event</summary>

Incentivize users to participate in live events such as X Spaces or Telegram Voice Chats. To confirm attendance, you can set a password that users must enter after tuning in.

</details>

<details>

<summary>Connect to OKX wallet</summary>

You can reward users for connecting to an OKX wallet. This task type only makes sense if you are running a campaign with OKX. Feel free to reach out to the Flooz team to get assistance in setting up a campaign with OKX.

</details>

<details>

<summary>Token Balance check</summary>

Set up a token balance check to ensure that you're rewarding users who already hold a certain amount of your tokens. Select the tokens and token balance users should require and set up the reward mechanism (XP and/ or token airdrops).

For users who do not have the required minimum token balance, they will be asked to either

* Directly buy the token with Apple Pay, Google Pay, credit card or bank transfer
* Swap native coins to the token
* Send required tokens to their wallet address.

All of the above is a seamless experience for the end user.

</details>

***

## Reward your leaderboard

Within the task menu, you can manage your leaderboard with ease:&#x20;

{% stepper %}
{% step %}

### Select Recipients

Select between:

* Time scale (All time, Today, This Week, This Month, ...)
* Segement your usersbase: Top Leaderboard Spots vs. Minimum XP count
  * *e.g.reward, **only** users that are in the top 25 leaderboard spot*
  * *e.g., reward **only** users that have a minimum of 125 XP*
    {% endstep %}

{% step %}

### Select reward

You can airdrop tokens across all EVM chains and on Solana. Select the token you would like to airdrop and the amount per recipient.
{% endstep %}

{% step %}

### Define a custom message

You can attach a personal note when rewarding users. Options include

* A custom message
* A custom banner (image or video)
* A custom button (external link)
  {% endstep %}

{% step %}

### Preview and confirm

Lastly, you can preview the airdrop before confirming it
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Note for teams that are sending airdrops to a large amount of users:**\
The airdrops are batched in groups of 250 at a time. So if you airdrop to 1 thousand users, Flooz will execute four transactions, each containing 250 airdrops. For the sake of gas efficiency, airdrops are batched. While the airdrops are confirmed and executed fast, the notification to the end user can take minutes and, for large airdrops, potentially hours. Why? Simply put, Telegram has API limits that we need to honor and respect.&#x20;

*TLDR: If you airdrop to 1000 people, the transaction will be done swiftly, whereas the notification that the user has received their funds can take some time.*
{% endhint %}

***

## Manage your leaderboard

Within the task menu, you can manage your leaderboard and block and unblock users with ease. Options include

* **🚫 Block**
  * **Blocked users will still earn XP, but they will be prevented from receiving airdrops and payout.s**
  * To block a user, simply select "Block" from the menu and enter the username of the user you wish to block from the leaderboard.&#x20;
* **✅ Unblock**&#x20;
  * Did you accidentally block a user from receiving rewards? No worries! In the same way you've blocked a user, you can easily unblock by selecting the option and clicking on "Unblock."
* **👥 View blocked**
  * Here you can find a list of users you've blocked from receiving rewards. You can easily unblock users from here too!


# Reward Leaderboard

Leaderboard & Rewards

Leaderboards are an excellent way to drive engagement within your community. Our bot allows you to track user activity, display rankings, and reward top participants, creating a competitive and rewarding environment.

### Viewing the Leaderboard

Community members can see the current leaderboard by using the `/leaderboard` command in your group chat. This shows:

* Top participants ranked by their XP (experience points)
* Each user's current position and XP total
* A customizable banner representing your community

Leaderboards can be viewed for different timeframes:

* Daily
* Weekly
* Monthly
* All-time

### Rewarding Top Participants

As a community admin, you can distribute rewards to your most active members based on their leaderboard performance:

1. Navigate to the admin panel and select "Manage Leaderboard" > "Reward Top Participants"
2. Choose the timeframe (daily, weekly, monthly, all-time)
3. Select your reward method:
   * Position-based (top X users)
   * XP threshold-based (users with more than X points)
   * Custom range (positions X-Y or XP between X-Y)
4. Configure your reward message with:
   * Custom text with variables like {name}, {xp}, {airdrop value}
   * Optional media (image or video)
   * Up to 2 action buttons with custom text and URLs
5. Set reward amounts for each tier
6. Preview your reward and confirm distribution

The system automatically handles token distribution to eligible wallets, creating a seamless rewarding experience.

### Managing the Leaderboard

For optimal community management, admins can moderate the leaderboard:

1. Navigate to "Manage Leaderboard" > "Block/Unblock Users"
2. View a list of currently blocked users
3. Block additional users by entering their Telegram IDs
4. Unblock users individually or in batches

This feature is particularly useful for preventing spam or maintaining community standards.

### Setting Up Reward Tiers

Create multiple reward tiers to recognize different levels of contribution:

1. Position-based tiers:
   * Top 3: Premium reward
   * Positions 4-10: Standard reward
   * Positions 11-20: Basic reward
2. XP-based tiers:
   * 500+ XP: Premium reward
   * 200-499 XP: Standard reward
   * 100-199 XP: Basic reward

Each tier can have different token amounts, creating an incentive structure that rewards higher engagement.

### Best Practices

* **Regular Rewards**: Schedule weekly or monthly rewards to maintain consistent engagement
* **Transparent Criteria**: Communicate clearly how XP is earned and rewards are distributed
* **Varied Recognition**: Mix monetary rewards with special roles or privileges
* **Community Highlights**: Feature top performers in community announcements
* **Seasonal Campaigns**: Create special leaderboard challenges for holidays or project milestones

✨ [Get in touch with the team](broken://pages/J4QnTgIDi5F0muopTsKV) to power up your community with Premium


# Quick Task

## 🚀 Quick Tasks with `/task` Command

The quick task feature allows you to instantly create tasks for your community without going through the full task configuration process.

#### How Quick Tasks Work

As an admin, you can create a task in seconds using a simple command format:

```
/task URL TARGET_NUMBER
```

For example:

```
/task https://example.com 250
```

This creates a "Visit a link" task with:

* The specified URL
* A target of 250 completions
* Default 25 XP reward
* Automatically enabled status

#### When to Use Quick Tasks

Quick tasks are perfect for:

* **Time-sensitive opportunities**: Create tasks instantly when opportunities arise
* **Rapid response**: React quickly to market events or community requests
* **Spontaneous campaigns**: Launch initiatives without extensive planning
* **Testing engagement**: Quickly gauge interest in different types of content

#### Administrative Details

* Only group admins can create quick tasks
* Your group must have boosted tasks enabled
* The bot must be properly configured in your group
* Tasks created this way are fully editable later through the task management interface


# Featured Tasks (Raid-Style)

## ⚡ Featured Tasks

Featured tasks allow you to highlight important activities and set community-wide goals for task completion.&#x20;

Best in combination with [Quick Task](/flooz-for-token-devs/tasks-and-leaderboard/quick-task)

#### What are Featured Tasks?

Featured tasks are regular tasks that have a target completion goal attached to them (default: 500 completions). They help your community focus on specific activities and track progress toward shared objectives.

#### Setting Up Featured Tasks

1. Access the task management interface using the `/task` command in your group
2. Create a new task or select an existing one to edit
3. In the task configuration menu, find and toggle the "⚡ Feature Task: Off" button to turn it "On"
4. This automatically sets a default target of 500 completions
5. The task will now display with its progress toward the target

#### Benefits of Featured Tasks

* **Highlight priorities**: Direct your community's attention to the most important activities
* **Create community goals**: Build a sense of shared purpose around completing targets
* **Track engagement**: Easily see how many members are participating in key tasks
* **Drive timely actions**: Perfect for time-sensitive campaigns or limited opportunities

#### Strategic Uses

* Feature an important partnership task to drive engagement
* Highlight a token-holding task before major announcements
* Create excitement around community milestones or upcoming events
* Encourage participation in contests or special campaigns

### Best Practices for Tasks

* Use quick tasks for immediate needs and featured tasks for key initiatives
* Combine both approaches: create a quick task and then feature it for maximum impact
* Feature only 1-2 tasks at a time to maintain focus
* Set realistic targets based on your community size
* Mention featured tasks in your announcements to increase visibility
* Consider offering special rewards for tasks that meet their featured target
* Update featured tasks regularly to keep community engagement fresh


# Airdrops

Enter the `/setup` command in your Telegram group and navigate to the “Airdrops” section to create and manage your airdrop wallet.

*Note:* Only admins with the ability to add other admins have access to the airdrop wallet.

Your airdrop wallet supports multiple blockchains, including: SOLANA and Ethereum, Binance Smart Chain, Polygon, Base, Optimism, Arbitrum, AVAX, Linea, Mantle, Blast.

{% stepper %}
{% step %}

### Setting up your airdrop wallet

* Follow the on-screen instructions to create your wallet.
* Enter your email and the one-time password (OTP) sent to it. *Please note: the person who has access to the airdrop wallet controls the funds. Flooz is non custodial per default and we cannot help recover funds if you lose access to your email address!*
* Wait approximately 10–20 seconds while your account abstracted wallet is created for all supported EVM chains and Solana.
  {% endstep %}

{% step %}

### Setup token tickers

* You can only airdrop tokens that are configured in the Token Ticker section.
* To add a new ticker, click on “Add more tickers”
* Choose between stablecoins, native coins, or your own token. For custom tokens, simply enter the contract address.
  {% endstep %}

{% step %}

### Deposit funds

* Copy the address of your new airdrop wallet and transfer the desired tokens to this wallet.
* Your app will then automatically distribute tokens based on the rules defined in your `/tasks`.
* Please make sure to send enough native tokens (e.g. SOL or ETH on the respective chain) to cover for gas ⛽
  {% endstep %}
  {% endstepper %}

***

### Send tokens to external wallets

At any time, you can send tokens to external wallets

1. Click on "send"
2. Select the token and the amount you wish to send
3. Enter the recipient's wallet address
4. Confirm the transaction


# Alerts

Enter the `/alerts` command in your group to manage alerts sent by the [Flooz.xyz](http://Flooz.xyz) Bot to your community. Each alert can be customized with a banner and even turned on/ off.&#x20;

**General alerts include:**

<details>

<summary>Welcome messages</summary>

Welcome messages are sent every time a new member joins your community. You can customize the message itself, add any banners (images or videos) and links. Perfect to greet new users and drive them towards your content.

</details>

<details>

<summary>Buy alerts</summary>

Buy alerts are sent every time a user buys your token.&#x20;

You can:

* Turn on/ off buy alerts
* Set up a custom banner (image or video)
* Change the circulating supply
* Set a minimum buy amount needed for the message to be triggered
* Enable/ disable a link back to your App

</details>

**Task alerts include:**

<details>

<summary>Task updates</summary>

Booost updates are designed to keep your community informed about the activity of the community. This notification is sticky and persistend and designed to drive your community to continuously booost your growth.

</details>

<details>

<summary>New task created</summary>

Notify users in your group every time you create a new task

</details>

<details>

<summary>Leaderboard</summary>

Leaderboard alerts will only be sent if triggered with the `/leaderboard` command inside of your community

</details>


# Premium: Clone

<figure><img src="/files/Qb5lLF6IEFKAynAcMKMA" alt=""><figcaption></figcaption></figure>

### **Custom mini-Apps**

Want to know how chill guy CTO grew to over 140k holders in 2 weeks? Here’s the secret sauce 🫵&#x20;

Flooz offers your project a custom App that enables you to boost your holder count, grow your social channels, trade natively on Telegram, and directly collaborate with exchanges such as OKX and Bitget Wallet.&#x20;

Try it out the [chill guy app](https://t.me/chillguycto_bot)

{% embed url="<https://video.twimg.com/amplify_video/1872403000674734080/vid/avc1/720x1560/LPn8DNFj5Dx0Qw1N.mp4?tag=16>" %}
Demo: Evan App
{% endembed %}

***

### Request a clone

To request a clone, please reach out to our partnerships team:

* Salvatore → <https://t.me/salvxyz>
* Joep → <https://t.me/jv\\_chillguy>
* Lamine → <https://t.me/lamine\\_23>

*Please make sure to contact the right accounts.*&#x20;

***

### Overview

| Category     | Feature            | Free              | Clone  |
| ------------ | ------------------ | ----------------- | ------ |
| AI           | AI memes           | ❌                 | ✅      |
|              | AI Agent           | ❌                 | ✅      |
|              | AI Moderators      | ❌                 | ✅      |
| Branding     | Display name       | Flooz.xyz         | Custom |
|              | Username           | @iris\_flooz\_xyz | Custom |
|              | Profile pic        | Stock             | Custom |
|              | Standalone App     | ❌                 | ✅      |
|              | Add to home screen | ❌                 | ✅      |
|              | Push notifications | ❌                 | ✅      |
| Core feature | Fiat to token      | ✅                 | ✅      |
|              | 1 click swap       | ✅                 | ✅      |
|              | Real-time charts   | ✅                 | ✅      |
|              | Embedded wallets   | ✅                 | ✅      |
|              | Airdrops           | ✅                 | ✅      |
|              | Meme Bank          | ✅                 | ✅      |
|              | Token listing      | ❌                 | ✅      |
|              | Trending           | ❌                 | ✅      |
|              | Ads                | ✅                 | ❌      |
| CRM          | DM blast           | ❌                 | ✅      |
|              | Reward leaderboard | ✅                 | ✅      |
| Tasks        | Join Telegram      | ✅                 | ✅      |
|              | Referral system    | ✅                 | ✅      |
|              | Follow socials     | ✅                 | ✅      |
|              | Post to stories    | ✅                 | ✅      |
|              | Watch video        | ✅                 | ✅      |
|              | Join live event    | ✅                 | ✅      |
|              | Balance Check      | ✅                 | ✅      |
|              | Connect to OKX     | ❌                 | ✅      |
|              | Connect to Bitget  | ❌                 | ✅      |
|              | Connect to ByBit   | ❌                 | ✅      |
| Alerts       | Task updates       | ✅                 | ✅      |
|              | New tasks          | ✅                 | ✅      |
|              | Leaderboard        | ✅                 | ✅      |
|              | Buy Alerts         | ✅                 | ✅      |
|              | Welcome messages   | ✅                 | ✅      |


# Premium: DM Blasts

Broadcast a message to all your users in a few simple steps!

{% stepper %}
{% step %}

### Click on "DM Blast" in the main menu

To access the menu, enter `/setup` in your community, and the menu will appear.
{% endstep %}

{% step %}

### Enter a message

We recommend not more than 500 characters
{% endstep %}

{% step %}

### Select a banner

Any DM blast can be accompanied with an image, GIF or video (mp4 recommended).
{% endstep %}

{% step %}

### Add buttons

You can add up to two buttons with links
{% endstep %}

{% step %}

### Publish

Congratulations, you've just send a DM blast to all your users.&#x20;
{% endstep %}
{% endstepper %}

{% hint style="info" %}
DM blasts is a premium feature that is only available to Flooz Clones.&#x20;
{% endhint %}


# Premium: AI Memes

## AI Memes: Create, Share, and Save

The AI Memes feature brings creativity and engagement to your Telegram community by allowing users to generate and share AI-generated memes. With just a simple command, users can create customized memes based on any project’s IP and even influence the AI’s training with their feedback.

**Benefits for your project:**

* Increased Engagement: Foster creativity and interaction within your community.
* Enhanced Collaboration: Members can influence meme quality through feedback.
* Brand Integration: Tailored memes help reinforce your project’s identity.

***

## How does it work?

{% stepper %}
{% step %}

### Enter /create + prompt

Prompts can be simple or extensive.

{% embed url="<https://drive.google.com/file/d/1AC7EDOyBEyoG_DJhKb3WnoNJAu1wIMZ_/view?usp=sharing>" %}
{% endstep %}

{% step %}

### Image generation in progress

Image generation usually takes between 10-15s
{% endstep %}

{% step %}

### Image generation complete!

Congratulations, you've just generated your first AI meme. You can :thumbsup: upvote or  :thumbsdown: downvote your AI meme. By doing so, you're actually training the AI to become better!&#x20;
{% endstep %}

{% step %}

### Share it

{% embed url="<https://drive.google.com/file/d/1u5TBlupUanF05dMlSv0zpXjTcv4ctXv-/view?usp=sharing>" %}
Flow: Create AI memes → Share → Share via DM → Share on Stories
{% endembed %}

Share it directly on X (1 click experience) or send it to friends on Telegram or post it directly to Telegram stories. For each share, you're being rewarded XPs (experience points) and/ or tokens proportionally to the impact of your creation (more on this will be revealed later)
{% endstep %}

{% step %}

### Discover more in the gallery

<figure><img src="/files/ox9QRBcbMyzZW7qwu2pM" alt=""><figcaption><p>Gallery Demo: <a href="https://flooz.xyz/foxylinea/meme-bank/ai">https://flooz.xyz/foxylinea/meme-bank/ai</a></p></figcaption></figure>

All AI memes are stored in the Gallery [(Demo)](https://flooz.xyz/foxylinea/meme-bank/ai), the single source of truth for all things memes and AI-generated content.&#x20;

Per default, every AI generation ends up in the gallery. Admins can remove content by simply downvoting a meme in the group chat or in the gallery.
{% endstep %}
{% endstepper %}

***

## Getting started

To qualify for AI memes,&#x20;

{% stepper %}
{% step %}

### Apply for AI memes

Anyone can apply! It is required that you submit 10-30 consistent brand images
{% endstep %}

{% step %}

### Application review

Our team will review if the assets submitted are good enough for training.&#x20;
{% endstep %}

{% step %}

### Pay setup and training fee

A one-off setup and training fee of 750 USD is applied (non refundable)
{% endstep %}

{% step %}

### Review AI Memes samples

We will share samples of the AI memes and require you to provide actionable feedback so we can make adjustments to the LLM.
{% endstep %}

{% step %}

### Go live

Go live with AI memes in your community and enable anyone to generate AI memes within the community chat or in a 1:1 chat (only for clones). Watch your socials media mindshare increase!
{% endstep %}
{% endstepper %}

**To request AI memes, please reach out to our partnerships team:**

* Salvatore → <https://t.me/Salvatore\\_xyz>
* Joep → <https://t.me/joep\\_xyz>
* Craig → <https://t.me/Craig\\_Xyz>
* Lamine → <https://t.me/lamine\\_23>

*Please make sure to contact the right accounts.*&#x20;

***

## Case studies

{% tabs %}
{% tab title="Foxy on LINEA" %}

<figure><img src="/files/yt5a9Om0bjAOvff5cLUc" alt=""><figcaption></figcaption></figure>

Within 48h of launching AI Memes, the Foxy community has generated 5214 AI memes and [swamped the internet with their creations](https://x.com/hashtag/FoxyLineaAI?src=hashtag_click).

{% embed url="<https://drive.google.com/file/d/1BirNFEWc8LlTDIgMs7d0JqUV0Owfhg2O/view?usp=sharing>" %}

**Try it out for yourself:**

1. Go to [@Foxy\_Linea\_Bot](https://t.me/Foxy_Linea_Bot) App📱or into the Foxy community
2. Generate memes by typing /create + your prompt!
   {% endtab %}

{% tab title="Maneki on SOL" %}

<figure><img src="/files/7cAN0mvKaw4iGffsWeuQ" alt=""><figcaption></figcaption></figure>

* Within 48 hours of launching AI memes, the Maneki community generated 3414 AI memes!&#x20;
* At peak times, 112 AI memes have been generated in a single hour, whereas on average, the community generates 32 AI memes per hour!
* Maneki's mindshare on X grew, with countless community members sharing their AI creations.&#x20;

**Try it out for yourself:**

1. Go to [@unrevealedxyz\_bot](https://t.me/unrevealedxyz_bot) App📱or into the Maneki community
2. Generate memes by typing /create + your prompt!
   {% endtab %}

{% tab title="Chill guy" %}

<figure><img src="/files/ojbECVeVCSjHwJV8gUpL" alt=""><figcaption></figcaption></figure>

* Within 48 hours of launching AI memes, the chill guy community generated 2974 AI memes!&#x20;
* chill guy's mindshare on X grew, with countless community members sharing their AI creations.&#x20;

**Try it out for yourself:**

1. Go to [@chillguycto\_bot](https://t.me/chillguycto_bot) App📱or into the chill guy community
2. Generate memes by typing `/create` + your prompt!
   {% endtab %}
   {% endtabs %}


# Premium: AI Videos

## AI Videos: Animate, Share and Engage

The AI Videos feature transforms your Telegram community by allowing administrators to animate&#x20;AI-generated images created by community members.

**Benefits for your project**

* Enhanced Engagement: Create captivating animated content that drives interaction within your  &#x20;community
* Brand Amplification: Generate shareable videos that extend your project's reach across platforms
* Dynamic Storytelling: Tell your project's story through motion, adding a new dimension to your  &#x20;visual identity
* Admin-Controlled Quality: Ensure only the best content gets animated, maintaining brand  &#x20;consistency

## How does it work?

1. When a user creates an AI image with the /create command in your community
2. As an admin, you'll see a "🎥 Animate" button below the generated image
3. Click "Animate" to open the video configuration panel
4. Choose your desired video duration (5 or 10 seconds)
5. Add animation instructions like "Zoom in slowly" or "Pan from left to right"
6. Click "Generate" to start the animation process
7. Once complete, the video will be shared in both your private chat and the group

**Animation Tips for Admins**

* Keep instructions clear and simple: "Zoom in on the center" works better than complex  &#x20;instructions
* Consider movement direction: Specify "left to right" or "top to bottom" for directional  &#x20;animations
* Experiment with effects: Try instructions like "gentle wave effect" or "subtle pulsing"
* Match animation to content: Choose movements that enhance the image's subject matter

**Sharing and Feedback**

* The animated videos will be posted in both the group chat and your private chat
* Users can react with 👍 or 👎 to provide feedback on the quality
* Videos include a "Share" button for distribution to other platforms

**To request AI Videos, please reach out to our partnerships team:**

* Salvatore → <https://t.me/Salvatore\\_xyz>
* Joep → <https://t.me/joep\\_xyz>
* Craig → <https://t.me/Craig\\_Xyz>
* Lamine → <https://t.me/lamine\\_23>

*Please make sure to contact the right accounts.*


# Premium: AI Agent

## About

Flooz AI Agents are intelligent virtual companions designed to engage with your community 24/7. Whether moderating conversations, answering questions, or driving participation, these agents enhance user experiences and support your project’s growth.

**Key Features**

* **Connected to the blockchain**: Natively integrated with the blockchain, Flooz AI Agents fetch real-time information about your token market stats, including price, market cap, and trading volume.
* **Task and Airdrop Integration**: Connected to the Flooz Airdrop API and Task API, the agents can check if users have completed tasks, guide them toward task completion, and reward them accordingly.
* **Smart Moderation**: Track and remember user behavior to ensure positive and constructive interactions.
* **Autonomous Engagement**: Proactively comment on messages, answer project-related questions, and encourage participation in tasks or community activities.
* **Voice Interaction**: Enable voice messaging for more personalized communication.
* **X spaces and live streams** (coming soon): AI agents can autonomously join X spaces, create their own podcasts and even live stream on Zoom, Hangouts etc. using Deepfakes.&#x20;
* **Proactive Rewards** (coming soon): Automatically tip users for valuable contributions and create new tasks to keep the community engaged.

**Always Learning**

Flooz AI Agents draw knowledge from your connected X account (likes, comments, retweets) and chats within the Telegram community. Additionnally, you can easily manually brief the AI Agent for any specific goal. The agents stay up-to-date, aligned with your project’s needs, and equipped to foster growth.

With Flooz AI Agents, your community gains a reliable and intelligent partner to drive engagement, maintain order, and incentivize participation.

***

## Getting started

To qualify, your community must own a [Clone (more here)](/flooz-for-token-devs/premium-clone).

### Character details

<details>

<summary>Bio</summary>

* What role does the agent play in your community (moderator, task pusher, project expert)?
* What is its core personality (friendly, professional, witty)?
* How should the agent interact with different users (newcomers, veterans, troublemakers)?
* Does it specialize in certain topics (project stats, market updates, rewards)?
* Does it maintain long-term memory of user interactions (e.g., recognizing past troublemakers)?

</details>

<details>

<summary>Lore</summary>

1. Does the agent have a fictional backstory or origin (e.g., created by the project team)?
2. What motivates its actions (community growth, user education)?
3. How does its backstory reflect its purpose (a vigilant MOD or a playful mascot)?

</details>

<details>

<summary>Topics</summary>

* What topics should the agent focus on (market stats, project milestones, community engagement)?
* Should the agent handle niche questions (e.g., technical project details)?
* How deeply should it interact with trending topics from Telegram and X?

</details>

### Style

<details>

<summary><strong>General Style</strong></summary>

* How should the agent’s tone feel to users (approachable, authoritative)?
* Does it use emojis or GIFs to add personality?
* Should it maintain a consistent emotional tone (neutral, enthusiastic)?

</details>

<details>

<summary><strong>Chat Style</strong></summary>

* How long should responses be (short and snappy or detailed)?
* How does it guide users toward tasks or rewards?
* Should it proactively reach out or only respond to user messages?

</details>

<details>

<summary>Post style</summary>

* How does the agent craft longer posts or announcements?
* Should posts be structured for easy readability (headings, bullet points)?
* What tone fits announcements (neutral, promotional)?

</details>

<details>

<summary>Message examples</summary>

* How should the agent answer common questions about the project?
* How does it handle user disputes or negative comments (e.g., FUD)?
* Should it encourage users to explore specific features (e.g., tasks, rewards)?

*Sample prompts*

* **User:** “What’s the project’s market cap today?”\
  **Agent:** “The current market cap is $2.5M, with a 24-hour trading volume of $150K. Would you like a detailed breakdown?”
* **User:** “Why hasn’t the project hit its milestone?”\
  **Agent:** “We’re on track and progressing steadily! Here’s what we’ve achieved so far: \[link]. Let’s stay excited!”

</details>

[Get in touch with the team](broken://pages/J4QnTgIDi5F0muopTsKV) to power up your community with AI


# Premium: AI Recap

## AI Recap

Flooz AI Agents now offer an intelligent conversation summary feature that keeps community administrators informed and engaged, even when they can't actively monitor group discussions.

### About

AI Recap allows administrators to have the AI Agent intelligently summarize community conversations from the past 48 hours. This powerful feature extracts key discussions, trending topics, and important community interactions, ensuring you never miss critical developments in your community.

**Key Features**

* **Comprehensive Summaries**: Get concise yet thorough recaps of up to 48 hours of community conversations.
* **Smart Filtering**: The AI automatically identifies and highlights important discussions while filtering out noise.
* **On-Demand Activation**: Request recaps whenever needed through simple admin commands.
* **Customizable Time Range**: Choose any timeframe up to 48 hours for your recap.

### Getting Started

To use the AI Recap feature:

1. Ensure you have admin privileges in the community
2. Send the command `/recap [hours]` in your community chat
   * Example: `/recap 24` for a recap of the last 24 hours
   * If no time is specified, the default is 24 hours
3. The AI Agent will process the conversation history and deliver a structured summary

### Usage Examples

**Basic Recap Request** Admin: `/recap` Agent: "Here's a summary of the last 24 hours in the community:

* Discussion about the upcoming token listing dominated conversations (37 messages)
* Questions about staking rewards were addressed by community veterans
* Three new members joined and introduced themselves
* The community voted on the next AMA guest with Option B winning"

**Custom Timeframe Recap** Admin: `/recap 48` Agent: "Here's your 48-hour community recap:

* Token price discussion following the 12% increase yesterday
* Technical questions about wallet connectivity resolved by the AI
* Community debate about the roadmap priorities
* Several users completed the Twitter engagement task
* Two users flagged for potential spam behavior"

### Best Practices

* Request recaps during periods of high activity to stay informed of important discussions
* Use the feature before community announcements to understand current community sentiment
* Review recaps before joining live discussions to quickly catch up on context
* Combine with other AI Agent features for comprehensive community management

[Get in touch with the team](broken://pages/J4QnTgIDi5F0muopTsKV) to power up your community with AI


# Premium: AI X Spaces

## About

Flooz AI Agents can now join and participate in Twitter/ X Spaces audio conversations! This powerful feature enables your AI agent to engage in live audio discussions, answer questions, and represent your project in real-time voice conversations. All of this is easily manageable through the Flooz Telegram bot interface.

## Key Features

* **Live Audio Participation**: Your AI agent can join scheduled X Spaces and participate in real-time audio discussions.
* **Easy Management**: Schedule, edit, and delete X Spaces participations directly through Telegram.
* **Contextual Understanding**: Provide context about the Space to help your AI agent better understand the discussion topics.
* **Flexible Scheduling**: Schedule participations in advance or join ongoing X Spaces immediately.
* **On-demand Connection**: Connect and disconnect your AI agent from X Spaces at any time.

## Getting Started

To access X Spaces features, ensure your Telegram bot is configured as an admin in your group. Then follow these steps:

1. Use the X Spaces`/spaces` command in your private chat with the bot
2. Configure your AI agent's participation in X Spaces
3. Manage your scheduled participations

## Managing X Spaces

#### Accessing X Spaces Menu

There are two ways to access the X Spaces menu:

1. **In private chat**: Send the `/spaces` command to your bot in a private chat.
2. **From group chat**: Click the "Configure X Spaces" button when prompted by the bot in your group after using `/spaces`.

#### Scheduling X Space Participation

1. From the X Spaces menu, click "📅 Schedule X Space"
2. Enter the X Space link when prompted (format: `https://x.com/i/spaces/abcdefghijk123`)
3. Configure the following details:
   * **Title**: Set a descriptive title for this X Space (optional but recommended)
   * **Schedule Time**: Set when the AI should join \
     (use UTC format: `YYYY-MM-DD HH:MM` or type `now`)
   * **Context**: Add details about the Space topic, participants, and what your AI agent should focus on
4. Click "💾 Save X Space" to confirm

### Tips for Effective X Spaces Participation

When adding context about an X Space, include:

* What the Space is about
* Who will be participating
* Topics to focus on
* Goals for your AI agent

Example context:

```
This Space will discuss recent market trends in DeFi with leading experts from the industry. Participants include @cryptoexpert and @defianalyst. The AI should focus on explaining our project's DeFi integrations and answering questions about our tokenomics. Key goals are to establish expertise and correct any misconceptions about our protocol.
```

[Get in touch with the team](broken://pages/J4QnTgIDi5F0muopTsKV) to power up your community with AI


# Premium: AI X Reply

## Admin Guide: AI X Reply

The AI X Reply feature is an admin-only tool that allows you to generate AI-powered replies to tweets directly from your Telegram bot. This feature streamlines your Twitter engagement workflow without requiring you to leave Telegram.

### Overview

You can:

* Generate contextually relevant replies to any tweet
* Post these replies directly to Twitter from Telegram
* Maintain your social media presence efficiently

### How to Use the AI X Reply Feature

1. **Issue the** `replyToTweet` **Command**

   * In your Telegram bot, send the following command:

   ```
   /replyToTweet https://twitter.com/username/status/12345
   ```

   * Both twitter.com and x.com URLs are supported
2. **Review and Post**
   * The AI generates a contextually appropriate reply
   * The reply is automatically posted to your Twitter account
   * You'll receive confirmation with a link to view your posted reply

### Example Workflow

```
You: /replyToTweet https://twitter.com/floozxyz/status/1234567890

Bot: [🐦 reply]
> Original tweet: "We're excited to announce our new AI features!"

Your reply has been posted! View it here: https://twitter.com/yourusername/status/9876543210
```

### Benefits

* **Brand Consistency**: AI-generated replies maintain your community's voice
* **Time Efficiency**: Quickly generate contextually appropriate responses
* **Workflow Integration**: Manage Twitter engagement without platform switching
* **Controlled Access**: Only admins can post to your Twitter account

[Get in touch with the team](broken://pages/J4QnTgIDi5F0muopTsKV) to power up your community with AI


# Premium: AI Research

## AI Research

The AI Research feature empowers communities with real-time news investigation and Twitter content creation. Your AI agent researches trending topics and generates relevant tweets\
for your community's Twitter presence.

## About

The `/research` command leverages advanced AI to:

* **Investigate trending news** on any topic or general market trends
* **Generate Twitter-ready content** based on research findings
* **Provide source citations** for transparency and credibility
* **Enable admin approval workflow** before posting

## Getting Started

To use AI Research, ensure:

* Your AI agent bot is added to your group as an admin
* You have admin privileges in the group
* The feature is activated for your community

### Command Syntax

/research \[topic]

* **With topic**: Research specific news (e.g., `/research ethereum updates`)
* **Without topic**: Research general crypto news and trends

### Usage Examples

#### Example 1: Specific Topic Research

Admin: /research

AI Agent: 🔍 Researching general news...\
(This can take up to 10 minutes)

<figure><img src="/files/qts3Tj9dRIaLWBycyDxW" alt="Example result of the /research command with the approval menu" width="328"><figcaption><p>Approval menu after a research has been concluded</p></figcaption></figure>

## Approval Workflow

1. **View Sources**: Check research citations before approving
2. **Edit Tweet**: Modify the generated content through conversation
3. **Approve**: Post the tweet to your connected Twitter account
4. **Skip**: Reject the tweet and clear from memory

## Best Practices

* **Research during key market events** to capture timely insights
* **Review sources** to ensure content accuracy
* **Use specific topics** for targeted research results
* **Combine with /recap** to create content based on community discussions
* **Schedule regular research** to maintain active Twitter presence

## Admin Controls

* Only group admins can use `/research` command
* All tweet approvals require admin authorization
* Non-admins can view sources but cannot approve/edit tweets
* Research data expires after a set period for security

## Tips for Effective Research

* Be specific with topics for focused results
* Allow full processing time for comprehensive research
* Edit tweets to match your community's voice
* Regular use helps maintain consistent social media presence


