← Back to Home

User Manual

NewsLilly User Manual

This manual describes the current version of the bot (May 2026). If the UI looks different β€” update Telegram and hit /start again, the bot will pick up the latest screens.

What is NewsLilly

NewsLilly is a personal news editor inside Telegram. You connect the bot to your channel, tell it where to take content from (RSS feeds, websites, other Telegram channels), which topics you care about (keywords), and when to publish β€” and the bot collects, filters, ranks by relevance and publishes everything on schedule.

The FREE plan gives you one channel and standard publishing. The PRO plan unlocks multiple channels, AI content personalization, AI-generated images, advanced media handling and 20-minute publish cadence.


Quick Start

Step 1. Find the bot and launch it

  1. Open Telegram.
  2. Find the bot @newslilly_bot.
  3. Send /start.

πŸ’‘ Tip: start with a test channel. If you plan to eventually connect NewsLilly to a main channel that already has subscribers, we recommend creating an empty test channel first and setting the bot up there. You'll be able to fine-tune sources, keywords and schedule, see how posts actually look, and only then connect the bot to your main channel β€” without risking raw, unpolished posts in front of a live audience. If you don't have subscribers yet, a test channel isn't necessary β€” you can configure the main one straight away.

Step 2. Pick the interface language

After /start the bot will offer a language picker. Russian, English, EspaΓ±ol and Deutsch are supported. This is the language of menus and prompts β€” content language is set separately.

Step 3. Begin setup

  • New user β†’ tap πŸš€ Set up bot. The setup wizard opens.
  • Returning user β†’ you'll see your home screen with a short channel summary, the βš™οΈ Settings button and (for FREE) a πŸ’Ž Upgrade to PRO button.

The setup wizard

The wizard walks you through 9 short steps. Many screens briefly show a small robot mascot video β€” it's just a hint that auto-dismisses after ~3.5 s and never blocks you.

You can hit β—€ Back at any point to revise the previous step.

Step 1. Bind the channel

  1. Create a channel in Telegram or pick an existing one.
  2. Add the bot as an administrator of the channel with posting permission.
  3. Enter the channel handle: @your_channel or the link t.me/your_channel.
  4. The bot will verify permissions and confirm.

If the bot reports "no posting permission" β€” open channel settings β†’ Administrators β†’ the bot β†’ enable "Post messages".

Step 2. Source language

You choose which languages the bot should look for articles in: Russian, English or both. This drives:
- which sources the AI helper suggests,
- which keyword phrases are recommended,
- how the bot understands article text during filtering.

Step 3. Translation (FREE and PRO)

If your content sources and your audience speak different languages, enable translation:
- Don't translate β€” publish as-is.
- Translate to Russian / English β€” the bot translates the article before publishing (FREE uses offline translation, PRO uses neural translation with style preservation).

Step 4. Keywords

The "interest filter". The bot gathers all articles from your sources and keeps the ones where your keys appear. Two ways to set them:

Manual β€” type 5–30 words and phrases separated by commas or newlines. Multi-word phrases work better: "venture rounds" beats just "startup".

AI helper β€” describe your channel topic in one sentence ("a channel about sailing and yacht racing"), the AI generates a balanced set of ~25 keys: broad, mid and niche. You can accept, regenerate or extend it manually.

AI helper limits: FREE β€” 2 requests/day, PRO β€” 5.

Step 5. Content sources

Three ways to add sources:

πŸ“š Catalog β€” vetted RSS feeds grouped by category: News, Tech, Sports, Business, Science and more.

πŸ€– AI helper β€” describe your niche, the bot suggests up to 10 sources (mix of RSS, Telegram channels and websites) tailored to your keywords and language. It uses a hybrid: catalog lookup + real MTProto search across Telegram + AI generation.

⌨️ Manual (PRO only) β€” add any RSS, Telegram channel or website URL. The bot validates the feed before adding.

Source limit: FREE β€” up to 10, PRO β€” unlimited.

Step 6. Publishing mode

πŸ”„ Re-Publish β€” original text and media with source attribution. Use when accuracy and source licence compliance matter most.

πŸ€– AI Personalization (PRO) β€” the bot rewrites the text in your chosen style, strips promotional inserts and can replace images with AI-generated ones. Use for authored channels with a consistent voice.

More detail in the Publishing Modes section below.

Step 6: pick a publishing mode β€” Re-Publish or AI Personalization (PRO)
Step 6: pick a publishing mode β€” Re-Publish or AI Personalization (PRO)

Step 7. Schedule

  1. Timezone β€” pick from major cities (Moscow, London, New York…) or set a UTC offset.
  2. Days of week β€” all days, weekdays only, weekends only, or any custom set with checkboxes.
  3. Publish hours β€” choose specific hours on a 0–23 grid.
  4. Minimum interval β€” guarantees at least N hours between two publications (prevents bunching when hour ranges overlap).

Step 8. Test publication

The bot runs a full real-mode cycle: pulls fresh articles from your sources, filters by keywords, picks the best one and publishes it to your channel right now.

This is how you verify:
- the bot can actually post to the channel,
- sources return fresh content,
- keywords match something,
- images/videos attach correctly.

If anything's off β€” πŸ”§ Fix it sends you back to the relevant step.

Step 9. Final summary

Congratulatory screen with a short summary: channel, languages, keyword count, source count, schedule. The bot flips to active mode and starts working on schedule.

Step 9: final summary and channel activation
Step 9: final summary and channel activation

/settings β€” channel settings

The /settings command (or the βš™οΈ Settings button) opens the full set of controls. The layout differs slightly between FREE and PRO.

FREE β€” one channel, flat menu:
- 🌍 Interface language
- πŸ“Ί Change channel
- 🌐 Content language
- πŸ”„ Translation settings (if content language β‰  audience language)
- πŸ“° Source management
- ⏰ Schedule
- πŸ” Keywords
- 🟒/πŸ”΄ Enable / disable bot
- πŸ’Ž Upgrade to PRO

PRO β€” multiple channels, channel picker first:
- List of your channels β†’ pick channel β†’ that channel's settings menu
- Extras: publishing mode, AI style, media source, AI image generation, limits


Managing sources

Open βš™οΈ Settings β†’ πŸ“° Sources or just /sources.

The list shows every connected source with its type (πŸ“± Telegram, πŸ“‘ RSS, 🌐 Website) and a short status. Available actions:

  • πŸ“š Add from catalog β€” categories and topics.
  • πŸ€– AI helper β€” describe topic, get suggestions.
  • ⌨️ Add manually β€” RSS URL, @channel or website URL (PRO).
  • πŸ” Test sources β€” diagnostic: the bot walks every source and shows how many articles in the last 24 h matched your keywords. Useful to see which sources actually bring content.
  • πŸ—‘οΈ Delete source β€” pick by number.

If an RSS feed dies (404/403), the bot will tell you and offer a replacement via the automated RSS replacement pipeline β€” it finds a working alternative on the same topic.


Keywords and filtering

How the bot picks articles

  1. Pulls fresh material from all your sources for the last ~24 h.
  2. Compares each article's body and title against your keys.
  3. Assigns a relevance score: more matches and rarer keys β†’ higher score. Bonuses: +20 for an image, +30 for a media group, +50 for video.
  4. Sorts and publishes the best ones according to your schedule. Previously published articles are excluded (deduplication).

Good vs bad keys

βœ… Works well ❌ Works poorly
"Tesla electric cars" "cars"
"quantum computing" "tech"
"Maxi 72 yacht racing" "sports"

Narrower phrasing β†’ sharper results.

Editing keys

In βš™οΈ Settings β†’ πŸ” Keywords you can:
- view the current list,
- add/remove individual keys,
- clear and start over,
- run the AI helper to regenerate from a new topic.


Publishing schedule

Open βš™οΈ Settings β†’ ⏰ Schedule. Same steps as the wizard, editable anytime.

Frequency

Mode FREE PRO Best for
Every 2 days βœ… βœ… Curated digests
Daily βœ… βœ… Topic channels
Twice daily βœ… βœ… Balanced cadence
Every 20 minutes β€” βœ… Breaking-news, aggregators

Days and hours

  • Days β€” any subset: weekdays only, weekends only, specific days.
  • Hours β€” exact 0–23 grid in your selected timezone.
  • Minimum interval between publications β€” protects against bunching in overlapping hours.

Publishing modes

πŸ”„ Re-Publish

Original text is posted without rewriting. The bot:
- preserves author style and facts,
- automatically adds a source link,
- adapts formatting for Telegram (HTML, emoji, line breaks),
- assembles media carousels following the right rules.

Use this for aggregator and news channels where verbatim accuracy matters.

πŸ€– AI Personalization (PRO)

The bot runs each article through GPT-4o-mini and rewrites it in your channel's voice:
- strips promo inserts and "subscribe to us" calls,
- adapts tone (professional / casual / technical),
- adjusts length (short / medium / full),
- targets your audience (set in channel style),
- can replace the image with an AI-generated one (Gemini 2.5 Flash β†’ DALL-E 3 fallback) using the original image as a visual reference.

Source attribution is always kept β€” that's a licence requirement.


Media: images and video

Image source

In PRO channel settings, pick where to take the picture from:

  • Original from the article β€” maximum relevance, available on FREE too.
  • Unsplash β€” millions of professional photos by context, commercial licence (PRO).
  • AI generation β€” unique image per article, Gemini 2.5 Flash with DALL-E 3 fallback, caching, prompt neutralisation (PRO).

Video

PRO users get up to 3 videos per post with scoring priority. Sources:
- videos from Telegram channels via MTProto,
- embedded YouTube/Vimeo iframes in articles,
- OG video tags and Schema.org VideoObject,
- YouTube links with auto-preview.

Before publishing the bot verifies availability β€” broken videos fall back to images.

Publishing strategy with media

When an article has several images/videos, the bot publishes them as a media group with no caption, and sends the full text as a separate reply message. This gives better readability: the gallery stays a gallery, and the text isn't truncated by Telegram's 1024-char caption limit.


Multiple channels (PRO)

PRO lets you manage an unlimited number of channels. After /settings you first pick the channel, then access the standard settings menu for that channel.

Useful patterns:
- Main + backup β€” one channel runs, the second mirrors with a different schedule or language.
- Regional versions β€” one channel in Russian, the second in English with auto-translation.
- Topic verticals β€” a general channel and narrower ones with different keys.

The bot isolates data per channel: keywords, sources, schedules are independent. One subscription per user.


PRO subscription and billing

Open πŸ’³ Billing or run /billing.

Plans

Plan Price Per-month equivalent Save
Monthly $18.90 / mo $18.90 β€”
Semi-annual $85.05 / 6 mo $14.18 βˆ’25%
Annual $136.08 / yr $11.34 βˆ’40%

All prices in USD, Telegram converts to your local currency for display.

Payment method

Payment is currently accepted in crypto only, via NOWPayments:
- Supported currencies: BTC, ETH, USDT and other popular coins.
- One-off payment for the chosen period (no auto-renewal and no stored card).
- When the paid period ends, top up manually to extend PRO.

Card payments are temporarily disabled. We'll update this manual once they're back.

What's in PRO

  • AI Personalization, smart adaptation and auto-tuning
  • AI image generation (Gemini 2.5 Flash + DALL-E 3 fallback)
  • Unsplash as a media source
  • Videos in posts (up to 3 per post)
  • Extended media groups (up to 10 photos + 3 videos)
  • Every-20-minutes cadence
  • Multiple channels
  • Extended source validation
  • Priority support

Managing your subscription

  • πŸ”„ Refresh status β€” sync with the provider after a payment.
  • πŸ“… Expiry date β€” /billing shows when the current PRO period ends.
  • βž• Extend β€” pay for the next period before the current one ends to keep PRO uninterrupted.
  • End of period β€” if you don't extend, the channel automatically switches to FREE with no loss of data or settings.

/status β€” channel dashboard

The /status command shows a live summary:

  • Plan type (FREE / PRO) and status (active / disabled)
  • Current channel and its settings
  • Source count and keyword count with limit progress bars
  • Schedule: timezone, days, hours, last run
  • Next run β€” exact time of the next publication
  • For FREE β€” an upsell block with PRO benefits

Commands

Command What it does
/start Welcome, language picker, home screen
/setup Re-run the setup wizard
/settings Channel settings
/sources Manage sources
/status Channel summary
/billing Subscription and payment
/help Brief command help

Troubleshooting

The bot publishes nothing

Check in order:

  1. /status β†’ "Bot: active". If disabled β€” enable in βš™οΈ Settings.
  2. Channel permissions. The bot must be an admin with "Post messages".
  3. Schedule. The "Next run" hint in /status β€” if it's 8 hours away, the current time isn't inside a publishing window.
  4. Sources alive. Open /sources β†’ πŸ” Test sources β€” you'll see which feeds respond and how many articles match your keys.
  5. Keys find content. If all sources return zero matches β€” your phrases are too narrow or don't match the source language. Use the AI helper to rebuild.

Content publishes but in the wrong language

  • Open βš™οΈ Settings β†’ 🌐 Content language and check it matches your sources.
  • For automatic translation β€” enable πŸ”„ Translation settings β†’ Translate to….

Images or videos don't load

  • The source may be blocking bots (HTTP 403). The bot will automatically try Unsplash/AI as a replacement if enabled.
  • In AI Personalization mode (PRO) make sure the correct image source is selected in media settings.

AI helper limits ran out

FREE β€” 2 requests/day, PRO β€” 5. The counter resets at midnight UTC. The limit is per-channel for PRO.

I want to delete a channel and start over

βš™οΈ Settings β†’ πŸ“Ί Change channel β€” the bot drops the binding and re-runs the wizard. All settings for that channel are wiped, but publication history is preserved as duplicate protection.

Where to write if none of this helps

Support: support@newslilly.com or just type /help in the bot. PRO users get priority replies.


FAQ

Can I use the bot without a public channel?
Yes β€” a private channel works too, the bot just needs to be an admin in it.

Does the bot store my texts?
Only publication metadata for duplicate protection: article hash, title, source URL, time. Full texts are not stored.

What happens if I cancel PRO?
Until the paid period ends β€” all PRO features keep working. After that the channel switches to FREE with no data loss, but PRO features (multiple channels, AI Personalization etc.) are turned off.

Can I publish to other social networks at the same time as Telegram?
Telegram only for now. Other platforms are on the roadmap.

Is Russian fully supported in AI modes?
Yes, fully. AI Personalization, the AI keyword helper and the AI source helper all work bilingually RU/EN.