# Guida utenti — verifica videobolla

Questa guida spiega **come entrare e verificarti** nel gruppo protetto dal bot.

## Lingua

Puoi cambiare la lingua dell’interfaccia in qualsiasi momento:

- comando `/lang` (anche `/lingua` o `/language`)
- oppure il pulsante 🌐 Lingua

Lingue disponibili: italiano, inglese, spagnolo, tedesco, francese, russo.

---

## Cosa ti chiede il bot

1. Entri nel gruppo (o vieni accettato se il gruppo usa le *richieste di ingresso*).
2. Il bot ti **limita** (non puoi scrivere subito).
3. Ti scrive in **privato** (se non ti ha mai scritto, apri il bot e premi **Start** / `/start`).
4. Completi eventuali passaggi di sicurezza (es. **captcha** matematico).
5. Invi in privato una **videobolla** (video rotondo).
6. Aspetti l’esito. I casi possibili:

| Esito | Cosa significa |
|-------|----------------|
| ✅ Approvato subito | Il gruppo usa l’approvazione automatica e il video rispetta la durata |
| ⏳ In valutazione | Un admin guarderà il video e deciderà: resti limitato fino alla decisione |
| ❌ Rifiutato | Il video non va bene (vedi regole di qualità sotto); a seconda delle impostazioni puoi riprovare o essere espulso |
| ⌛ Tempo scaduto | Non hai inviato il video entro il limite: la verifica si chiude e potresti essere espulso |

### Se apri tu il bot dalla lista membri

Puoi anche aprire il bot da solo: tocca il suo nome nella **lista membri** del gruppo (o cercalo), apri la chat e premi **Avvia** / `/start`. Cosa succede:

- se hai una verifica da fare o già aperta, il bot **la avvia o la riprende** e ti chiede la videobolla;
- se ti risponde che *la verifica non è attiva al momento*, significa che nel gruppo la videobolla è disattivata o il periodo di prova è terminato: in quel caso **non vieni limitato**, ma per entrare/scrivere segui le indicazioni degli amministratori.

### Il captcha (se attivo)

Prima delle istruzioni il bot può farti una domanda matematica semplice (es. “Quanto fa 3+5?”) con 4 pulsanti numerici: tocca la risposta giusta. Se sbagli, ricevi una nuova domanda: serve solo a bloccare i bot automatici.

## Come registrare la videobolla

1. Apri la chat **privata** con il bot.
2. Tocca il **microfono**.
3. **Scorri verso l’alto** per passare al video rotondo (videobolla).
4. Presentati a voce (nome, perché entri nel gruppo).
5. Invia.

## Regole di qualità (importante)

Gli admin possono **rifiutare** la verifica se:

| Problema | Esempio |
|----------|---------|
| Troppo scuro | Stanza senza luce, volto nero |
| Sfocato | Non si riconosce il volto |
| Nessun volto | Solo muro, soffitto, mano |
| Troppo corta/lunga | Fuori dal range impostato dal gruppo |
| Sospetta | Video riciclato, muto, non sei tu |

**Consiglio:** luce frontale, volto centrato, parla chiaramente, niente filtri che nascondono il viso.

## Tempi

- Hai un **timeout** (es. 30 minuti): se scade, la verifica può essere annullata e potresti essere espulso.
- Se è attiva l’**attesa minima**, aspetta qualche secondo dopo l’ingresso prima di mandare il video (anti-bot).
- Se sono attivi i **promemoria**, ricevi un messaggio circa a metà timeout e un ultimo avviso prima della scadenza.
- Se gli admin hanno configurato **orari verifica**, `/start` ti avvisa quando la verifica è temporaneamente chiusa.

## Stato, storico e retry

| Comando | Funzione |
|---------|----------|
| `/status` | Mostra lo stato corrente: in attesa video, in review, approvato, rifiutato, scaduto o revocato. Include anche il tempo rimasto |
| `/history` | Mostra le ultime verifiche registrate per il tuo account |
| `/start` | Se hai una verifica aperta, la riprende; se sei stato rifiutato e il retry è permesso, puoi inviare una nuova videobolla |

Quando un admin rifiuta può usare un **motivo preciso**:

- video troppo scuro
- video sfocato
- volto non visibile
- voce/presentazione assente
- video sospetto o riciclato

Se il rifiuto è “soft” e le impostazioni lo permettono, puoi riprovare entro la finestra scelta dagli admin.

## Dopo l’approvazione

- Ricevi un messaggio di conferma.
- Nel gruppo può apparire un **benvenuto**.
- Se è attivo il **periodo di prova (probation)**, per un po’ puoi scrivere solo testo: foto, video, sticker e link vengono cancellati automaticamente. A fine periodo ricevi un messaggio e torni ai permessi normali.
- Gli admin possono richiedere una **nuova verifica** in futuro (es. controlli periodici): in quel caso vieni limitato di nuovo e ricevi le istruzioni in privato, come la prima volta.

## Comandi utili (privato col bot)

| Comando | A cosa serve |
|---------|----------------|
| `/start` | Avvia / riprende la verifica |
| `/lang` | Cambia lingua |
| `/help` | Aiuto rapido |
| `/guida` | Indice delle guide |
| `/status` | Stato della tua verifica |
| `/history` | Storico personale verifiche |
| `/privacy` | Cosa salva il bot e per quanto |
| `/forget` | Pulisce preferenze/captcha/probation e riferimenti video locali |
| `/report ID motivo` | Segnalazione privata agli admin |

## Segnalare qualcuno (nel gruppo)

Se gli admin hanno attivato i report:

1. **Rispondi** al messaggio sospetto.
2. Scrivi: `/report motivo`

Esempio: `/report spam link scam`

Puoi anche fare una segnalazione **in privato** al bot:

```text
/report 123456789 spam in privato
```

In quel caso gli admin ricevono la segnalazione senza pubblicarla nel gruppo.

## Privacy

- Il bot salva metadati della verifica (stato, durata, ID Telegram del video).
- **Non** salva i file video sul server come cartella di filmato: usa gli ID di Telegram.
- Se è attiva la *retention*, i riferimenti ai video vecchi vengono cancellati dopo N giorni.
- `/privacy` mostra il riepilogo aggiornato.
- `/forget` elimina preferenze lingua, captcha/probation e riferimenti video locali. Resta solo lo storico minimo necessario per audit/moderazione.

## Problemi comuni

| Sintomo | Cosa fare |
|---------|-----------|
| Il bot non ti scrive | Apri il bot → `/start` |
| “Completa prima il captcha” | Tocca il numero corretto nella chat privata |
| “Attendi ancora Xs” | Aspetta e reinvia |
| Rifiutato | Rifai una videobolla più chiara o contatta un admin |
| La verifica non parte / entri senza videobolla | Il gruppo potrebbe avere la verifica non attiva o il periodo di prova gratuito scaduto: è una scelta degli admin, contattali se hai dubbi |