Skip to content

v1.18.0 — Telegram operator integration

Choose a tag to compare

@KingPin KingPin released this 01 Jul 04:48

Telegram operator integration — get pinged, moderate, and query Garrul from Telegram.

Highlights

  • Telegram outbound adapter — pick telegram in /admin/webhooks and store a chat id. Notifications arrive as messages with inline moderation buttons, reusing the existing per-event filter + retry queue.
  • Interactive moderation — approve / spam / restore / delete / ban author / resolve reports straight from a button tap, through the same audited path as the dashboard (actions are attributed to your linked operator id). Buttons reflect the comment's current status, not the event, so flagging spam sends back a fresh "Not spam" message and vice-versa.
  • Slash commands (read-only) — /queue, /stats, /comment <id>, /user <id>.
  • Optional daily digest — a once-daily operator summary on the existing */15 cron.

Notes for upgraders

  • Off by default. Nothing changes unless you set TELEGRAM_BOT_TOKEN. Inbound buttons/commands additionally need TELEGRAM_WEBHOOK_SECRET + a one-time setWebhook call. TELEGRAM_BOT_USERNAME (plain var) enables the one-tap link on /admin/telegram.
  • New migration 0014_telegram.sql (telegram_links) — additive. Run npm run migrate (or -- --remote for prod).
  • No breaking changes. Existing generic/Slack/Discord webhooks are unaffected.
  • Setup guide: docs/telegram.md.

What's Changed

  • feat: Telegram operator integration (notifications, moderation, queries, digest) by @KingPin in #39

Full Changelog: v1.17.0...v1.18.0