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

• The bot MUST be an administrator in the group
• At least one human administrator must be present in the group
• The group must have a name (this will be used for tracking)

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