Base di conoscenza

hotline.tg

Bot per le masse Telegram mailing e segmentazione del pubblico

Capacità del gruppo /send, /mark et /export per Telegram CRM Hotline.
Dopo aver collegato il tuo bot o il tuo account utente normale a Hotline CRM (si collega in parallelo a bot o account esistenti, non influisce sul loro lavoro, fatto gratuitamente in pochi minuti), diventa possibile utilizzare tre potenti comandi interconnessi dal nostro bot di estensione sul lato del tuo gruppo backend:

/send – per invii di massa di singoli messaggi o modelli con catene di messaggi agli utenti di Telegram

/mark – assegnare etichette (stati aggiuntivi) agli argomenti utente e determinare il comportamento delle etichette

/export – esportare come file l'elenco degli utenti con i quali c'è stata corrispondenza attraverso il sistema Hotline e/o avere l'etichetta specificata
Nota: Questa pagina contiene frammenti con traduzione automatica. Se hai difficoltà a comprendere queste informazioni, prova a cambiare la lingua in inglese o russo e utilizza il tuo sistema di traduzione di siti web di fiducia.
Connessione del bot dell'estensione
Per utilizzare i comandi descritti in questo articolo, è necessario aggiungere un'estensione bot @hotlinetg_extensions_bot con diritti di amministratore sul tuo gruppo backend.

Versione base Hotline (il nucleo del sistema) è responsabile della trasmissione affidabile del flusso di messaggi con gli utenti e contiene solo funzionalità principale.
Limiti del sistema di posta
La versione gratuita del sistema consente di inviare tramite il sistema di posta un comando /send fino a 200 messaggi al mese. La versione a pagamento del sistema permette di inviare fino a 1000*N messaggi al mese, dove N è pari al numero di operatori del sistema in un abbonamento a pagamento.

Se hai bisogno di espandere i limiti standard per l'invio di messaggi, contatta Supporto.

Restrizioni per le squadre /mark et /export no.
Aiuto rapido
Per ottenere un aiuto rapido in inglese nel tuo gruppo backend, puoi inviare un comando in qualsiasi momento /send, /mark o /export senza parametri nel contesto appropriato (in General argomento, argomento personalizzato o in una risposta a un messaggio).
Limitazione di accesso
Funzioni amministrative della squadra /send, /mark и /export disponibile solo da General argomento del gruppo backend, l'accesso ad essi può essere limitato tramite un parametro speciale @EXTENSIONS_ALLOWED@ nel bot di installazione @hotlinetg_bot.

Opzioni di utilizzo dei comandi /send

Squadra /send ti consente di inviare messaggi individuali o anche thread di messaggi contenenti tutti i principali tipi di messaggi Telegram: testo con qualsiasi formattazione, adesivi, messaggi vocali, video, immagini, file.

Come destinatari della spedizione potranno essere indicati:
  • operatore che esegue il comando /send, per testare il messaggio (facoltativo test)
  • tutti gli utenti con cui c'è un dialogo (argomento) attraverso il sistema Hotline (opzione all)
  • elenco degli utenti nel file allegato (opzione file)
  • elenco degli utenti separati da virgole nel comando stesso (opzione list)
  • tutti gli utenti a cui viene assegnata l'etichetta corrispondente dal comando /mark (opzione mark)

È possibile inviare sia messaggi singoli (senza salvare l'invio come modello) che catene di messaggi (salvando un singolo messaggio o una sequenza di messaggi come modello con le opzioni necessarie).

Per ogni messaggio inviato nel parametro facoltativo [now,delay,datetime] puoi specificare l'ora di invio:
  • now (da inviare al momento della chiamata del comando, utilizzato per default)
  • con ritardo nel formato 100s 10m 5h 2g (da 1 a 4 parametri con il numero richiesto di secondi, minuti, ore o giorni) dal momento in cui è stato inviato il comando o dal momento in cui è stato inviato il messaggio precedente nella catena)
  • data e ora fisse di spedizione entro UTC nel formato 2024-12-27 14:25:55
Squadra /send ha 3 principali contesti di utilizzo:

I parametri opzionali per i comandi sono indicati tra parentesi quadre.

/send in General argomento come reply per messaggiare

Invia un messaggio all'elenco di destinatari desiderato
↳ /send test [now,delay,datetime] [instance_id]
Invia specificato in reply messaggio a te stesso per il test
↳ /send all [now,delay,datetime] [instance_id]
Invia specificato in reply messaggio a tutti gli utenti con cui c'è mai stato un dialogo tramite Hotline
↳ /send file [now,delay,datetime] [instance_id]
Invia specificato in reply messaggio a tutti gli utenti, user_id che sono indicati nel file allegato. Lista user_id in un file possono essere separati da virgole, spazi o ritorni a capo. I valori non numerici del file vengono ignorati.
↳ /send list [now,delay,datetime] [instance_id] USERS_LIST
Invia specificato in reply messaggio a tutti gli utenti, user_id specificati nell'elenco (l'ultimo parametro del comando). Valori nell'elenco user_id separati da virgole.
↳ /send mark MARK_NAME [now,delay,datetime] [instance_id]
Invia specificato in reply messaggio a tutti gli utenti con una determinata etichetta MARK_NAME comando cookie /mark.
Parametro facoltativo instance_id può essere specificato se più istanze sono collegate ad un gruppo backend ed è necessario indicare esplicitamente per quale di esse il comando da General argomento. Per impostazione predefinita, tutti i comandi vengono eseguiti in modo indipendente per ciascuna istanza Hotline.
Crea un modello per inviare o aggiungere un messaggio a un modello esistente
↳ /send TEMPLATE_NAME [now,delay,datetime]
Aggiunge quanto specificato in reply messaggio a un modello nuovo o esistente denominato TEMPLATE_NAME. Il nome del modello deve iniziare con una lettera latina, può contenere numeri, un trattino o un carattere di sottolineatura e non fa distinzione tra maiuscole e minuscole. Un modello può contenere un messaggio o una catena di messaggi. È possibile impostare l'ora in cui viene inviato il messaggio (dal momento in cui viene richiamato il comando per il primo messaggio o dal momento in cui viene inviato il messaggio precedente nella catena).

/send in General argomento (senza reply)

Invia messaggi da un modello specificato all'elenco di destinatari desiderato
/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]
Invia modello TEMPLATE_NAME a me stesso per il test
/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]
Invia modello TEMPLATE_NAME a tutti gli utenti con cui c'è mai stato un dialogo tramite Hotline
/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]
Invia modello TEMPLATE_NAME a tutti gli utenti, user_id che sono indicati nel file allegato. Lista user_id in un file possono essere separati da virgole, spazi o ritorni a capo. I valori non numerici del file vengono ignorati.
/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USERS_LIST
Invia modello TEMPLATE_NAME a tutti gli utenti, user_id specificati nell'elenco (l'ultimo parametro del comando). Valori nell'elenco user_id separati da virgole.
/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]
Invia modello TEMPLATE_NAME tutti gli utenti con una determinata etichetta MARK_NAME comando cookie /mark.
Visualizza l'elenco o le proprietà dei modelli e degli invii creati
/send templates
Mostra tutti i modelli di newsletter creati.
/send sendings [instance_id]
Mostra gli ultimi messaggi di posta creati (se più istanze sono connesse al gruppo backend, puoi specificare quale).
/send TEMPLATE_NAME
Mostra le proprietà del modello di posta specificato.
/send sidSENDING_ID
Mostra lo stato e le proprietà dell'invio specificato, nonché ottieni un rapporto sulla sua esecuzione fino ad oggi.
Modifica ed eliminazione di modelli e invii
/send TEMPLATE_NAME name NEW_NAME
Imposta un nuovo nome per il modello
/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]
Imposta una nuova ora di invio nel modello per un messaggio con l'ID specificato
/send TEMPLATE_NAME del MESSAGE_ID
Rimuove un messaggio con un ID specificato dal modello
/send TEMPLATE_NAME del
Elimina il modello specificato
/send sidSENDING_ID del
Elimina e annulla un mailing con l'ID specificato (disponibile solo se il mailing non è stato ancora effettuato ed è nello stato awaits)

/send in un argomento personalizzato (senza reply)

Invio del modello specificato all'utente dell'argomento
/send TEMPLATE_NAME [now,delay,datetime]
Inoltre, è possibile specificare l'ora di invio.
Visualizzazione di informazioni su modelli e invii
/send templates
Mostra i modelli creati nel gruppo backend.
/send sendings
Mostra invii tramite comando /send per l'argomento attuale.
/send sidSENDING_ID
Mostra lo stato e le proprietà dell'invio specificato (senza ricevere un report).
IMPORTANTE: Dopo aver aggiunto le estensioni bot @hotlinetg_extensions_bot tutte le funzioni di comando richiamate negli argomenti utente al tuo gruppo backend /send и /mark diventare disponibili a tutti gli utenti del gruppo backend (dipendenti, manager). Allo stesso tempo, le funzioni amministrative delle squadre /send, /mark o /exportchiamato General l'argomento può essere limitato tramite il parametro @EXTENSIONS_ALLOWED@ alla connessione corrispondente nel bot di installazione @hotlinetg_bot.

Opzioni di utilizzo dei comandi /mark

Squadra /mark ti consente di assegnare una serie arbitraria di etichette agli argomenti con dialoghi sul lato del gruppo backend (questi possono essere argomenti di dialoghi con utenti o bot, o argomenti per la comunicazione in gruppi).

Le etichette possono essere utilizzate per assegnare proprietà aggiuntive arbitrarie agli argomenti e/o comode operazioni ausiliarie.
Funzionalità dei tag:

  • assegnare argomenti aggiuntivi agli argomenti proprietà per la segmentazione e/o successivo utilizzo negli invii da parte del team /send o durante l'esportazione con il comando /export
  • impostare gli stati della canalizzazione di vendita, quando si imposta lo stato successivo vengono rimossi tutti gli stati precedenti dal set specificato (il parametro after)
  • invio automatico di un modello con una catena di messaggi dopo aver assegnato l'etichetta corrispondente all'argomento (il parametro invia)
  • visualizzando una breve stringa o un emoji nel titolo dell'argomento, contenente le iniziali del gestore responsabile dell'affare, la bandiera del paese/lingua dell'utente o un'altra proprietà (parametro ticker)
Squadra /mark ha 2 principali contesti di utilizzo:

/mark in General argomento

/mark
Mostra un elenco di etichette create per questo gruppo di backend.
/mark new MARK_NAME
Crea una nuova etichetta con il nome indicato. Il nome dell'etichetta deve iniziare con una lettera latina e può contenere lettere latine, numeri, un trattino o un carattere di sottolineatura senza distinzione tra maiuscole e minuscole.
/mark MARK_NAME
Mostra le proprietà del tag e un elenco di argomenti con questo tag.
/mark MARK_NAME after MARK1, MARK0
Imposta il parametro AFTER per l'etichetta. Il valore specifica un elenco di nomi di etichette che verranno rimossi dall'argomento quando viene assegnata questa etichetta. L'elenco può avere qualsiasi lunghezza, i valori sono separati da virgole. Per cancellare un parametro, inviare il valore CLEAR.
/mark MARK_NAME sends TEMPLATE_NAME
Imposta il parametro SENDS per l'etichetta. Il valore specifica il nome del modello di comando /send (con un singolo messaggio o una catena di messaggi) che verrà attivato al momento dell'assegnazione di questa etichetta. Per cancellare un parametro, inviare il valore CLEAR.
/mark MARK_NAME ticker STRING|EMOJI
Imposta il parametro TICKER per l'etichetta. Il valore può essere una stringa breve (lettere latine, numeri, trattino, carattere di sottolineatura) o emoji, che verrà aggiunta al nome dell'argomento quando si assegna questa etichetta. Per cancellare un parametro, inviare il valore CLEAR.
/mark MARK_NAME name NEW_MARK_NAME
Imposta un nuovo nome per l'etichetta.

/mark nell'argomento con dialogo

/mark
Mostra un elenco di tag specificati per questo argomento.
/mark MARK_NAME
Aggiungi l'etichetta specificata per questo argomento.
/mark del MARK_NAME
Rimuovi l'etichetta specificata per questo argomento.

Uso del comando /export

Squadra /export permette di ottenere sotto forma di file l'elenco degli utenti con i quali c'è stata corrispondenza tramite il sistema Hotline e avere l'etichetta specificata.
Il comando può essere utilizzato solo in General argomento del gruppo.
/export all
Esporta tutti gli argomenti come file CSV che contiene tutte le proprietà principali dell'argomento (user_id, data dell'ultimo messaggio, stato del dialogo, nome dell'argomento, tipo di argomento, collegamento all'argomento).
/export MARK_NAME
Esporta tutti gli argomenti con una determinata etichetta come file CSV nel formato sopra descritto.
Se riscontri difficoltà nell'utilizzo delle funzioni del bot dell'estensione, contatta servizio di assistenza.