Overview
Gallery supports Free-only, Paid-only, and mixed bundles. A mixed bundle is an intentional two-send sequence: the ordered Free portion is delivered first, followed by one locked Paid payload containing every ordered Paid item.
- Choose a bundle structure that matches the content.
- Understand the difference between open and locked delivery.
- Avoid accidental Free and Paid media pairing.
Before you start
- Select the bot whose autonomous Gallery inventory you want to manage.
- Upload and prepare the media assets before adding them to a bundle.
- Understand that Gallery becomes eligible only after the complete Scripts-first path.
Step by step
- Open the bundle and review every selected media item in order.
- Assign all items Free for an open bundle, all items Paid for one locked offer, or deliberately combine both roles.
- For a mixed bundle, order the Free teaser portion and the Paid unlock portion intentionally.
- Set the Stars range only when at least one Paid item exists.
- Test delivery and confirm Free media and the locked Paid payload appear as separate Telegram sends.
How it works
These are the product rules and states that matter for this workflow.
| What to know | Telestars behavior |
|---|---|
| Free-only | All media is delivered without a paywall and the bundle never opens Waiting Payment. |
| Paid-only | Every ordered item is delivered together as one locked Telegram offer with one price and one unlock. |
| Mixed | Free media is sent separately first, then all Paid items are sent as one locked payload. |
| Explicit grouping | A Free-to-Paid relationship exists only because the client assigned both roles in the same saved bundle. |
Verify the result
- A Free-only bundle creates no paid offer or Waiting Payment state.
- A Paid-only purchase unlocks every item in the one locked payload.
- A mixed bundle produces exactly the intended Free send followed by the intended Paid payload.
Troubleshooting
| If you see this | What to check |
|---|---|
| A bundle is visible but not selected | Check enabled state, readiness, prior use, Script state, relevance, cooldown, and the current fan turn. |
| Paid media cannot be added or delivered | Check the asset paid-delivery readiness and Secretary Mode permissions. |
| The same bundle appeared twice | Confirm the first attempt was actually delivered; only failed or provably unsent attempts stay eligible. |
Best practice
Build small, well-grounded bundles with clear roles and distinct media context instead of relying on large generic inventories.