👑 BESTREAMBOT ADMIN

Manuale Completo per Amministratori

Versione 2.1.0

Introduzione

BestreamBot è un bot Telegram con funzionalità avanzate di gestione IPTV. Come amministratore, hai accesso a strumenti di controllo completo del sistema e gestione di tutti gli utenti.

👑 Poteri di Amministratore:
  • Visualizzare e gestire TUTTI i clienti del sistema
  • Visualizzare statistiche di sistema complete
  • Configurare app e guide di installazione
  • Gestire ticket di supporto degli utenti
  • Monitorare dispositivi connessi
  • Accedere a strumenti avanzati di manutenzione
  • Controllare l'accesso e lo stato della piattaforma
  • Gestire broadcast e comunicazioni di sistema
  • Visualizzare tutti i caricamenti video in sospeso
  • Tutte le funzionalità disponibili ai reseller
🔴 Responsabilità Admin: Come amministratore hai accesso a dati sensibili. Usa questi strumenti con responsabilità e mantieni la riservatezza delle informazioni degli utenti.

📑 Indice

🔐 Accesso e Login

Il processo di login per gli amministratori è identico a quello dei reseller, con la differenza che il sistema riconosce automaticamente il tuo ruolo in base all'ID Telegram.

Come Fare il Login

1 Usa il Comando /login o clicca sul pulsante "🔑 Login"
2 Inserisci il Token Admin: Fornisci il tuo token di autenticazione con permessi di amministratore
3 Accesso Confermato: Il sistema verificherà il token e ti farà accedere come amministratore
👑 Dopo il login, vedrai un menu diverso con opzioni di amministrazione aggiuntive.
⚠️ Sicurezza: Il tuo token admin ha accesso completo al sistema. Non condividerlo mai con nessuno. Se compromesso, cambialo immediatamente.

👥 Gestione Utenti (Tutti i Clienti)

Come amministratore, la funzione "👤 I Miei Clienti" ti mostra TUTTI i clienti del sistema, non solo quelli associati al tuo account.

Differenze rispetto ai Reseller

Mentre i reseller vedono solo i loro clienti, come admin hai accesso a:

  • Tutti i clienti di tutti i reseller
  • Informazioni complete di ogni cliente
  • Cronologia delle operazioni
  • Possibilità di modifica diretta
  • Accesso ai dati sensibili

Visualizzazione Clienti

La lista dei clienti mostra:

Colonna Informazione
Username Identificativo unico del cliente
Reseller A quale reseller appartiene (admin può vedere tutti)
Data Scadenza Quando l'abbonamento scade
Stato Attivo/Disattivato/Scaduto
Connessioni Numero massimo consentito
Note Annotazioni del reseller

Filtri e Ricerca Avanzata

Come admin puoi utilizzare filtri avanzati:

  • Ricerca per username
  • Filtro per stato (attivo/disattivato/scaduto)
  • Filtro per reseller
  • Ordina per data scadenza
  • Visualizza clienti scaduti

Modifica Diretta di Clienti

Come admin puoi modificare direttamente i dati dei clienti:

1 Seleziona Cliente: Dalla lista, clicca sul cliente da modificare
2 Visualizza Dettagli: Vedrai tutte le informazioni disponibili
3 Modifica: Clicca su ogni campo per modificare (password, note, scadenza, ecc.)
4 Salva: Conferma le modifiche
💡 Audit Trail: Tutte le modifiche apportate ai clienti vengono registrate nei log di sistema per scopi di sicurezza e audit.

📊 Statistiche di Sistema

La funzione "📊 Le Mie Statistiche" per gli admin mostra statistiche aggreg di tutto il sistema.

Dati Disponibili

Metrica Descrizione
Crediti Totali Crediti complessivi spesi nel sistema
Numero Reseller Attivi Quanti reseller hanno account attivi
Totale Clienti Numero di tutti i clienti nel sistema
Clienti Attivi Clienti con abbonamento valido
Clienti Scaduti Clienti la cui scadenza è passata
Clienti Disabilitati Clienti disabilitati manualmente
Tasso di Attività Percentuale di clienti attivi
Uptime Sistema Tempo di operatività ininterrotta

Utilizzo delle Statistiche

  • Monitora la salute del sistema
  • Identifica tendenze di utilizzo
  • Pianifica espansioni della capacità
  • Verifica performance complessiva
  • Genera report per stakeholder
💡 Aggiornamento in Tempo Reale: Clicca "🔄 Aggiorna" per ottenere i dati più recenti. Le statistiche si aggiornano automaticamente ogni 5 minuti.

⚙️ Impostazioni di Sistema

👑 Sezione riservata ai soli amministratori

Gestione App

Gestisci quali app sono disponibili per il download dai reseller e dai loro clienti.

Visualizzare le App

Clicca su "⚙️ Impostazioni" → "📱 Gestione App" per vedere l'elenco di tutte le app:

  • Nome app
  • Piattaforma (Android, iOS, Windows, ecc.)
  • Link di download
  • Status (Attiva/Inattiva)

Aggiungere una Nuova App

1 Clicca "➕ Aggiungi App"
2 Compila il Modulo:
  • Nome app
  • Piattaforma
  • Link di download (URL pubblico)
  • Descrizione breve
  • Versione
3 Salva: L'app sarà immediatamente disponibile

Gestione Guide di Installazione

Personalizza le guide di installazione per ogni piattaforma.

Modificare una Guida Esistente

  1. Clicca su "⚙️ Impostazioni" → "📚 Guide di Installazione"
  2. Seleziona la piattaforma da modificare
  3. Modifica il testo della guida
  4. Clicca "💾 Salva Modifiche"

Piattaforme Disponibili

Puoi personalizzare guide per:

  • Android
  • iOS
  • Windows
  • macOS
  • Smart TV
  • Amazon Firestick
💡 Markdown Supportato: Le guide supportano formattazione Markdown (grassetto, corsivo, elenchi, ecc.)

Impostazioni di Sistema Generali

Configura parametri globali del sistema:

Impostazione Descrizione
Manutenzione Programmata Pianifica finestre di manutenzione
Messaggi di Sistema Personalizza messaggi inviati agli utenti
Limite di Velocità API Configura limiti di richieste API
Timeout Sessione Tempo di inattività prima della disconnessione
Log Level Livello di dettaglio dei log di sistema

🛡️ Gestione Assistenza (Ticket)

👑 Sezione riservata ai soli amministratori

Gestisci tutti i ticket di supporto creati dai reseller e dai loro clienti.

Visualizzare Ticket Aperti

Clicca su "🛡️ Gestione Assistenza" → "📬 Ticket Aperti" per visualizzare tutti i ticket non ancora risolti.

Per ogni ticket vedrai:

  • ID Ticket unico
  • Mittente (reseller o cliente)
  • Categoria (Contenuto, Dispositivo, Rinnovo, ecc.)
  • Soggetto/Titolo
  • Data di creazione
  • Stato (Nuovo/In Lavorazione)
  • Priorità

Rispondere a un Ticket

1 Seleziona Ticket: Clicca sul ticket da gestire
2 Visualizza Conversazione: Leggi tutti i messaggi precedenti
3 Componi Risposta: Scrivi la tua risposta al mittente
4 Cambia Stato (Opzionale): Puoi contrassegnare come "In Lavorazione" o "Risolto"
5 Invia: La risposta verrà notificata al mittente

Gestire Ticket Completati

Accedi a "✅ Ticket Completati" per visualizzare i ticket risolti. Puoi:

  • Visualizzare la conversazione completa
  • Riaprire se necessario
  • Aggiungere note private
  • Generare report

Filtri Avanzati per Ticket

Filtro Opzioni
Per Categoria Contenuto, Dispositivo, Rinnovo, Generale
Per Stato Nuovo, In Lavorazione, Risolto, Chiuso
Per Priorità Bassa, Normale, Alta, Critica
Per Data Oggi, Questa Settimana, Questo Mese
Per Mittente Ricerca per username
💡 SLA (Service Level Agreement): Imposta risposte automatiche basate su SLA. I ticket critici dovrebbero essere gestiti entro 1 ora, normali entro 24 ore.

🛠️ Strumenti Amministrativi

👑 Opzioni Admin nel Menu Strumenti

Verifica Dispositivi

Monitora tutti i dispositivi connessi al sistema e le sessioni attive.

Informazioni disponibili:

Info Descrizione
Cliente Username del cliente connesso
Dispositivo Tipo di dispositivo (TV, Mobile, PC, ecc.)
IP Indirizzo IP del dispositivo
Ultimo Accesso Quando il dispositivo si è connesso per l'ultima volta
Stato Attivo/Inattivo/Offline

Puoi:

  • Visualizzare all'istante i dispositivi attivi
  • Verificare connessioni anomale
  • Terminare sessioni sospette
  • Bloccare indirizzi IP specifici

Stato Server

Monitora lo stato di salute di tutti i server:

  • CPU Usage
  • Memoria RAM
  • Spazio Disco
  • Larghezza di Banda
  • Numero di Connessioni Attive
  • Uptime del Server
💡 Avvisi Automatici: Ricevi notifiche se una risorsa supera il 90% di utilizzo.

Manutenzione del Sistema

Esegui operazioni di manutenzione sul sistema:

Pulisci Cache

Svuota la cache del sistema per liberare memoria:

  1. Clicca "🛠️ Strumenti" → "🧹 Pulisci Cache"
  2. Seleziona cosa pulire (Cache Generale, Cache API, Cache Video)
  3. Conferma l'operazione

Sincronizza Database

Sincronizza il database principale:

  1. Clicca "🛠️ Strumenti" → "📊 Sincronizza Database"
  2. Il sistema controllerà l'integrità dei dati
  3. Riparerà eventuali inconsistenze

Backup Sistema

Crea backup di sicurezza:

  1. Clicca "🛠️ Strumenti" → "💾 Backup"
  2. Scegli cosa includeere (Database, Configurazioni, File)
  3. Il backup verrà salvato in una posizione sicura
⚠️ Attenzione: La sincronizzazione del database può causare un breve downtime. Eseguila durante le ore di basso utilizzo.

Broadcast di Sistema

Invia messaggi a tutti gli utenti o a un gruppo specifico:

1 Clicca "🛠️ Strumenti" → "📢 Broadcast"
2 Seleziona Destinatari: Tutti, Solo Admin, Solo Reseller, O un Gruppo Specifico
3 Componi Messaggio: Scrivi il messaggio (supporta Markdown)
4 Pianifica (Opzionale): Scegli di inviare subito o pianificare per dopo
5 Invia: Conferma e il messaggio verrà distribuito

Gestione Video Caricati

Rivedi e approva i video caricati dai reseller:

Clicca "🛠️ Strumenti" → "📹 Gestione Upload Video" per visualizzare:

  • Video in Sospesa (in attesa di approvazione)
  • Video Approvati (pubblicati nel catalogo)
  • Video Rifiutati (con motivo del rifiuto)

Azioni Disponibili:

Azione Descrizione
Approva Pubblica il video nel catalogo
Rifiuta Rifiuta il video (con motivo)
Anteprima Visualizza una clip del video
Dettagli Vedi metadati completi
📋 Verifica Copyright: Prima di approvare, verifica che il contenuto sia legittimo e non in violazione di copyright.

Controllo Accesso Piattaforma

Abilita/Disabilita l'accesso alla piattaforma per manutenzione:

  • Disabilita accesso per manutenzione programmata
  • Consenti accesso solo agli admin
  • Personalizza messaggio di manutenzione
  • Imposta orario di fine manutenzione
⚠️ Impatto Utenti: Quando disabiliti l'accesso, tutti gli utenti tranne gli admin riceveranno il messaggio di manutenzione.

🔄 Funzioni Comuni (Condivise con Reseller)

Come amministratore, hai accesso a TUTTE le funzioni disponibili ai reseller, più le funzioni amministrative. Questo include:

Per informazioni dettagliate su queste funzioni, fai riferimento al Manuale del Reseller.

🔒 Manutenzione e Sicurezza

Best Practices di Sicurezza

Come Amministratore, segui questi consigli:

  • Cambia regolarmente la password del tuo account (ogni 90 giorni)
  • Non condividere mai il token admin con nessuno
  • Usa l'accesso da dispositivi sicuri
  • Monitora regolarmente l'attività di sistema
  • Esegui backup frequenti (almeno settimanali)
  • Revoca l'accesso ai reseller inattivi
  • Mantieni il sistema aggiornato

Monitoraggio Attività

Controlla regolarmente i log di sistema per identificare:

  • Accessi non autorizzati
  • Modifiche anomale di dati
  • Picchi di utilizzo risorse
  • Errori di sistema
  • Attività sospette

Accedi ai log: Clicca "🛠️ Strumenti" → "📋 Log di Sistema"

Aggiornamenti Sistema

Mantieni il bot aggiornato:

  1. Controlla regolarmente disponibilità di aggiornamenti
  2. Leggi le note di rilascio prima di aggiornare
  3. Pianifica aggiornamenti durante il downtime programmato
  4. Esegui backup prima di qualsiasi aggiornamento

❓ Domande Frequenti per Admin

Come faccio a ripristinare un database corrotto?

Usa la funzione "📊 Sincronizza Database" nel menu Manutenzione. Il sistema ripeterà automaticamente gli errori. Se questo non funziona, ripristina l'ultimo backup disponibile.

Un reseller ha perso il suo token. Come posso aiutarlo?

Come admin, puoi rigenerare il token per un reseller dal pannello di gestione. Il reseller riceverà un nuovo token via email. Non condividere mai il token direttamente nel bot.

Come posso bloccare un utente malevolo?

Usa la funzione "🛡️ Blocca Utente" dal menu di gestione utenti. L'utente non potrà più accedere. Puoi anche bloccare indirizzi IP specifici dal monitoraggio dispositivi.

Qual è il limite massimo di clienti per reseller?

Non c'è limite tecnico, ma puoi impostare limiti per reseller specifici dal pannello di gestione. Questo è utile per controllare crescita e distribuzione di carico.

Come genero un report di attività?

Clicca "📊 Statistiche di Sistema" e poi "📄 Genera Report". Puoi scegliere l'intervallo di tempo e i dati da includere. Il report verrà generato in formato PDF.

Posso limitare la larghezza di banda per cliente?

Sì, durante la creazione del pacchetto puoi specificare limiti di banda. Questo verrà applicato a tutti i clienti con quel pacchetto.

Come faccio a notificare un broadcast a tutti gli utenti?

Usa la funzione "📢 Broadcast" nel menu Strumenti. Scegli "Tutti gli Utenti" come destinatari, componi il messaggio e invialo. Verranno notificati al massimo entro 5 minuti.

Il sistema dice "spazio disco insufficiente". Cosa faccio?

Innanzitutto, pulisci la cache dal menu Manutenzione. Se persiste, elimina file temporanei obsoleti o archivia dati vecchi. Se il problema persiste, contatta il provider per espandere lo storage.