Managing your users and their subscriptions

As the owner of a BuddyPro instance, you have several useful commands that allow you to retrieve information about your paying (and trial) users and manage their access or messages.

23.0: Overall statistics and analytics

As an owner (owner) or team member, use the /stats command. This command displays a summary report that includes a USER ANALYTICS section with key metrics:

• Total users: total number of users (excluding owner and team).
• Active subscriptions: number of users with active paid subscriptions.
• Currently on trial: The number of users who are currently on trial (or have completed the trial and have not purchased a plan).
• Avg used trial messages per user: The average number of messages used by users in a trial.
• Avg AI cost per trial user: average cost per user in the trial.

This command is ideal for getting a quick snapshot of the health and growth of your user base.

New /stats metric: Average monthly cost per user

We have added a new value to the /stats command:

• Average monthly cost per active user

This metric shows you the average AI cost per user with an active subscription.

ℹ️ How it’s calculated:

• only users with an active subscription for at least 7 days are included,
• the calculation is monthly and should be treated as approximate,
• the metric has been available since August 11, 2025.

23.1 How do I get detailed information about a specific user and their subscription?

If you need to find out details about a specific paying user (for example, their subscription status, next payment date, or how many messages they have left), use the command:

/getInfoAboutUser:{subscriptionId}

• {subscriptionId}: This is the unique identifier of that user's subscription in your payment system.
  • If you use Stripe, {subscriptionId} is the ID of the subscription in Stripe subscriptions. You can find it in the Stripe Dashboard.
  • If you use FAPI, {subscriptionId} is the ID of that user' s recurring invoice. You can find it in your FAPI account in the Recurring Invoice Templates section.

What information will this command show you? The command will typically provide an overview of:

• Subscription status (e.g., active, cancelled, payment issue).
• The date of the next scheduled billing/renewal of the subscription.
• The current number of messages remaining within its monthly limit.
• The number of remaining extra messages (if he has purchased any in the package).
• Information about the plan used.
• His payment and activation history.

This command is very useful for resolving queries from clients about their account or for investigating any issues with their subscription.

23.2 How to deactivate a subscription or a user's access to your AI instance?

There may be situations where you need to immediately terminate a user's access to your AI Expert (e.g. at their request, when they violate the terms and conditions, or if you are refunding their subscription). This is what the command is for:

/disableUser:{subscriptionId}

• Again, use {subscriptionId} from your payment system (subscription ID from Stripe, periodic invoice ID from FAPI, etc.).

This command will immediately terminate that user's active subscription in BuddyPro and prevent them from sending further messages to your AI instance.

⚠️ VERY IMPORTANT NOTICE: if you are refunding a user for their subscription directly in your payment system, you must ALWAYS use this /disableUser command in BuddyPro as well if you want to stop their subscription! Simply refunding the invoice does not automatically terminate the user's access to AI in BuddyPro. Without using /disableUser, the user could continue to use the service even if you refunded them.

The BuddyPro platform attempts to automatically deactivate users if their recurring subscription payment repeatedly fails and is not paid on time, but for manual intervention this command is necessary.

23.3 How do I add bonus (extra) messages to a user beyond their plan?

If you want to add a certain number of extra messages to a paying user (e.g. as a reward, compensation or for special purposes), which will not expire and will only be used after their standard monthly limit has been exhausted, use the command:

/giveExtraMessages:{subscriptionId}:{extraMessages}

• {subscriptionId}: The user's subscription identifier (see above).
• {extraMessages}: The number of extra messages you want to add to the user (e.g. 50, 100).
  • You can also enter a negative value here (e.g., 20) if for some reason you need to remove the extra messages from the user (e.g., if you accidentally added them earlier).

23.4 Manual management of trial messages for existing (but not yet paying) users

These commands are used to adjust the number of trial messages for users who are either in a trial period or whose trial period has expired but have not yet purchased a paid subscription. For example, if you want to extend a trial for a loyal fan or provide more messages for more thorough testing.

To use these commands, you need to know the unique Telegram ID of the user ({userId}).

• How do I find out the {userId}? The easiest way is to ask the user to type and send a command in a chat with your AI instance:

  /myid

  Your AI instance will then display his {userId}. Request this ID from him.

• Commands for managing test messages:

  • /setTrialMessages:{userId}:{count}
    • Sets the new total number of trial messages for the user with the given {userId} to {count}. If he had any trial messages before, this value overrides them.
    • Only works for users who have never started a subscription before.
  • /addTrialMessages:{userId}:{count}
    • Adds the specified number {count} of trial messages to the current trial message balance of the user with the given {userId}.
    • If you want to remove trial messages, you can use a negative number for {count} here.
    • Again, this only works for users who have not yet paid.

23.5 Tracking the usage of your invitation codes

If you use specific invitation links generated by the /generateBuddyProInvite command (see Section 20.6) to acquire new users, you can track their success rate. Use the command:

/checkInvite:{code}

• {code}: Enter the exact 7-digit code of the invitation whose statistics you want to display (the one you defined or that BuddyPro generated for you).

What does the command show you?

• The total number of times this particular invitation was used (how many users came through it).
• How many of those users subsequently purchased a paid subscription (conversion rate).
• How many users from this invitation are currently still in the trial period.
• The average number of messages that users from this invitation have used during their trial.
• The average AI cost per user in the trial coming through this invitation.

This command is very useful for evaluating the effectiveness of your different marketing campaigns, affiliate partners, or different types of trial offers.

23.6 Overview of used invites

In addition to the /checkInvite:{code} command, which checks a specific invite code, you now also have:

• /listInvites

This command lists all invite codes that have been used by two or more people.

For each invite, you can also see how many of those users activated a subscription.

👉 This makes it easy to identify which invite links are the most effective and actually convert into paying users.

23.7 Extended user activity statistics

BuddyPro now provides an extended overview of subscriber activity using the command:

/stats

This command no longer shows only basic information. It now includes daily, weekly, and monthly user activity (active rate).

What you can see in the statistics:

• number of active users per day
• number of active users per week
• number of active users per month
• an overview of overall subscriber activity over time

These statistics help you to:

• better evaluate user engagement
• track the impact of changes in onboarding or content
• optimize pricing plans and communication
• make informed decisions about the future development of your BuddyPro instance

ℹ️ Note:

The /stats command is intended primarily for BuddyPro instance owners. It serves as an analytical tool for long-term management and growth of your AI expert.

---

---