Passo per passo
- 01
Preparati e apri la sezione
Ti serve almeno un account con stato «Attivo» e un abbonamento attivo, altrimenti ricevi «Nessun account attivo trovato» o «L'abbonamento non è attivo». Nel menu di sinistra premi «Scraping». In alto ci sono i riquadri «Lavori», «In corso», «Utenti raccolti». A sinistra c'è la scheda «Lavori», a destra «Risultati».
- 02
Premi «Nuovo lavoro di scraping» e scegli una modalità
Nella finestra «Nuovo lavoro di scraping», nel blocco «Chi raccogliere», scegli una scheda: «Membri del gruppo», l'elenco dei membri di un gruppo aperto; «Hanno scritto nel gruppo», gli autori dei messaggi recenti (funziona anche se l'elenco dei membri è nascosto); «Commentatori del canale», gli autori dei commenti ai post; «Pubblico del canale», i membri del gruppo di discussione più i commentatori. Sotto le schede la riga «Fonte: …» ti dice cosa inserire.
- 03
Indica la fonte
Nel campo «Gruppo» (le prime due modalità) o «Canale» (le ultime due) inserisci uno @username, un link t.me/nome o un link di invito (t.me/+…). Con un link di invito l'account entra nel gruppo: è un'azione reale su Telegram. Il pulsante di avvio si attiva da 3 caratteri.
- 04
Imposta i limiti per la modalità
«Membri del gruppo»: «Limite membri» (5.000–200.000, default 50.000). «Hanno scritto nel gruppo»: «Messaggi recenti» (100–20.000, default 2.000), «Intervallo di tempo», «Minimo messaggi per persona». «Commentatori del canale»: «Post recenti» (10–500, default 100), «Intervallo di tempo dei post», «Minimo commenti per persona». «Pubblico del canale»: «Post recenti», «Intervallo di tempo dei post», «Limite membri del gruppo di discussione». Ogni lavoro ha 2 ore a disposizione.
- 05
Scegli l'account e il pubblico per il risultato
«Account»: «Qualsiasi attivo» o uno specifico (gli account con proxy sono segnati «· proxy»). «Salva in pubblico»: «Non aggiungere (salvo a mano)» o un pubblico esistente: in quel caso le persone vengono aggiunte automaticamente senza duplicati.
- 06
Attiva i filtri e avvia
Il blocco «Filtri sui risultati»: «Solo con username» (attivo di default), «Solo con foto», «Solo Premium», l'elenco «Ultimo accesso entro». Premi «Avvia: <modalità>». Ricevi «Scraping avviato» e il lavoro compare nell'elenco a sinistra.
- 07
Segui l'avanzamento
Badge: «In coda», «In corso» («Elaborati: N · trovati: N»), «Fatto» («Trovati» e «Dopo i filtri»), «Errore» (il motivo in rosso). L'elenco si aggiorna ogni 4 secondi. L'icona quadrata «Ferma» sposta il lavoro in «Errore» con il testo «Annullato dall'utente»; quello che è stato raccolto resta («Salvato parzialmente: N»).
- 08
Esamina i risultati
La scheda «Risultati · @fonte»: modalità, titolo, numero di persone. I chip «Tutti · N», «Membro · N», «Ha scritto · N», «Ha commentato · N» filtrano la tabella. Colonne: «Utente», «Username», «Fonte», «Messaggi», «Ultimo accesso». Vengono mostrate le prime 200 righe: «Mostrate le prime 200 di N. L'elenco completo è nel CSV o nel pubblico».
- 09
Salva: «In pubblico» o «CSV»
I pulsanti esistono solo sui lavori «Fatto». «CSV» scarica il file parsing_<id>.csv. «In pubblico» apre la finestra «Salva come pubblico». L'opzione «Pubblico unico»: «Gruppo (facoltativo)», «Nome del pubblico» → «Salva». L'opzione «Dividi in parti»: «Prefisso del nome», «Dimensione di ogni parte» (default 25) → «Dividi e salva». I pubblici compaiono nella sezione «Pubblici».
- 10
Elimina un lavoro che non ti serve
L'icona del cestino «Elimina» → «Eliminare il lavoro e tutti i suoi risultati?». Il lavoro e le persone raccolte spariscono definitivamente; i pubblici creati da esso restano.
Campi e impostazioni
- Chi raccogliere
- La modalità di raccolta. Per un canale funzionano solo «Commentatori del canale» e «Pubblico del canale».
- Gruppo / Canale (fonte)
- Uno @username, un link t.me/… o un link di invito. Per un gruppo privato l'account deve già essere membro, altrimenti ricevi «Il canale/gruppo è privato — l'account non ha accesso».
- Limite membri
- Il numero massimo di membri (5.000–200.000). Nei gruppi con più di ~10.000 persone Telegram non restituisce l'intero elenco, quindi il sistema lo «completa» cercando lettera per lettera: richiede più tempo.
- Messaggi recenti / Post recenti + intervallo di tempo
- Quanto andare in profondità. Se è impostato un intervallo di tempo, la raccolta si ferma al primo messaggio o post più vecchio.
- Minimo messaggi (commenti) per persona
- Tieni solo le persone che hanno scritto almeno N. Vuoto: nessun limite.
- Account
- Quale account fa la raccolta. L'intero lavoro gira su un solo account; con un FloodWait l'account diventa «Limitato» e il lavoro termina con un errore.
- Salva in pubblico
- Un pubblico esistente a cui il risultato viene aggiunto automaticamente senza duplicati.
- Filtri sui risultati
- «Solo con username», «Solo con foto», «Solo Premium», «Ultimo accesso entro» (le persone che nascondono l'orario dell'ultimo accesso vengono scartate da questo filtro). Bot e account eliminati non vengono mai raccolti.
Consigli
- Se «Membri del gruppo» restituisce «L'elenco dei membri è nascosto dagli admin», lancia lo stesso gruppo in modalità «Hanno scritto nel gruppo».
- Per un canale scegli sempre «Commentatori del canale» o «Pubblico del canale».
- Riserva allo scraping un account a parte con un proxy, così un eventuale FloodWait non colpisce gli account delle campagne.
- Costruisci una base unica da più gruppi: crea il pubblico in anticipo e sceglilo in «Salva in pubblico»: i duplicati vengono saltati.
- «Dividi in parti» da 25–50 persone è comodo per inviare da account diversi.
- Inizia con limiti piccoli (2.000 messaggi o 100 post).
- La nota blu nei risultati mostra cosa è successo davvero: quanti post sono stati scansionati, se il gruppo di discussione era nascosto.
Insidie ed errori comuni
- Senza un account attivo il lavoro non viene creato; senza abbonamento fallisce con «L'abbonamento non è attivo».
- Un link di invito fa entrare l'account nel gruppo: gli admin possono vederlo. Un link scaduto: «Il link di invito non è valido o è scaduto».
- «Membri del gruppo» su un canale: «L'elenco degli iscritti al canale è nascosto da Telegram»; «Hanno scritto nel gruppo» su un canale: «Questo è un canale: ci pubblica solo il canale stesso»; un canale senza commenti: «Il canale non ha un gruppo di discussione».
- Con un FloodWait il lavoro termina come «Errore» e l'account viene segnato «Limitato» fino alla fine della pausa.
- Un lavoro ha 2 ore a disposizione: oltre il limite, «Tempo di esecuzione superato», e quello che è stato raccolto viene salvato parzialmente.
- «In pubblico» e «CSV» esistono solo sui lavori «Fatto»: non puoi esportare il risultato parziale di un lavoro fermato.
- Un lavoro non si può modificare dopo l'avvio, e non c'è un pulsante «Ripeti».
- «In pubblico» crea un nuovo pubblico senza controllare le sovrapposizioni; la deduplicazione funziona solo quando aggiungi a uno esistente tramite «Salva in pubblico».
- L'eliminazione di un lavoro non si può annullare: salva prima il risultato.
- Vengono mostrati gli ultimi 100 lavori; non c'è una ricerca tra lavori o persone.
Lo scraping nell'elenco completo — cos'altro fa il pannello.