PromoTrackerBot Commands Guide

This guide explains the standardized command structure for the PromoTrackerBot Telegram bot.

Standardized Command Format

PromoTrackerBot now uses a standardized command format across all communities. The commands are:

Regular User Commands

Command Description
/start Get started with the bot and see a welcome message
/help Show available commands and instructions
/balance Check your token balance
/getpassword Generate a password for web dashboard access (use in private chat only)

Admin Commands

Command Description
/shill username Generate a promotional message for a specific user
/registergroup Manually register the current group (if auto-registration fails)
/getgroupid Display the current group's ID and information (useful for setup)

How Commands Appear in Telegram

These commands now appear in the Telegram command menu when you chat with the bot. Admin commands are clearly labeled with [ADMIN] to distinguish them from regular user commands.

Command Usage Examples

Generating Promotional Content

Legacy format (still supported):

/shill-username

New standardized format (recommended):

/shill username

Both formats work the same way, but the new format is more user-friendly and consistent with Telegram's standards.

Registering a Group

Legacy format (still supported):

/register_group

New standardized format (recommended):

/registergroup

Getting Group Information

To retrieve the current group's ID and information, use:

/getgroupid

This command displays detailed information about the current chat, including: - Group ID (required for manual database configuration) - Group title - Group type (supergroup, group, etc.) - Group username (if available)

This command is particularly useful when setting up new communities or troubleshooting group registration issues.

Important Notes

  1. Admin commands can only be used by group administrators
  2. Group registration usually happens automatically when the bot is added as an admin
  3. The /registergroup command is only needed if automatic registration fails
  4. The command menu is available in both private chats and group chats

Group Onboarding Process

Automatic Group Registration

  1. Add the bot to your Telegram group
  2. Make the bot an administrator in the group
  3. The bot will automatically detect it has been added and register the group
  4. Group description will be captured if available
  5. Group registration confirmation message will be sent to the group

Manual Group Registration (if automatic fails)

  1. Add the bot to your Telegram group
  2. Make the bot an administrator in the group
  3. Have a group admin type /registergroup in the group chat
  4. The bot will register the group and send a confirmation message

Bot Requirements

For more information, contact your community admin or visit the web dashboard.