Skip to main content

New features:

🧘 Meditations with Music​

You can now enable voice message generation with background music – ideal for guided meditations, motivational speeches, and other audio content.

To enable the feature, use: /enableVoiceWithMusicGeneration (with the appropriate parameters). Once enabled, users can create meditations on their own.

Examples your clients can use:

  • β€œCreate a guided meditation to help me process stress…”
  • β€œMotivate me to go to the gym, send me an energetic audio message with music.”

Recommended limits:

We recommend limiting the number of meditations per user per day (e.g., max 1/day), because:

  • A meditation can cost approximately 2–6Γ— more than a standard message
  • It currently counts as 1 message from the user’s message limit (the limit does not apply to BuddyPro owners and team members)

The feature can also be enabled only for specific subscription types:

  • Stripe payment link ID
  • FAPI form ID

For example, only for users with an annual subscription.

Important limitation: This feature currently works only if you are using a voice clone. It does not work with the default OpenAI voices yet.

Extended Statistics in the /stats Command​

The /stats command now also displays detailed statistics for individual subscription types. In addition to overall metrics, this provides deeper insight into user behavior across different pricing plans.

Newly available metrics include:

  • WAU (Weekly Active Users)
  • MAU (Monthly Active Users)
  • MRR (Monthly Recurring Revenue)
  • average message cost
  • average AI cost per user per month

These statistics offer valuable insights into how different plan sizes perform, their overall unit economics, and how user behavior evolves over time. They also make it easier to evaluate retention and performance of users acquired through different marketing campaigns, helping you optimize both pricing and acquisition strategies.

Essential commands used right after creating your BuddyPro instance.

🧭 List of commands:

πŸš€ 1. Initial BuddyPro Setup​

  • /setup

    Starts the initial BuddyPro setup. Guides you through connecting your Google Drive folder where you will later upload your knowledge.

  • /setFolder

    Sets the Google Drive folder used by your BuddyPro instance.

πŸ“š 2. Uploading & Processing Know-How​

  • /update

    Processes sources from Google Drive, creates transcripts, and synchronizes sources into the vector database.

  • /stopUpdate

    Stops the ongoing processing of your sources.

  • /updateRoles

    Automatically creates roles from your sources. Should be used after all sources are fully processed, when you’re ready for the next stepβ€”role generation.

  • /stopUpdateRoles

    Stops role processing.

  • /updateNextRole

    Generates one next role.

  • /updateRole:{roleName}

    Generates a role with a specific name from the role list.

βš™οΈ 3. BuddyPro Configuration​

🧠 System Prompt​

  • /createSystemPrompt

    Automatically generates the system prompt for your BuddyPro based on your knowledge and roles.

    Can only be used if you haven’t written anything yet in your SYSTEM PROMPT document on Google Drive.

πŸŽ™οΈ Voice & Voice Clone​

  • /setVoice:{voice}

    Sets the voice of your BuddyPro for all users.

    Available voices: https://platform.openai.com/docs/guides/text-to-speech#voice-options

  • /createVoiceClone

    Creates a custom voice clone that imitates your voice in BuddyPro. You’ll be guided through uploading a voice recording to create a personalized voice.

    Using a custom voice is approximately 2Γ— more expensive than using standard voices.

  • /useVoiceCloneForMe:{true|false}

    Enables or disables the voice clone only for you. This lets you test your voice before enabling it for all users.

  • /useVoiceCloneForEverybody:{true|false}

    Enables or disables the voice clone for all users of your BuddyPro. When enabled, all users will hear your custom voice instead of the default voice.

🎡 Voice + Music (e.g., meditations)​

  • /enableVoiceWithMusicGeneration:{true|false}:{dailyLimit}:{subscriptionType}

    Enables or disables voice messages with music (e.g., meditations) and music generation for your BuddyPro users.

    This feature is currently available only if you use a voice clone.

    WARNING: Generating each such message typically costs 2–6Γ— more than a standard text response, while still counting as one message for the user. We recommend limiting the number of meditations per day.

    Parameters:

    • true/false – enable/disable

    • dailyLimit (optional) – maximum uses per user per 24 hours (e.g., 1 = max 1 per day).

      The limit does not apply to the BuddyPro owner and team members.

    • subscriptionType (optional) – allow only for a specific subscription type. subscriptionType is a Stripe payment link id or a FAPI form ID. You can provide multiple values separated by commas.

🧠 AI Model Level​

  • /setModelForAllUsers:{SMART|ECONOMY}

    Sets the AI model level for all existing and future users.

    • SMART (default) – highest quality; recommended for most use cases
    • ECONOMY – cheaper, but may produce lower quality answers and more hallucinations; better for simpler assistants

πŸŽ₯ Vimeo (video downloads)​

  • /setVimeoAccessToken:{token}

    Sets the Vimeo access token used to download videos from Vimeo folders. The token is required for accessing private Vimeo folders and downloading video files.

    Requires Vimeo Standard plan or higher.

πŸ”— Subscription URLs + Support​

  • /setDefaultSubscriptionUrl:{url}

    Sets the URL where new users are sent to start a subscription.

    This webpage must not include package purchase options (packages are intended only for users who already have an active subscription).

    The ?userId=... parameter is automatically appended (with the user’s real userId).

    WARNING (FAPI): If you use FAPI and the configured URL is not a direct link to the FAPI form page, you must pass the userId parameter to the page that contains the FAPI form (the page the user clicks through to).

  • /setUpgradeSubscriptionUrl:{url}

    Sets the URL where users are sent when they want to upgrade their subscription or buy extra messages.

    The ?userId=... parameter is automatically appended.

    WARNING (FAPI): If you use FAPI and the configured URL is not a direct link to the FAPI form page, you must pass the userId parameter to the page that contains the FAPI form.

  • /setSupportEmail:{email}

    Sets the support email address where users are directed if they have an issue (e.g., billing).

πŸ§ͺ Trial Settings & Messages​

  • /setTrialEndedMessage:{message}

    Sets the message shown to users when they try to send a message after their trial ends.

    Default: Free trial ended. Please activate your subscription: <LINK>

    Must contain the <LINK> placeholder, which will be replaced by the subscription link.

  • /setInviteTrialMessages:{count}:{timeLimit}

    Sets how many trial messages new users receive when they sign up via an invite from another user.

    Parameters:

    • count – number of trial messages (counted both ways: user + Buddy). Default is 100.
    • timeLimit (optional) – trial duration in days after activation. The trial ends when either the message limit or the time limit is reached (whichever happens first). If not set or set to 0, the trial ends only when the message limit is reached.

  • /setDefaultCost:{defaultPrice}:{defaultCurrency}:{defaultPeriod}:{numberOfPeriods}:{discountedPrice}

    Sets what Buddy tells users as the default subscription price when their trial ends.

    • defaultPeriod allowed values: days, weeks, months, years
    • numberOfPeriods sets billing period length (e.g., months:1)
    • discountedPrice (optional) – if provided, Buddy will communicate that a temporary discount is available

πŸ’¬ Instance Messaging Behavior (global)​

  • /shouldInitiateMessages:{true|false}

    Sets whether BuddyPro sends messages proactively after inactivity (typically a few hours after inactivity, outside night hours; longer delays after longer inactivity).

    Default is true.

  • /shouldSendFollowUpMessages:{true|false}

    Sets whether BuddyPro sends follow-up messages (short follow-up questions typically ~1 minute after Buddy’s reply if the user doesn’t respond).

    Applies to all users of this BuddyPro instance. Default is true. Recommended to keep enabled.

πŸ’³ 4. Credits (AI usage)​

  • /setupCredits:{topUpAmount}:{topUpWhenBelow}

    Provides a link where you can purchase credits for AI usage in your BuddyPro. This should be configured before you start sellingβ€”if your initial credits run out, BuddyPro will stop responding for users.

    Parameters:

    • topUpAmount – how many USD to top up (minimum $250)
    • topUpWhenBelow – threshold that triggers automatic top-up (minimum $100)

  • /changeCreditsTopUp:{topUpAmount}:{topUpWhenBelow}

    Changes how much and when your credits are topped up automatically (same limits as above).

  • /topUpCredits:{amount}:{botUsername}

    Manually increases credits for a BuddyPro account for a specific instance.

πŸ’° 5. Payments & Subscriptions​

  • /setupStripe

    Sets up Stripe Connect integration for payments.

  • /setupAffiliateStripeConnection

    Generates a Stripe Connect link for an affiliate partner (connect their Stripe account and receive their revenue share).

FAPI (alternative to Stripe)​

  • /setupFapi:{username}:{apiKey}

    Configures FAPI for invoices and payment processing.

  • /fapiActivationLinks

    Lists activation links for all connected FAPI accounts.

  • /listUnassignedSubscriptions

    Lists all active unassigned subscriptions for your bot.

  • /processFapiPaymentForBot:{botUsername}:{paidInvoiceNumber}

    Manually processes a payment (e.g., if a webhook failed). The paid invoice number can be found in the invoice URL.

🧾 Advanced FAPI Forms​

  • /connectForm:{id}:{productId}:{type}:{messages}

    Connects a FAPI form to BuddyPro.

  • /listForms

    Lists all connected FAPI forms.

  • /getFormMessages:{id}

    Shows the maximum message limit for a form.

  • /updateFormMessages:{id}:{messages}

    Updates the maximum message limit for a form.

  • /processFapiPaymentManually:{invoiceNumber}

    Manually processes a FAPI payment.

βœ… 6. Verify BuddyPro Setup​

  • /checkSetup

    Checks your BuddyPro and tells you whether everything is configured correctly.

  • /resetPaymentSetup

    Removes the existing Stripe or FAPI integration and allows setting up a new connection.

    Can only be used if you have no sales yet.

🎟️ 7. Invites​

Note: Your BuddyPro is not publicly accessible via t.me/yourbotusername aloneβ€”it must include an invite code. This helps track acquisition sources and apply different settings per invite.

  • /listInvites

    Lists all invite codes and their parameters for your BuddyPro instance.

  • /deleteInvite:{code}

    Deletes an invite code for your BuddyPro instance.

  • /generateBuddyProInvite:{trialMessages}:{code}:{userLimit}:{timeLimit}

    Generates an invite to your BuddyPro.

    Parameters:

    • trialMessages – number of free trial messages (counted both ways); use 0 for no trial
    • code (optional) – must be 7 characters (uppercase letters and numbers)
    • userLimit – maximum number of users who can use the invite; 0 = unlimited
    • timeLimit (optional) – trial duration in days; ends by message limit or time limit

  • /checkInvite:{code}

    Returns how many times the invite was used and how many users bought a subscription. Also shows how many users are on trial, average messages used, and cost per user.

πŸ†“ 8. Free Subscription Invites (without payment system)​

  • /generateFreeSubscriptionInvite:{monthlyMessageLimit}:{inviteCount}

    Generates free subscription invites (activation links) not connected to Stripe or FAPI.

    • Each link can be used once
    • Continues indefinitely until manually cancelled
    • Message limit resets monthly on the same day
    • When limit is reached, the user can buy extra messages via upgrade URL or contact support
    • Can be cancelled by the user with /stop or by the owner with /disableUser:{subscriptionId}

πŸ§‘β€πŸ’Ό 9. Users & Team Management​

  • /setTrialMessages:{userId}:{count}

    Sets the number of free trial messages a user has. Works only if the user has never paid. Messages are counted both ways (user + Buddy). (Get userId via /myid in this instance.)

  • /addTrialMessages:{userId}:{count}

    Same as setTrialMessages, but adds to the current value instead of overwriting it.

  • /giveExtraMessages:{subscriptionId}:{extraMessages}

    Grants extra messages (no expiration) to a user with the given subscriptionId. Can also use negative values to remove extra messages.

  • /getInfoAboutUser:{subscriptionId}

    Retrieves technical and billing info for a user by subscriptionId (this is subscription ID, not userId).

  • /disableUser:{subscriptionId}

    Cancels the subscription for a user with the given subscriptionId (useful after issuing a manual refund and needing to end access immediately).

  • /addUserToTeam:{userId}

    Adds a user to your team and grants permissions to use certain commands (update, user management, invites, trial messages, instance settings, etc.). The user must run /myid in this instance.

  • /removeUserFromTeam:{userId}

    Removes a user from your team.

πŸ“’ 10. System Messages (notifications)​

  • /addSystemMessageRecipient:{userId}

    Adds a recipient for system messages (error reports, payment issues, etc.). The user must already be added to your team.

  • /removeSystemMessageRecipient:{userId}

    Removes a system message recipient. Note: you cannot remove the owner if they are the only recipient.

  • /listSystemMessageRecipients

    Lists all users who receive system messages for your BuddyPro instance.

πŸ“£ 11. Broadcast Messaging​

  • /messageAllUsers:{chargeUser}:{format}:{audience}:{type}:{message}

    Sends a message to a specific audience segment of your instance.

    • chargeUser – whether the message is charged (true/false)
    • format – text / audio / text+audio
    • audience – e.g., me, all, subscribed, trial, active, inactive(NUMBER), new(NUMBER) …
    • type – dynamic (personalized) / static (same for everyone)
    • message – instruction (dynamic) or exact message (static)

πŸ“Š 12. Stats & Reporting​

  • /stats

    Shows detailed stats for your BuddyPro (weekly/monthly costs, messages, user analytics, etc.).

πŸ§ͺ 13. Testing & Debugging​

  • /test:{test_id}

    Switches to a test profile with its own conversation history. If test_id starts with test_, it is not encrypted and provides better logging.

  • /untest

    Switches back to your real profile.

  • /del

    Deletes the last message from Telegram and memory.

  • /del2

    Deletes the last 2 (or 10) messages.

  • /lastRole

    Returns the role ID used for the last message.

  • /investigateAnswer:{message}

    Replies to the given message and also provides the relevant knowledge and role content used for that answer.

  • /setModelForMe:{SMART|ECONOMY}

    Sets the AI model level only for you (testing). This does not transfer between test profiles or to any other accounts.

  • /showCost

    Enables showing AI costs after each message (this is the cost of Buddy’s reply).

  • /hideCost

    Disables showing AI costs.

  • /disableSetupState:{true|false}

    Disables/enables setup-state knowledge inside prompts. Recommended to disable once fully configured to reduce message cost.

  • /setLanguage:{language}

    Changes the language of /help output (currently en and cs). Does not affect what language Buddy uses when chatting with you.

πŸ› οΈ 14. Technical & Diagnostic Commands​

  • /setBuildingCostLimit:{botUsername}:{newLimitUSD}

    Sets a cap on how much training (update) can cost for a given instance. Default is $800.

  • /botUsername

    Shows the botUsername of your BuddyPro instance.

πŸ›‘οΈ 15. Administrative Commands​

  • /disableLicense:{license}

    Deactivates a license and the related pro account. The license code is marked as deactivated and the account using it is also deactivated.

  • /setProOwner:{userId}

    Changes the BuddyPro owner. Warning: you will no longer be the owner and won’t be able to run owner commands.

  • /systemPromptRequests

    Lists requests to change behavior for this user (available only to the BuddyPro owner and developers).

ℹ️ 16. Informational Commands​

  • /aboutMe

    Shows a general summary of who Buddy is and how it can help you.

  • /aboutMeSpecific

    Shows the β€œwho Buddy is” summary specifically for this instance.

  • /topicsToDiscuss

    Shows topics Buddy plans to discuss with you.

  • /techniques

    Shows techniques the chatbot uses to help you.

  • /bannedTechniques

    Shows techniques the chatbot is forbidden to use or recommend.

  • /currentInfo

    Shows a summary of what you’re currently working on.

  • /currentInfoCompress

    Shows the compressed (shorter) version of the same summary.

  • /myid

    Shows the current profile ID.

  • /messageBalance

    Shows remaining message balance.

  • /help

    Displays the list of available commands.

  • /stop

    Cancels your subscription (remains active until the end of the period) or stops responses if you’re on trial.

  • /shouldMessageMe:{true|false}

    Enables/disables Buddy-initiated messages for a specific user (you). Reminders are not affected.

Last updated on