From b241d86f793cd8fbfd27adc095f592e0e58b656d Mon Sep 17 00:00:00 2001 From: lew Date: Fri, 10 Apr 2026 18:43:38 +0100 Subject: [PATCH] telegram: documents helptexts in the readme --- README.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e00f2bf..6552ad0 100644 --- a/README.md +++ b/README.md @@ -306,7 +306,19 @@ When Telegram moderation is enabled, voice notes are sent as voice messages in t To enable Telegram moderation, create a bot via [@BotFather](https://t.me/BotFather) and set `BOOK_TELEGRAM_BOT_TOKEN` to the token it gives you. Set `BOOK_TELEGRAM_CHAT_ID` to the chat ID where you want notifications sent: the easiest way to find this is to message the bot and check the [getUpdates](https://api.telegram.org/bot/getUpdates) endpoint. -When a visitor submits an entry, the bot sends a message with the entry details and `/allow_` and `/deny_` commands, as well as any drawing or voice note attached. Tap either command to approve or deny. If you approve something and later want to deny it, or vice versa, just hit the opposite option and it'll work as expected. +When a visitor submits an entry, the bot sends a message with the entry details and `/allow_` and `/deny_` commands, as well as any drawing or voice note attached. Tap either command to approve or deny. Denying an entry offers a `/delete_` command to remove it and its media from disk. If you approve something and later want to deny it, or vice versa, just hit the opposite option and it'll work as expected. + +The bot also registers these commands in the Telegram command menu (visible when you type `/`): + +- `/pending` — list all pending entries with previews +- `/approved` — list all approved entries +- `/denied` — list all denied entries + +Each listed entry includes a `/view_` link. Viewing an entry shows the full details, drawing, and voice note, along with `/allow_` and `/deny_` commands. + +To delete an entry and all its associated media (drawing, voice note), use `/delete_`. + +None of these commands require clicking on the links. They'll all just work by typing them in the chat to your bot. ---