Docs / Management / Daily Tip

Daily Tip — One feature a day

OmniGest has so many options that it is easy for an admin to never discover 70% of what they already paid for. Daily Tip fixes that by posting 1 feature a day (at 09:00 Madrid time) with a link to the docs, so nobody stays stuck with the "only replies to greetings" version of the bot.

How it works

Every day at 09:00 Europe/Madrid the bot rotates through a catalogue of tips (23 entries in Spanish and English) and sends 1 message with:

  • Tip title
  • Short explanation (2-3 sentences)
  • Direct link to omnigestbot.com with the relevant section

Rotation is per-group or per-user depending on the delivery mode — every destination sees different tips on the same day, there is no global sync.

Three delivery modes per group

In /config → 💡 Daily Tip the admin picks one of these modes:

Mode Behaviour Use case
To group (default) Tip lands in the shared chat Passive onboarding, everyone sees it
DM to admins Tip is sent privately to each admin Train admins without spamming the group
Both Lands in the group AND in admin DMs Maximum coverage

The post-migration default is To group, which preserves the previous behaviour for legacy groups.

DM mode with dedupe

If the same admin manages 5 groups in "DM to admins" mode, they still get 1 tip per day, not 5. Dedupe is by user_id, so you never flood their bot conversation.

Personal opt-out

Any admin can silence tips by DM without having to block the bot (which would break captcha, reports, and other DM flows):

/dailytips off    # in DM with the bot
/dailytips on
/dailytips        # show current state

Opt-out only affects personal DMs. Group tips keep arriving if the admin has "To group" enabled in /config.

Per-group vs per-user state

OmniGest tracks two independent rotation states:

  • daily_tip_state — latest catalogue position per group. If your group is in "To group" mode, tomorrow's tip is the next in order from the last one that group received.
  • daily_tip_user_state — latest position per user. If you receive tips by DM (because you are admin of several groups in DM mode), your personal rotation is independent from each group's.

That is why an admin of 3 groups can see different tips in group A, in group B (if they run different modes) and in their personal DM.

Safety filters

The bot skips:

  • Bot accounts as DM recipients (no point messaging another bot)
  • Anonymous admins (is_anonymous=true) — no real user_id to DM
  • Users who ran /dailytips off

If an admin blocks the bot, the send fails silently and is not retried until the next day.

Global kill-switch

The owner can disable the entire job via .env:

DAILY_TIP_ENABLED=false

With it set to false: - The 09:00 cron does not run. - /dailytips in DM replies with a "feature disabled" notice. - Per-group toggles still save but do not send.

Why this matters

The #1 cause of Telegram bot churn is invisible functionality: the admin paid for the bot, added it, and a week later they only use 5% of it because they never discovered the rest. Daily Tip is an education drip: 23 tips × 1 per day = three and a half weeks of effortless discovery. When the catalogue cycles, it starts again — passive reminders of features the group already knows, but a new admin still does not.