Skip to main content

Managing Your Users and Their Subscriptions

Managing Your Users and Their Subscriptions​

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

Overall Statistics and Analytics​

As the owner or team member, use the /stats command. This command displays a clear report that contains a USER ANALYTICS section with key metrics:

  • Total users: Total number of users (excluding owner and team).
  • Active subscriptions: Number of users with an active paid subscription.
  • Currently on trial: Number of users who are currently in the trial period (or have already completed it and haven't purchased a plan).
  • Avg used trial messages per user: Average number of messages users utilize during the trial.
  • Avg AI cost per trial user: Average costs per trial user.

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

New Metric in /stats: Average Monthly Cost per User​

We've added a new value to the /stats command:

  • Average monthly cost per active user (Average monthly costs per user with an active subscription)

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

How it's calculated:

  • only users who have had an active subscription for at least 7 days are included,
  • the calculation is monthly and approximate,
  • the metric is available from August 11, 2025.

How to 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 remaining), use the command:

/getInfoAboutUser:{subscriptionId}
  • {subscriptionId}: This is the unique identifier of the given user's subscription in your payment system.

What information will this command display?

The command typically provides an overview of:

  • Subscription status (e.g., active, cancelled, payment issue).
  • Date of the next scheduled billing/subscription renewal.
  • Current number of remaining messages within their monthly limit.
  • Number of remaining extra messages (if they purchased any in a package).
  • Information about the plan being used.
  • History of their payments and activations.

This command is very useful for handling client inquiries about their account or for investigating potential subscription issues.

How to Deactivate a User's Subscription or Access to Your AI Instance?​

There may be situations when you need to immediately terminate a user's access to your AI Expert (e.g., at their request, for violation of terms, or if you're refunding their subscription payment).

Use this command:

/disableUser:{subscriptionId}
  • Again, use the {subscriptionId} from your payment system (recurring invoice ID from FAPI, etc.).

This command immediately terminates the given user's active subscription in the BuddyPro system and prevents them from sending further messages to your AI instance.

VERY IMPORTANT NOTE: If you are refunding money to a user for their subscription directly in your payment system (e.g., you issue a credit note in FAPI and return the payment), you MUST ALWAYS use this /disableUser command in BuddyPro afterwards! Simply refunding money in FAPI (or another system) does not automatically terminate the user's access to AI in BuddyPro. Without using /disableUser, the user could continue using the service even though you refunded their payment.

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

How to 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) that won't expire and will be used after their standard monthly limit is exhausted, use the command:

/giveExtraMessages:{subscriptionId}:{extraMessages}
  • {subscriptionId}: User's subscription identifier (see above).
  • {extraMessages}: Number of extra messages you want to add to the user (e.g., 50, 100).

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 the trial period or whose trial has expired but haven't yet purchased a paid subscription. For example, if you want to extend the 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 given user ({userId}).

  • How to find {userId}? The easiest way is to ask the given user to type and send this command in the chat with your AI instance:
/myid

Your AI instance will then display their {userId}. Request this ID from them.

  • Commands for managing trial messages:
    • /setTrialMessages:{userId}:{count}
      • Sets a new total number of trial messages for the user with the given {userId} to the value {count}. If they had some trial messages before, this value overwrites them.
      • Only works for users who have never started paying for a subscription.
    • /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}.
      • Again, only works for users who are not yet paying.

Tracking Usage of Your Invitation Codes​

If you use specific invitation links generated by the /generateBuddyProInvite command to acquire new users, you can track their effectiveness.

Use the command:

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

What will the command display?

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

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

Overview of Used Invitations​

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

  • /listInvites

This command will list all invitations that have been used by two or more people.

For each invitation, you'll also see how many of these users activated a subscription.

This makes it easy to find out which invitations are most effective and bring real conversions to paying users.

Extended User Activity Statistics​

BuddyPro now offers an extended overview of your subscribers' activity using the command:

/stats

This command now displays not only basic information but also daily, weekly, and monthly user activity (active rate).

What you'll see in the statistics:​

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

Statistics will help you better:

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

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