refactor(welcome): update verification flow and improve message handling

- Modified the welcome message to direct users to click a link after reading the rules.
- Introduced a new argument for the verification function to streamline user verification.
- Refactored the private message handler to check for secret commands and verify users globally.
- Enhanced user feedback for verification status and command recognition.

Author: MattiaFailla

src/python_italy_bot/handlers/welcome.py

@@ -123,7 +123,7 @@ async def _handle_start(
         if rules_url:
             await message.reply_text(
                 f"Per completare la verifica, leggi il regolamento:\n{rules_url}\n\n"
-                "Dopo averlo letto, invia il comando segreto che troverai."
+                "Dopo averlo letto, clicca sul link 'Ho letto il CoC' in fondo alla pagina."
             )
         else:
             captcha_content = captcha_service.get_captcha_file_content()
@@ -136,34 +136,22 @@ async def _handle_start(
                 await message.reply_text(
                     "Invia il comando segreto per completare la verifica."
                 )
+    elif args and args[0] == "CoCDoneLink":
+        await _verify_user(user, captcha_service, context, message)
     else:
         await message.reply_text(
             "Ciao! Sono il bot di Python Italia.\n"
             "Se devi completare la verifica per un gruppo, usa il pulsante nel messaggio di benvenuto."
         )
 
 
-async def _handle_private_message(
-    update: Update,
+async def _verify_user(
+    user,
+    captcha_service: CaptchaService,
     context: ContextTypes.DEFAULT_TYPE,
+    message,
 ) -> None:
-    """Handle private messages: check for secret command and verify user globally."""
-    captcha_service: CaptchaService = context.bot_data["captcha_service"]
-    message = update.message
-    if message is None or message.text is None:
-        return
-
-    user = update.effective_user
-    if user is None:
-        return
-
-    if not captcha_service.is_secret_command(message.text):
-        await message.reply_text(
-            "Comando non riconosciuto. Leggi il regolamento "
-            "e invia il comando segreto che troverai."
-        )
-        return
-
+    """Verify a user globally and unrestrict in all pending groups."""
     if await captcha_service.is_globally_verified(user.id):
         await message.reply_text(
             "Sei già verificato! Puoi partecipare alle discussioni in tutti i gruppi."
@@ -174,7 +162,7 @@ async def _handle_private_message(
     if not pending_chats:
         await message.reply_text(
             "Non hai gruppi in attesa di verifica. "
-            "Se hai appena inviato il comando, la verifica potrebbe essere già stata applicata."
+            "Se hai appena completato la verifica, potrebbe essere già stata applicata."
         )
         return
 
@@ -196,3 +184,27 @@ async def _handle_private_message(
         "Verifica completata! Ora puoi partecipare alle discussioni "
         "in tutti i gruppi Python Italia."
     )
+
+
+async def _handle_private_message(
+    update: Update,
+    context: ContextTypes.DEFAULT_TYPE,
+) -> None:
+    """Handle private messages: check for secret command and verify user globally."""
+    captcha_service: CaptchaService = context.bot_data["captcha_service"]
+    message = update.message
+    if message is None or message.text is None:
+        return
+
+    user = update.effective_user
+    if user is None:
+        return
+
+    if not captcha_service.is_secret_command(message.text):
+        await message.reply_text(
+            "Comando non riconosciuto. Leggi il regolamento "
+            "e invia il comando segreto che troverai."
+        )
+        return
+
+    await _verify_user(user, captcha_service, context, message)