feat: attach video to help message

Author: ArtemSBulgakov

settings.schema.yaml

@@ -143,6 +143,13 @@ $defs:
         description: MongoDB collection name for FSM
         title: Database Collection Name
         type: string
+      help_video_id:
+        anyOf:
+        - type: string
+        - type: 'null'
+        default: null
+        description: ID of the video to send as help message
+        title: Help Video Id
     required:
     - bot_token
     - database_uri

src/bot/shared_messages.py

@@ -1,8 +1,11 @@
 from aiogram import html
+from aiogram.exceptions import TelegramBadRequest
 from aiogram.fsm.context import FSMContext
 from aiogram.fsm.state import default_state
 from aiogram.types import CallbackQuery, Message
 
+from src.config import settings
+
 MAX_WIDTH_FILLER = " " * 100 + "‍"
 
 HELP_HTML_MESSAGE = """
@@ -32,10 +35,15 @@
 
 
 async def send_help(message: Message):
-    await message.answer(
-        HELP_HTML_MESSAGE,
-        disable_web_page_preview=True,
-    )
+    video_id = settings.bot.help_video_id
+    if not video_id:
+        await message.answer(HELP_HTML_MESSAGE, disable_web_page_preview=True)
+        return
+
+    try:
+        await message.answer_video(video_id, caption=HELP_HTML_MESSAGE, disable_web_page_preview=True)
+    except TelegramBadRequest:
+        await message.answer(HELP_HTML_MESSAGE, disable_web_page_preview=True)
 
 
 async def go_to_default_state(callback_or_message: CallbackQuery | Message, state: FSMContext):

src/config_schema.py

@@ -94,6 +94,8 @@ class BotSettings(SettingBaseModel):
     "MongoDB database name for FSM"
     database_collection_name: str = "aiogram_fsm"
     "MongoDB collection name for FSM"
+    help_video_id: str | None = None
+    "ID of the video to send as help message"
 
 
 class Settings(SettingBaseModel):