Skip to documentation

Start here

Create and activate your first script

Build a mode-compatible progression, validate every step, and make one script eligible for the selected bot’s live AI runtime.

Open Scripts
On this page

Overview

Scripts define the ordered product progression available to the AI. Telestars validates scripts against the bot, current sales mode, required text, and media readiness before they can support AI activation.

  • Create a script for the correct bot and sales mode.
  • Build valid free and paid steps where the mode permits them.
  • Resolve step-level readiness issues.
  • Activate a script that the runtime can actually select.

Before you start

  • A Telestars workspace and permission to configure at least one bot.
  • Access to the Telegram account and the official @BotFather bot used for setup.
  • A Telegram Business profile with the Chatbots settings available.

Step by step

  1. Open Scripts, select the target bot, and confirm its current mode before creating the script.
  2. Create a clearly named script and add steps in the intended conversation and sales order.
  3. Add the required title and text to each step, then attach Gallery media only where it supports that step.
  4. In Paid Media mode, include at least one valid paid step with delivery-ready media; in Sell Link mode, keep all steps free.
  5. Resolve every validation message, save the script, and mark it active for the target bot.
  6. Return to My Bots and confirm that the script and paid-media blockers have cleared for the selected mode.

How it works

These are the product rules and states that matter for this workflow.

What to knowTelestars behavior
Active eligibilityAI readiness is evaluated against active valid scripts scoped to the bot’s current sales mode.
Sell Link stepsEvery Sell Link step is free-only and must contain its required title and text; media remains optional.
Paid Media stepsPaid Media activation requires a real paid route with media that is ready for the target Telegram bot.
Mode changesA script valid in one mode does not automatically satisfy the other mode, so readiness must be checked again after switching.

Verify the result

  • The script belongs to the intended bot and current mode.
  • All steps pass validation and the script is active.
  • My Bots no longer lists a script-readiness blocker for this bot.

Troubleshooting

If you see thisWhat to check
The script will not activateOpen the reported step and complete missing title, text, pricing, or media requirements for the current mode.
The script is active but AI still reports no paid mediaIn Paid Media mode, confirm that at least one paid step uses a bot-ready Gallery asset; a free-only script is not enough.
The script disappeared after switching modesReturn to the mode it was built for or create and activate a compatible script for the new mode.

Best practice

Configure and validate one bot end to end before copying the setup to other bots. A real Telegram conversation is the final source of truth.

You’re ready

You now know how to create and activate your first script

Use the verification checklist above on the real Telegram path before considering the setup complete.

Next: Activate AI and run a live test

Did this article answer your question?

Your feedback helps us make Telestars easier to use.