🦾GuildHero - Community Tracking and Rewards

Track your community and reward contribution - faster and more effectively than ever before.

📊 Welcome to GuildHero!

Welcome to GuildHero, a powerful tool designed to bring data-driven insights and fair recognition to your Telegram group. Instead of just counting messages, GuildHero uses AI to evaluate the quality of contributions, allowing you to identify and reward the members who are truly building a positive and engaging community.

With a few simple commands, you can generate detailed leaderboards, get AI-powered summaries of conversations, create a /bestof summary, and even manage a group event calendar. And when it's time to reward your top contributors, GuildHero streamlines the process by securely collecting wallet addresses and compiling them into a downloadable .csv file, making community airdrops easier than ever.

This guide will show you how to leverage GuildHero's features to streamline your community management and foster a more active, productive group.

Sample GuildHero leaderboard - including ranks, metrics, and wallet addresses.

🚀 Getting Started: How It Works

The bot silently and automatically stores new text messages sent in the group. It does not store images, files, or commands. This message history is then used by administrators to generate leaderboards and analyze community engagement over specific periods.

👑 Admin Commands

These commands are the core of the bot and are only available to group administrators.

Leaderboards & Scoring

• /score <date_range> [export] Analyzes all messages within a specified period and generates a top 20 leaderboard based on AI-powered metrics.

• Date Range: Use smart shortcuts (e.g., 7 days, 30 days) or a custom range (e.g., 01/01/2024-01/31/2024).

• Export: Add export to receive a full .csv file of the leaderboard, complete with user wallet addresses.

• /publicscore <date_range> Generates a simplified, public-facing version of the leaderboard that shows only ranks and total scores, perfect for sharing in the chat.

AI Content Tools

• /summarize <number> [topic] Provides an AI-generated summary of the last number of messages.

  • Example: /summarize 1000

  • With Topic: Add a topic to the end to focus the summary, e.g., /summarize 500 bitcoin.

• /bestof <number> Curates a "Best Of" digest, using AI to find the most humorous, insightful, and helpful messages from the specified number of recent posts.

• /vibecheck <number> [topic] Analyzes the group's sentiment based on the last number of messages.

Community Management

• /stats Displays a high-level overview of your group's activity, including total messages, active users, and top contributors.

• /calendar Opens an interactive calendar where you can add, view, or delete group events.

• /settimezone <Timezone> Sets the timezone for your group (e.g., America/New_York). This ensures daily event announcements are sent at 8:00 AM local time.

GuildHero Menu

👤 User Commands (For Everyone)

These commands are available to all members of the group.

Engagement & Gamification

• /mystats Get a private message with your personal stats, including your total message count, all-time rank in the group, and earned badges.

• /mybadges View a list of the achievement badges you've earned.

• /allbadges See a list of all available badges and what it takes to earn them.

• /events Displays a list of all upcoming events scheduled on the group calendar.

Wallet Management

To be eligible for rewards, you need to associate a wallet address with your account. This process is designed to be completely private and secure.

• Step 1: Get the Link (/ghwallet) In the group, type /ghwallet. The bot will post a temporary message with a button. Click it to open a private chat with the bot.

• Step 2: Submit in Private Chat (/ghsubmitwallet) In the private chat, use the command: /ghsubmitwallet [your_wallet_address]

Step 3: Check Your Wallet (/ghcheckwallet) At any time, you can use /ghcheckwallet in the group, and the bot will send you a private message confirming the wallet you have on file.

Checking Your Wallet

You can verify which wallet address you have stored at any time.

• Usage: /ghcheckwallet

• How it Works: When you use this command in the group, the bot will send you a private message containing your stored wallet information for security.

❓ Frequently Asked Questions (FAQ)

• Why can't I use the /score command?

  • The /score and /stats commands are restricted to group administrators to prevent spam.

• How is the score calculated?

  • The score is not just about message count. The bot uses AI to analyze user messages based on a variety of contribution metrics. A higher total score reflects more positive and meaningful contributions to the community.

• Is my wallet address safe?

  • Yes. You submit your address in a private chat with the bot, so other group members never see it. When admins export the leaderboard, the address is included alongside your username so they can distribute rewards.

• Why is the leaderboard empty or inaccurate?

  • The bot needs time to collect a sufficient number of messages before it can generate a meaningful leaderboard. If the bot was recently added, wait a day or two and try again.