Skip to main content

Publishing to the Catalog

To make your story available to users through t-PlotBot, you need to publish it to the catalog. Publishing is done through the Publish page on the Developers Portal.

Bot Settings​

Before publishing, configure your bot on the Publish page:

Bot Token​

Your bot's token, obtained by creating a bot through BotFather.

Bot Name​

Your bot's Telegram username without the @ symbol or the https://t.me/ prefix.

Catalog Configuration​

Set up how your story will appear in the catalog.

Bot Picture​

Upload a cover image for your story. This image is displayed in the catalog when users browse available stories.

Requirements
  • Format: JPEG
  • Maximum size: 500x500 pixels
  • Maximum file size: 1 MB

Metadata (per language)​

For each supported language, fill in:

FieldMax LengthDescription
Title15 charactersThe name of your story shown in the catalog
Excerpt40 charactersA short tagline shown under the title
Description200 charactersA longer description shown on the story page
Tip

Keep the title short and catchy. The excerpt should give users a reason to click.

Submitting for Review​

Once your catalog configuration is ready:

  1. Make sure your script has no validation errors (click Check in the editor or Save to validate)
  2. Fill in all required catalog fields (title, excerpt, description) for at least the native language
  3. Upload a bot picture
  4. Click Submit to Catalog

Your story will be sent for review. The review process ensures that all published stories meet the platform's quality and content guidelines.

Review Process​

After submitting, your story enters the review queue. During review:

  • Your story's content is checked for quality and compliance
  • You cannot modify the published version while it's under review
  • You can continue editing your script β€” changes will not affect the submitted version

Review Outcomes​

StatusDescription
PublishedYour story passed review and is now available in the catalog
RejectedYour story did not pass review. Check the feedback and resubmit

Managing a Published Story​

Once published, you can:

  • Stop publishing β€” temporarily removes your story from the catalog. Users who already started playing can continue, but new users won't see it
  • Resume publishing β€” makes your story visible in the catalog again

Updating a Published Story​

To update a published story with new content:

  1. Edit your script in the web editor
  2. Save and validate
  3. Submit to catalog again β€” the new version will go through review