Adspirer

Telegram notifications

Bot settings

Get it from Telegram @BotFather. Encrypted at rest (Fernet).

Group chat ID (starts with -100). Send a message in the group, then open https://api.telegram.org/bot<TOKEN>/getUpdates to find it.

Save your settings first, then click "Send test message" to verify the bot can post to your group.

How it works

When do you get notified?

After every check run, the system sends a summary to your Telegram group. If ads were stopped — you see the list with reasons. If a run failed — you see the error.

Severity filter
  • Info — every run, even clean ones
  • Warn — only when ads are stopped (recommended)
  • Error — only failures (bad token, API errors)
  • Critical — effectively disables notifications
Message format

One message per check run (not per ad). If 5 ads were stopped, all 5 are listed in a single message with ad names and stop reasons.

The bot token is encrypted at rest (Fernet). Telegram API calls go directly from your server to api.telegram.org — no proxies.