Tutto ciò che devi sapere

Download e installazione

L'app è portatile su Windows e drag-and-drop su macOS. Nessuna dipendenza, nessun diritto di amministratore.

Windows

macOS

Dove risiedono i dati

Configurazione API di Telegram

Ogni client Telegram necessita di api_id e api_hash — credenziali ufficiali gratuite da Telegram. Ottenerle richiede circa 3 minuti.

Attivazione e piani

Tre piani, un'unica finestra di attivazione. Passa da un piano all'altro in qualsiasi momento inserendo una nuova chiave.

I piani in breve

Attivazione di una chiave

Periodo di tolleranza offline

L'app controlla la licenza ogni 6 ore. In caso di problemi di rete, continua a funzionare dallo stato memorizzato nella cache per un massimo di 30 giorni (fino all'ultima data di fine verificata). Vedrai un badge grigio Offline sulla scheda della licenza, ma nessuna funzionalità andrà persa.

Dove vedere lo stato

• Scheda nella barra laterale — nome del piano, giorni rimanenti, data di fine
• Impostazioni → Licenza — le stesse informazioni nella pagina delle impostazioni
• Banner in alto — visibile se la licenza è mancante o scaduta

Account

La pagina Account è la tua base operativa. Tutto il resto — destinatari, annunci, campagne — appartiene all'account attualmente selezionato.

La griglia degli account

Ogni account è una scheda che mostra:

• Nome e badge iniziale
• Stato — Autorizzato (verde) o Non autorizzato (grigio)
• Info utente — il nome visualizzato su Telegram e l'@username
• Telefono, Proxy e lo stato attuale della sessione

L'account con cui stai attualmente lavorando è contrassegnato da un bordo viola e da un badge CURRENT nell'angolo in alto a destra.

Barra degli strumenti

Azioni sulla scheda

Aggiunta di un nuovo account

Autorizzazione QR / SMS

Due metodi. Il QR è più veloce e non richiede il campo telefono — l'SMS è un fallback.

Scelta del metodo

Clicca su Autorizza su qualsiasi account. Si apre una finestra con due opzioni:

• Codice QR — consigliato. Richiede solo API ID + API Hash.
• Codice SMS — richiede un numero di telefono nelle impostazioni dell'account.

Se il telefono è vuoto, l'opzione SMS è disabilitata con un suggerimento.

Login tramite QR

Login tramite SMS

Controllo salute sessioni v4.0

L'app mantiene attive le tue sessioni Telegram senza che tu debba sorvegliarle.

Come funziona

All'avvio dell'app e all'intervallo configurato, l'app esamina ogni account e verifica che la sessione sia attiva. È un'operazione veloce — una richiesta per account. Nessun QR o SMS, le sessioni vengono caricate da data/sessions/.

I controlli vengono eseguiti in un pool di thread in background (fino a 3 account in parallelo), quindi l'interfaccia rimane reattiva.

Indicatori di stato

Nella pagina Account, ogni scheda riceve un punto colorato accanto al nome:

• 🟢 Autorizzato — sessione attiva, pronta per lavorare
• 🔴 Non autorizzato — sessione morta, necessita ri-autorizzazione QR
• 🟠 Irraggiungibile — problema di rete (nessun internet, proxy morto). La sessione è probabilmente attiva — non siamo riusciti a verificarla
• ⚪ Non configurato — l'account non ha credenziali API
• 🟣 Verifica in corso — controllo in corso

Abilitazione e configurazione

Vai su Impostazioni → Controllo salute sessioni:

Controllo manuale

Clicca su Controlla sessioni nella barra degli strumenti della pagina Account. I progressi sono visibili tramite gli indicatori a punti; il pulsante mostra verifica… X/Y.

Coda di ri-autorizzazione

Quando vengono trovate sessioni morte, l'app offre di ri-autorizzarle una per una:

1. Appare un messaggio: "Trovate N sessioni morte. Ri-autorizzare tutte ora?"
2. Clicca su Sì — si apre una finestra di login QR per il primo account morto
3. Scansiona il QR con il tuo telefono. Quando quell'account è autorizzato, si apre automaticamente il QR successivo
4. Il processo continua finché la coda non è vuota
5. Un riepilogo mostra: Ri-autorizzazione completata: N riuscite, M fallite

Monitor salute account v4.0

Un indicatore di rischio per account, basato sull'attività di invio reale nelle ultime 24 ore.

Apertura

Su qualsiasi scheda account, clicca sull'icona scudo. Si apre una finestra con i dati sulla salute di quell'account.

Cosa vedrai

Livelli di rischio

Raccomandazioni

Clicca su Raccomandazioni nella finestra per una checklist basata sui dati attuali. Ad esempio:

• Se PEER_FLOOD > 0 — metti in pausa questo account per 24–48 ore
• Se i flood sono frequenti — aumenta i ritardi tra i messaggi
• Se inviati > 100/24h — riduci il volume giornaliero
• Gli account verdi ricevono un "Sei a posto, continua così"

Destinatari

Gruppi, canali e contatti disponibili per l'account corrente, disposti in tre colonne.

Barra degli strumenti

Tre colonne

• Gruppi — chat e supergruppi in cui hai i diritti di pubblicazione
• Canali — canali broadcast di cui sei admin
• Contatti — utenti a cui puoi inviare DM

Lavorare con gli elementi

• Casella di controllo — seleziona singoli destinatari
• Casella di controllo nell'intestazione — seleziona / deseleziona tutto in questa colonna
• Pulsante Elimina al passaggio del mouse — rimuove il singolo destinatario dall'elenco locale (non influisce su Telegram)
• Aggiungi + — aggiunge manualmente un singolo destinatario (digitando il nome esatto)
• Rimuovi selezionati — rimuove tutti i destinatari selezionati

Barra delle azioni di selezione

Quando almeno un elemento è selezionato, appare una barra delle azioni viola sopra le colonne con:

• Aggiungi al gruppo — sposta la selezione in un gruppo denominato
• Rimuovi dal gruppo — visibile solo quando è attivo un filtro di gruppo
• Elimina — rimuove completamente i destinatari selezionati
• Cancella selezione — deseleziona tutto

Gruppi di destinatari v4.0

Collezioni nominate di destinatari — come "Principale", "VIP", "Test" — per la selezione con un clic negli annunci.

Creazione di un gruppo

Gestione dei gruppi

Nella finestra Gestisci gruppi puoi:

• Rinominare un gruppo — icona matita
• Eliminare un gruppo — icona cestino. I destinatari stessi rimangono nel tuo elenco; viene rimossa solo l'appartenenza al gruppo.
• Vedere il numero di membri accanto a ciascun gruppo

Filtraggio della vista Destinatari

Usa il menu a discesa del filtro dei gruppi sulla barra degli strumenti per visualizzare solo i membri di un gruppo specifico. Opzioni:

• Tutti i destinatari — mostra tutto
• Senza gruppo — solo i destinatari non appartenenti a nessun gruppo
• Qualsiasi nome di gruppo specifico

Selezione di un gruppo nell'editor degli annunci

Apri qualsiasi annuncio → scheda Destinatari. Sopra le tre colonne vedrai una riga di chip dei gruppi:

• ○ nome — 12 — nulla selezionato (12 disponibili)
• ◐ nome — 5/12 — parzialmente selezionato
• ✓ nome — 12 — completamente selezionato (verde)

Clicca su un chip per attivare/disattivare l'intero gruppo. Clicca di nuovo per deselezionare tutto in quel gruppo.

Importazione CSV / Excel / JSON v4.0

Carica massivamente elenchi di destinatari da fogli di calcolo, dump JSON o un CSV esportato da un'altra app.

Formati supportati

• CSV — rileva automaticamente il delimitatore (;, , o tab)
• Excel — .xlsx e .xlsm con una finestra interattiva di mappatura delle colonne
• JSON — un elenco di oggetti o un dict con chiavi group/channel/contact

Formato CSV

Due o tre colonne: type, name e group opzionale.

type;name;group
group;Chat di marketing;Principale
channel;@mio_canale;Principale
contact;Mario Rossi;
group;Chat di test;Test

Il tipo accetta sinonimi in inglese e italiano:

• group, groups, gruppo, gruppi
• channel, channels, canale, canali
• contact, contacts, contatto, contatti, user, users

Formato JSON

Due strutture accettate:

[
  { "type": "group",   "name": "Chat di marketing", "group": "Principale" },
  { "type": "channel", "name": "@mio_canale",     "group": "Principale" }
]

Oppure raggruppato per tipo:

{
  "group":   ["Chat di marketing", "Chat di test"],
  "channel": ["@mio_canale"],
  "contact": ["Mario Rossi"]
}

Mappatura colonne Excel

Quando importi un file .xlsx, appare una finestra di mappatura:

• Colonna tipo — quale colonna contiene group/channel/contact
• Colonna nome — quale colonna contiene il nome effettivo del destinatario
• Colonna gruppo — gruppo denominato opzionale da assegnare a ciascun destinatario

L'app ipotizza automaticamente in base ai nomi delle intestazioni ("tipo", "nome", "gruppo" e i loro equivalenti in inglese). Un'anteprima dal vivo mostra le prime 4 righe come verranno analizzate.

Anteprima dell'importazione

Dopo l'analisi vedrai un riepilogo:

• Nuovi — quante nuove righe verranno aggiunte
• Duplicati — quante esistono già nel tuo elenco
• Errori — problemi di analisi, con numeri di riga
• Gruppi rilevati — nomi dei gruppi trovati nel file

Unisci vs Sostituisci

• Unisci — aggiunge nuovi destinatari, salta i duplicati, lascia intatti quelli esistenti
• Sostituisci — cancella l'elenco attuale e usa solo ciò che è nel file (appare un'ulteriore finestra di conferma)

Esportazione in CSV

Clicca su Esporta CSV nella barra degli strumenti. Il file viene salvato con:

• Codifica UTF-8 BOM — Excel apre correttamente i caratteri non ASCII
• Delimitatore punto e virgola
• Colonna gruppo opzionale che elenca tutti i gruppi di destinatari a cui appartiene l'elemento

Nome file predefinito: recipients_NomeAccount_20261020_143052.csv.

Panoramica annunci

La pagina Annunci elenca tutti i tuoi messaggi programmati per l'account corrente e offre il controllo in tempo reale su ciascuno di essi.

Layout

Divisione in due pannelli:

• Sinistra — elenco degli annunci con un indicatore in esecuzione/in pausa/interrotto
• Destra — dettagli per l'annuncio selezionato

Indicatori nell'elenco

• ▶ — in esecuzione
• ⏸ — in pausa
• ⏹ — interrotto

Azioni della barra degli strumenti

Pannello dei dettagli

Mostra il riepilogo del contenuto dell'annuncio selezionato, l'intervallo, la finestra temporale, i conteggi dei destinatari, i ritardi e — durante l'esecuzione — una barra di avanzamento dal vivo.

Pulsanti di controllo:

• Avvia — inizia l'invio
• Pausa / Riprendi — sospende temporaneamente senza perdere lo stato
• Ferma — annulla completamente (il ciclo in esecuzione si interrompe immediatamente)
• Modifica, Duplica, Elimina

Creazione di un nuovo annuncio

Clicca su Nuovo annuncio per aprire l'editor. L'editor ha quattro schede:

1. Contenuto — testo, media, rotazione, catene
2. Destinatari — gruppi, canali, contatti, argomenti del forum
3. Pianificazione — intervallo, finestra temporale, giorni, ritardi, auto-stop
4. Avanzate — limite di invio, modelli

Ogni scheda è trattata nella propria sezione di seguito.

Editor annunci — Contenuto

Componi il messaggio. Tre modalità: messaggio singolo, rotazione contenuti e catene di messaggi.

Modalità 1 — Messaggio singolo

La modalità predefinita. Compila il testo del messaggio e facoltativamente allega media. Sono supportate le variabili (vedi sotto).

Modalità 2 — Rotazione contenuti

Abilita Usa rotazione per definire più varianti (vedi la sezione dedicata alla rotazione).

Modalità 3 — Catene di messaggi

Abilita Catene di messaggi per passare a scenari multi-fase (vedi la sezione dedicata alle catene).

Campo messaggio

Supporta testo multiriga, formattazione HTML e variabili dinamiche:

Nelle campagne iscritti (DM) sono disponibili anche queste variabili utente:

• {name} — nome completo
• {first_name}, {last_name} — parti del nome
• {username} — @username se presente

Media

Clicca su Aggiungi file per allegare foto, video o documenti. Più file (fino a 10) vengono inviati come album di Telegram.

• I file sono elencati con il loro nome di base e un pulsante di eliminazione al passaggio del mouse
• Qualsiasi tipo di file accettato da Telegram: JPG, PNG, MP4, MOV, ZIP, PDF, ecc.
• I media vengono caricati per messaggio — nessun problema di limite di velocità oltre al ritardo di invio standard

Inoltra da Messaggi Salvati

Invece di scrivere il testo, puoi inoltrare un messaggio salvato esistente (o un intero album):

Anteprima e invio di prova

Nella parte inferiore dell'editor:

• Anteprima — mostra il messaggio come apparirà in Telegram (con la sostituzione delle variabili data/ora)
• Invio di prova — invia il messaggio una volta al primo destinatario selezionato. Usalo prima di lanciare una campagna lunga.

Rotazione contenuti v4.0

Definisci più varianti di testo e media. Ogni destinatario ne riceve una diversa — riducendo drasticamente il rilevamento di pattern di spam.

Abilitazione della rotazione

Regola di abbinamento

Modalità di rotazione

Media per variante

Ogni variante ha il proprio elenco di media. Clicca su Aggiungi file sotto qualsiasi variante per allegare media specifici a quella variante. Se una variante non ha media, viene inviata come messaggio di solo testo.

Uso della rotazione all'interno delle catene

La rotazione funziona anche all'interno delle catene — ogni passo può avere il proprio interruttore Usa rotazione. Il passo 1 potrebbe inviare 3 varianti di testo in modo casuale, il passo 2 potrebbe non avere rotazione, il passo 3 potrebbe ciclare tra 5 immagini diverse. Il contatore di ogni passo è indipendente.

Catene di messaggi v4.0

Trasforma un singolo annuncio in un dialogo multi-fase — da 2 a 5 messaggi inviati uno dopo l'altro con pause configurabili.

Abilitazione delle catene

Ogni passaggio ha

• Testo — corpo del messaggio separato
• Media — allegati separati (foto, video, documenti)
• Rotazione opzionale — interruttore per passo per definire più varianti all'interno del passo
• Ritardo dopo — quanti secondi attendere prima di inviare il passo successivo (viene mostrato solo tra i passi, non dopo l'ultimo)

Gestione dei passaggi

• Aggiungi passo — aggiunge un nuovo passo vuoto alla fine
• Frecce ↑ / ↓ — riordina i passaggi (disabilitate sul primo/ultimo)
• X — elimina un passo (deve rimanere almeno un passo)

Rotazione per passo

All'interno di qualsiasi passo, abilita Usa rotazione per definire più varianti di testo+media per quel passo. La modalità di rotazione (casuale/ciclica) è separata per ogni passo.

Anteprima della timeline

Clicca su Anteprima per vedere l'intera catena come una timeline numerata con bolle di contenuto per passo e indicatori di pausa tra di esse.

Esempio reale — Sequenza di warm-up

Per le campagne iscritti, una catena di 3 passi funziona così:

Pianificazione

Controlla quando e con quale frequenza l'annuncio viene attivato. Due modalità di pianificazione, più finestre temporali, giorni della settimana e protezione auto-stop.

Modalità di pianificazione

Modalità intervallo

Imposta l'intervallo in minuti. Raccomandazione minima: 180 per i canali, 60 come soglia assoluta. Al di sotto, Telegram inizia a rispondere con FloodWait.

Modalità orari fissi

Aggiungi uno o più orari della giornata (HH:MM). L'app calcola l'esecuzione programmata successiva — se un giorno ha tutti i suoi orari nel passato, viene usato il primo orario del giorno successivo.

Finestra temporale

Limita l'invio a ore specifiche — ad es. solo durante l'orario di lavoro. Anche le finestre notturne funzionano (22:00 → 06:00).

Giorni della settimana

Sette caselle di controllo: da lunedì a domenica. Sono consentiti solo i giorni selezionati. Se l'app è in esecuzione ma il giorno corrente non è selezionato, registra "giorno sbagliato" e attende.

Ritardi tra i messaggi

Un intervallo casuale in secondi. Per ogni destinatario, il ritardo viene estratto uniformemente tra il minimo e il massimo.

Protezione auto-stop

Cosa succede quando scatta l'auto-stop

1. La campagna si ferma immediatamente
2. Appare una voce di registro: "Auto-stop: 5 errori consecutivi. Annuncio 'X' fermato."
3. Se le notifiche Telegram sono abilitate, ricevi un rapporto nei Messaggi Salvati
4. L'annuncio rimane nel tuo elenco — risolvi il problema e riavvia

Argomenti del forum

Se un gruppo selezionato è un forum Telegram (con argomenti), puoi inviare ad argomenti specifici — o alla chat principale.

Configurazione degli argomenti

Cosa succede all'invio

Per ogni gruppo destinatario che è un forum, l'app invia un messaggio separato a ciascun argomento selezionato. Se spunti 3 argomenti in un gruppo e lo stesso gruppo è selezionato anche per un altro annuncio, gli argomenti si applicano solo a questo annuncio.

Conteggio dei destinatari

Il conteggio dei "destinatari totali" nei dettagli dell'annuncio include le divisioni per argomento. Un singolo gruppo con 3 argomenti selezionati conta come 3 destinatari.

Chat principale

Sempre disponibile. Se spunti solo la chat principale — nessun argomento — il messaggio va solo al feed generale.

Campagne iscritti (DM)

Raccogli i partecipanti da qualsiasi gruppo o canale, poi invia loro messaggi diretti personalizzati.

Come funziona

1. Specifichi una fonte — un gruppo o canale a cui hai accesso
2. L'app recupera l'elenco dei partecipanti (con filtri)
3. Invia a ciascun partecipante un DM personalizzato
4. I progressi vengono monitorati — lo stesso utente non riceve mai il messaggio due volte

Creazione di una campagna

Anteprima dei partecipanti

Clicca su Anteprima su qualsiasi campagna. Si apre una finestra con l'elenco degli utenti che verrebbero presi di mira, mostrando nome, @username e ID utente. Verifica che i filtri funzionino come previsto prima di lanciare.

Esecuzione della campagna

Clicca su Avvia. La prima passata parte immediatamente. Le statistiche dal vivo appaiono nel pannello delle informazioni e si aggiornano ogni secondo:

• Inviati — messaggi consegnati
• Saltati — utenti senza username, con privacy protetta, disattivati, bot
• Falliti — errori (di solito privacy o flood)
• Tracciati — utenti distinti totali che hanno già ricevuto un messaggio

Condizioni di salto

Gli utenti vengono saltati silenziosamente (conteggiati in Saltati) quando Telegram restituisce:

• Restrizioni sulla privacy — "l'utente non accetta messaggi da estranei"
• Non è un contatto reciproco
• Account disattivato
• Sei stato bloccato dall'utente

Ripristino dei progressi

Clicca su Ripristina per cancellare l'elenco dei "già inviati". Usalo se vuoi inviare di nuovo la stessa campagna — ma solo dopo aver cambiato significativamente il messaggio.

Motivi di completamento

Iscrizione ai gruppi (Joiner)

Iscriviti in massa a gruppi e canali da un elenco di link con ritardi configurabili.

Preparazione dei link

Incolla i link nell'area di testo — uno per riga. Formati supportati:

• https://t.me/joinchat/XXXXX — link di invito privato
• t.me/username — gruppo o canale pubblico
• @username — pubblico
• +invite_hash — invito privato

Ritardo tra le iscrizioni

Consigliato: 10–30 secondi. Valori inferiori portano rapidamente a errori FloodWait. Il valore predefinito di 5 secondi è aggressivo — ne vorrai almeno 15.

Esecuzione del joiner

1. Incolla i link o clicca su Carica da file per importare un .txt
2. Imposta il ritardo
3. Clicca su Avvia iscrizione

L'app elabora i link uno per uno:

• La barra di avanzamento mostra la posizione attuale
• Ogni tentativo viene registrato nel Registro eventi
• Un elenco dei risultati dal vivo appare sotto con indicatori ✓ / ✗
• Un riepilogo finale mostra: N riusciti, M falliti

Salvataggio del tuo elenco

Il tuo elenco di link viene salvato automaticamente in localStorage tra le sessioni. Clicca su Salva su file per esportarlo come .txt per il backup.

Campagne storie

Pubblica automaticamente le storie di Telegram in base alla pianificazione. Richiede Telegram Premium sull'account.

Creazione di una campagna storie

Esecuzione della campagna

Seleziona la campagna, clicca su Avvia. L'app:

• Verifica che l'account abbia Premium
• Verifica che il file media esista
• Pubblica immediatamente la prima storia
• Programma le storie successive all'intervallo specificato

Requisiti dei media

Risposta automatica Enterprise

Rispondi automaticamente ai messaggi privati in entrata in base alla corrispondenza delle parole chiave. Solo piano Enterprise.

Cosa fa

L'app controlla tutti i messaggi privati in entrata sull'account corrente. Quando un messaggio corrisponde alla condizione di una regola, l'azione configurata viene attivata.

Creazione di una regola

Tipi di corrispondenza

Azioni

Test di una regola

Clicca su Test su qualsiasi regola di risposta abilitata. L'app invia il testo della risposta ai tuoi Messaggi Salvati — utile per vedere esattamente come viene renderizzato con la sostituzione delle variabili.

Come si attivano le regole

• Il messaggio in entrata viene analizzato
• Le regole vengono controllate in ordine; vince la prima corrispondenza
• Viene effettuato il controllo del cooldown — lo stesso utente non può ricevere risposte automatiche più spesso del cooldown
• Se l'azione è rispondi e il ritardo è impostato, l'app attende quei secondi e poi invia

Statistiche v4.0

Dashboard analitica completa: attività per giorno e ora, target principali, errori principali, eventi recenti con esportazione CSV.

Filtri

Schede KPI

• Inviati — invii riusciti (verde)
• Errori — errori gravi (rosso)
• Flood — eventi FloodWait (giallo)
• Tasso — inviati / (inviati + errori + flood) in percentuale
• Visualizzazioni — visualizzazioni totali per i messaggi dei canali tracciati

Grafici

Attività per giorno — grafico a barre degli inviati per giorno, con una linea di sovrapposizione degli errori.

Attività per ora — grafico a barre degli inviati per ora del giorno. Utile per individuare le tue migliori finestre di invio.

Target principali

Top-10 destinatari più utilizzati con conteggio inviati, conteggio errori e — per i canali — badge delle visualizzazioni totali.

Errori principali

Top-10 tipi di errore per frequenza. Utile per capire i problemi sistematici:

• not_found — il destinatario non esiste più
• privacy — restrizione sulla privacy dell'utente
• peer_flood — segnale di arresto forzato da Telegram
• flood_wait — limite di velocità raggiunto
• E altri, a seconda dell'errore specifico restituito

Eventi recenti

Gli ultimi 30 eventi con timestamp, nome della campagna, target e pillola di stato. Filtrati per lo stesso periodo/account/campagna dei KPI.

Tracciamento visualizzazioni canale

Per i canali broadcast in cui il tuo account è admin, l'app recupera automaticamente i conteggi delle visualizzazioni in background. Aggiornati ogni 10 minuti per messaggi fino a 7 giorni fa.

Esporta CSV

Clicca su Esporta CSV per salvare tutti gli eventi che corrispondono ai filtri attuali in un file CSV (fino a 100.000 righe). Colonne:

timestamp;account_id;campaign_name;campaign_type;target_name;target_kind;status;error_kind;views

Conservazione

Le statistiche sono memorizzate localmente in SQLite. Gli eventi più vecchi di 90 giorni vengono eliminati automaticamente da un processo giornaliero in background. Modifica la conservazione nella configurazione se necessario.

Registro eventi

Ogni azione eseguita dall'app viene registrata qui. Usalo per monitorare le campagne e diagnosticare i problemi.

Tipi di evento

• INFO (blu) — eventi di routine: invio avviato, messaggio inviato, campagna completata
• WARNING (arancione) — potenziali problemi: intervallo breve, rete lenta, utenti saltati
• ERROR (rosso) — fallimenti effettivi: entità non trovata, nessun permesso, PEER_FLOOD

Filtri

Contatori

Sopra il corpo del registro vedi i contatori dal vivo:

• Totale — tutti gli eventi visibili
• Inviati — invii riusciti
• Avvisi — avvisi
• Errori — errori

Esportazione

• Esporta TXT — testo semplice, un evento per riga
• Esporta CSV — strutturato con timestamp, livello, tipo, flag silenzioso, account, messaggio. UTF-8 BOM per Excel.

Copia tutto

Copia tutti gli eventi filtrati negli appunti nello stesso formato TXT. Utile per incollare in un ticket di supporto.

Cancellazione

Clicca su Cancella per svuotare il buffer visibile e l'elenco in memoria. Il file di registro su disco (data/logs/app.log) non viene influenzato.

Impostazioni

Tutta la configurazione globale in un'unica pagina.

Generali

Proxy globale

Un singolo proxy utilizzato da tutti gli account che non hanno il proprio. Campi: tipo (SOCKS5 / SOCKS4 / HTTP), host, porta, username e password opzionali.

• Salva — scrive nella configurazione
• Test — verifica il tuo IP esterno attraverso questo proxy tramite api.ipify.org. Il risultato appare come un avviso.
• Cancella — reimposta tutti i campi e rimuove il proxy globale

Finestra temporale globale

Una singola finestra di invio applicata a ogni annuncio e campagna sull'account. Quando abilitata, sovrascrive le impostazioni per singolo annuncio.

Avvio automatico

• Avvia automaticamente tutti gli annunci dopo l'autorizzazione — quando un account viene autorizzato, ogni suo annuncio parte immediatamente

Controllo salute sessioni

Trattato in dettaglio nella sezione Controllo Salute Sessioni:

• Abilita all'avvio
• Intervallo di controllo automatico (minuti, 0 = disabilitato)
• Ri-autorizza automaticamente le sessioni morte

Notifiche Telegram

Vedi la sezione dedicata di seguito.

Licenza

Mostra il piano attuale, i giorni rimanenti, la data di fine. Pulsante per riaprire la finestra di attivazione.

Dati e log

• Statistiche di archiviazione — dimensione totale dei dati, contatori di account, destinatari, campagne
• Apri cartella dei log — apre data/logs/ nel tuo file manager
• Esportazione backup — profilo completo in ZIP
• Importazione backup — ripristino da ZIP con una finestra di anteprima
• Controlla aggiornamenti — controllo manuale degli aggiornamenti
• Debug — mostra un dump JSON dello stato del sottosistema di aggiornamento (utile per il supporto)

Zona pericolosa

• Ripristina impostazioni — cancella proxy, finestra temporale, avvio automatico, controllo sessioni e impostazioni di notifica riportandole ai valori predefiniti
• Cancella account — elimina ogni account e la sua sessione. Prima appare una finestra di conferma.

Notifiche Telegram

Ricevi i rapporti delle campagne direttamente su Telegram — nei tuoi Messaggi Salvati o in qualsiasi chat.

Abilitazione

Test

Clicca su Invia notifica di prova. Usa il primo account autorizzato e invia un messaggio di prova al target scelto. Se non esiste un account autorizzato, riceverai un errore chiaro.

Eventi consegnati

Ogni notifica contiene un riepilogo formattato. Un tipico rapporto di completamento campagna appare così:

✅ Invio completato

📣 Campagna: Promo
📤 Inviati: 45
❌ Errori: 2

⏱ Durata: 12 min
🕐 14:30 — 14:42

Backup completo del profilo v4.0

Un clic per esportare tutto: configurazione, database, sessioni, annunci, campagne e statistiche come un unico file ZIP.

Cosa è incluso

• config.json — tutte le impostazioni, cache della chiave di licenza
• autoposter.db — account, destinatari, annunci, storie, iscritti, modelli, regole di risposta automatica, statistiche
• sessions/*.session — file di sessione Telegram (opzionali, vedi sotto)
• templates/ — eventuali dati della cartella dei modelli

Cosa è escluso

• logs/ — file di registro
• exports/ — file CSV esportati
• backups/ — vecchi backup
• File temporanei WAL/SHM di SQLite

Esportazione

Importazione

Aggiornamenti

L'app controlla la presenza di nuove versioni all'avvio e offre una finestra di changelog quando una è disponibile.

Controllo automatico

2,5 secondi dopo l'avvio, viene inviata una piccola richiesta al server degli aggiornamenti. Se esiste una versione più recente, appare una finestra di changelog con elementi categorizzati (funzionalità, correzioni, miglioramenti, sicurezza).

Finestra di aggiornamento

• Scarica — apre la pagina di download nel tuo browser
• Ricordamelo più tardi — la finestra si chiude, verrà mostrata di nuovo al prossimo avvio
• Salta questa versione — non mostrare mai più questa specifica versione (se ne esce una più recente, la finestra ritorna)

Controllo manuale

Due modi:

• L'icona di download nella barra superiore
• Impostazioni → Dati e log → Controlla aggiornamenti

Informazioni di debug

Impostazioni → Debug mostra un dump JSON con la tua versione attuale, la risposta del server e se l'aggiornamento dovrebbe attivarsi. Utile quando si apre un ticket di supporto.

Dati e cartelle

Tutto è memorizzato in un'unica cartella. Se capisci questo, capisci l'app.

Posizione delle cartelle

Cosa c'è dentro

Backup automatici

Ogni volta che salvi impostazioni o una campagna, il precedente config.json viene copiato in backups/ con un timestamp. Vengono mantenuti solo i 5 più recenti.

Ripristino manuale di un backup della configurazione

1. Chiudi l'app
2. Apri data/backups/ e trova la copia desiderata
3. Rinominala in config.json e sostituisci quella attuale
4. Riavvia l'app

Migrazione su un nuovo computer

1. Copia l'intera cartella data/ (o l'equivalente macOS) su una chiavetta USB
2. Installa l'app sul nuovo computer
3. Chiudila una volta (in modo che crei la cartella data/ vuota)
4. Sostituisci la nuova cartella data/ con quella della chiavetta
5. Avvia — tutto è preservato

Risoluzione dei problemi

Risposte rapide ai problemi più comuni.