Invii di Massa `/send`¶

Il comando /send ti consente di inviare messaggi individuali o catene di messaggi ai clienti tramite il sistema di invio. Sono supportati tutti i principali tipi di messaggi Telegram: testo, sticker, voce, video, immagini, file.

Come Funziona¶

La configurazione e l'avvio degli invii di massa vengono effettuati nel topic Generale utilizzando il comando /send. Nei topic di dialogo, il comando può essere utilizzato anche dagli operatori, ma solo per inviare un modello pre-preparato all'utente o alla chat corrispondente.

Dopo l'avvio, il comando segnala l'inizio dell'invio nel topic General. Al termine viene mostrato un breve riepilogo, mentre un report CSV dettagliato con destinatari e stati di consegna viene inviato all'operatore in una chat privata con il bot di configurazione.

Prima del primo invio, avvia il bot di configurazione o inviagli un messaggio. Se il bot è bloccato o non è ancora stato avviato, in General compare un errore di consegna del report. In seguito puoi richiederlo di nuovo con /send sidSENDING_ID report.

I messaggi dagli invii non vengono visualizzati nei topic per evitare di interrompere la cronologia dei topic e non superare i limiti disponibili di Telegram per la consegna di messaggi a gruppi con un gran numero di destinatari.

Caratteristiche Principali¶

Facile test degli invii prima dell'invio
Invio di messaggi privati agli utenti o alle chat
Invio di singoli messaggi di qualsiasi tipo e catene di messaggi
Creazione e utilizzo di modelli di invio
Impostazioni temporali flessibili
Diversi modi per specificare gli elenchi di destinatari
Selezione dei destinatari tramite più etichette ed esclusione di segmenti
Report CSV dettagliato con stati dei destinatari tramite il bot di configurazione
Velocità di invio attuale circa 1000 messaggi al minuto
In caso di errore durante l'esecuzione dell'invio, si riavvia automaticamente dal punto di arresto in 2 minuti

Gli invii da account possono portare al ban

Con gli invii di massa da account utente, c'è un alto rischio di ottenere un ban temporaneo da Telegram se uno qualsiasi dei destinatari contrassegna il tuo messaggio come spam. Puoi verificare le restrizioni dell'account tramite @spambot

Non c'è tale rischio con gli invii da bot, ma gli utenti possono interrompere la ricezione di messaggi dal bot in qualsiasi momento.

Opzioni Destinatari¶

Invio di Test

L'opzione test invia il messaggio solo a te per il controllo prima dell'invio di massa.
Tutti gli Utenti

L'opzione all invia il messaggio a tutti coloro che hanno avuto un dialogo tramite Hotline.
Elenco da File

L'opzione file utilizza il file allegato con l'elenco di user_id dei destinatari.
Elenco nel Comando

L'opzione list accetta l'elenco di user_id direttamente nel comando separati da virgole.
Per Etichette

L'opzione mark invia il messaggio agli utenti con almeno una delle etichette indicate. Il parametro exclude esclude gli utenti con una qualsiasi delle etichette successive.

Esempi di Utilizzo¶

Invio Rapido di Notifica¶

Nel topic Generale invia messaggio: "Cari clienti! Abbiamo una nuova promozione sul nostro sito, non perdetela!"
Rispondi ad esso con il comando: /send test (invierà messaggio di test all'operatore)
Controlla come appare il messaggio (arriverà dal bot o account collegato)
Invia a tutti: /send all (come risposta allo stesso messaggio)

Idea di utilizzo

In questo modo puoi inviare rapidamente video note o messaggi vocali all'audience del bot, migliorando il coinvolgimento degli utenti.

Creazione di Modello con Catena¶

Nel topic Generale invia messaggio: "Ciao! Grazie per l'interesse nei nostri servizi."
Rispondi con /send template onboarding (crea il modello e aggiunge il primo messaggio)
Invia un altro messaggio nel Generale: "Entro un'ora ti invieremo informazioni dettagliate."
Rispondi con /send template onboarding delay 5m (aggiunge il secondo messaggio, inviato automaticamente 5 minuti dopo il primo)
Invia PDF con catalogo e nota nel Generale
Rispondi con /send template onboarding delay 1h (aggiunge il terzo messaggio, inviato automaticamente 1 ora dopo il secondo)

Il modello onboarding contiene ora tre messaggi con gli intervalli indicati. Può essere usato nei topic utente con /send onboarding oppure inviato a tutti da General con /send all template onboarding.

Invio per Etichetta¶

Per inviare il modello special_offer ai clienti con etichetta vip o lead, escludendo quelli con blocked:

/send mark vip,lead template special_offer exclude blocked

Più etichette incluse usano la logica OR: il destinatario viene incluso se ne possiede almeno una. exclude rimuove sempre un dialogo se possiede almeno una delle etichette successive.

Controllare i topic eliminati

Prima di un invio di massa, esegui /sync N deleted, dove N è il numero di dialoghi da controllare. In questo modo i topic già eliminati vengono rimossi dal database attivo e non si tenta di inviare loro messaggi.

Limiti di Invio¶

Versione del Sistema	Limite Messaggi al Mese
Gratuita	500
A Pagamento	da 4000 nel piano minimo (tutti i piani)

Espansione dei limiti

Per aumentare i limiti standard, contatta il servizio di supporto.

Restrizione dell'Accesso¶

Per impostazione predefinita, le funzioni per la configurazione e l'avvio degli invii sono disponibili solo per gli amministratori delle connessioni. L'accesso può essere esteso tramite il parametro EXTENSIONS_ALLOWED.

Comando /send nei topic

Gli operatori possono utilizzare il comando /send nei topic anche senza accesso amministrativo.

Chiamata del Comando¶

Il comando /send funziona diversamente a seconda di dove viene chiamato!

Nel Topic Generale (con `reply` al messaggio)¶

Utilizzato per inviare un messaggio specifico o creare un modello.

Invio di messaggio

Invia a te stesso per test:

/send test [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia a tutti gli utenti con cui c'è stato dialogo:

/send all [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia agli utenti dal file allegato (elenco di user_id può essere separato da virgole, spazi o nuova riga):

/send file [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia agli utenti dall'elenco separato da virgole:

/send list CHAT_ID1,CHAT_ID2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia agli utenti con una qualsiasi delle etichette indicate:

/send mark MARK1,MARK2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

Creazione di modello

Aggiungi messaggio a modello nuovo o esistente (il nome del modello deve iniziare con lettera latina, può contenere numeri, trattino o underscore):

/send template TEMPLATE_NAME [now | delay ... | datetime ...]

Creazione di catena di messaggi

Invia il primo messaggio e rispondi: /send template welcome
Invia il secondo messaggio e rispondi: /send template welcome delay 5m
Invia il terzo messaggio e rispondi: /send template welcome delay 1h

Risultato: il modello welcome conterrà tre messaggi. Il primo verrà inviato immediatamente, il secondo — 5 minuti dopo il primo, il terzo — 1 ora dopo il secondo.

Nel Topic Generale (senza `reply`)¶

Utilizzato per avviare invii di massa, gestire modelli e invii.

Invio di modello

Invia modello a te stesso per test:

/send test template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia modello a tutti gli utenti:

/send all template TEMPLATE_NAME [exclude MARK1,MARK2] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia modello agli utenti dal file:

/send file template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia modello agli utenti dall'elenco:

/send list CHAT_ID1,CHAT_ID2 template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Invia il modello agli utenti con una delle etichette indicate, eccetto quelle escluse:

/send mark MARK1,MARK2 template TEMPLATE_NAME [exclude MARK3,MARK4] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Visualizzazione di informazioni

Mostra tutti i modelli creati:

/send templates

Mostra invii recenti:

/send sendings [instance INSTANCE_ID]

Mostra proprietà del modello:

/send template TEMPLATE_NAME

Mostra stato e breve riepilogo dell'invio:

/send sidSENDING_ID

Ricevi il report CSV dettagliato nella chat privata con il bot di configurazione:

/send sidSENDING_ID report

Modifica ed eliminazione

Rinomina modello:

/send template TEMPLATE_NAME name NEW_NAME

Cambia tempo di invio del messaggio nel modello:

/send template TEMPLATE_NAME for MESSAGE_ID [now | delay ... | datetime ...]

Elimina messaggio dal modello:

/send template TEMPLATE_NAME del MESSAGE_ID

Elimina modello completamente:

/send template TEMPLATE_NAME del

Annulla invio (solo se è nello stato awaits):

/send sidSENDING_ID del

Nel Topic di Dialogo (senza `reply`)¶

Utilizzato per inviare modello a un utente o chat specifico.

Invio di modello

Invia modello all'utente di questo topic:

/send TEMPLATE_NAME [now | delay ... | datetime ...]

Mostra modelli disponibili:

/send templates

Mostra invii per questo topic:

/send sendings

Mostra stato dell'invio (senza report):

/send sidSENDING_ID

Impostazioni Temporali¶

Per ogni messaggio puoi specificare l'orario di invio con [now | delay ... | datetime ...]:

Formato	Descrizione	Esempio
`now`	Invia immediatamente (predefinito)	`now`
`delay`	Invio ritardato	`delay 5m 30s`, `delay 2h`, `delay 1d`
`datetime`	Orario fisso in UTC	`datetime 2026-07-27 14:25:55`

Catene di messaggi

Nei modelli con più messaggi, il ritardo viene contato dal momento di invio del messaggio precedente nella catena.

Parametro `instance`¶

Con più connessioni in un gruppo backend, aggiungi instance INSTANCE_ID alla fine del comando per eseguirlo solo per una connessione specifica.

Comportamento predefinito

Senza il parametro instance INSTANCE_ID, il comando viene eseguito indipendentemente per ogni connessione nel gruppo backend.

Aiuto Rapido¶

Invia il comando /send o /send help in qualsiasi contesto per ottenere un breve aiuto in inglese.

Invii di Massa /send¶