Esportazione Database Clienti con il Comando `/export`¶

Il comando /export esporta le informazioni sui dialoghi Hotline come report tabellare di utenti e chat di gruppo. Puoi esportare tutti i dialoghi attivi, selezionarli tramite una o più etichette, escludere determinate etichette o ottenere informazioni sui topic eliminati. Puoi anche aggiungere dati Telegram aggiornati: lingua, username, nome e telefono.

In questa pagina, etichetta indica una marca Hotline (mark) creata e assegnata con il comando /mark. La sintassi e il campo CSV mantengono quindi il termine tecnico mark.

Come Funziona¶

Il comando funziona solo nel topic General del gruppo backend. All'avvio appare un messaggio in General e l'operatore riceve una notifica nella chat privata con il bot di configurazione.

Il CSV completato viene inviato all'operatore in questa chat privata. In General viene pubblicato solo un riepilogo con modalità, numero di righe ed errori. Se il bot di configurazione non può inviare un messaggio privato all'operatore, l'esportazione non inizia.

Caratteristiche Principali¶

Esportazione di tutti i dialoghi attivi
Selezione tramite una o più etichette
Esclusione dei dialoghi con determinate etichette
Esportazione delle informazioni sui topic eliminati
Dati Telegram aggiornati: username, nome, lingua e telefono
Selezione della connessione quando più connessioni usano lo stesso gruppo backend
Arresto di un'esportazione in corso

Formato di Esportazione¶

Per i dialoghi attivi, il CSV contiene i seguenti campi:

Campo	Descrizione
`chat_id`	Identificatore della chat o dell'utente Telegram; i topic usano `chat_id(thread_id)`
`last_date`	Data dell'ultimo messaggio nel topic
`status`	Stato attuale del dialogo (`user_answered`, `support_answered`, `closed`)
`title`	Nome del topic
`frontend_type`	Tipo di topic (`private`, `group`, `channel`, ecc.)
`topic_link`	Link al topic nel gruppo backend
`marks`	Marche Hotline assegnate con `/mark`, chiamate etichette in questa pagina
`ignore_chat`	Indica se la chat è inclusa in `IGNORE_CHATS`

Per i dialoghi eliminati sono disponibili chat_id, last_date, status, title e frontend_type.

L'opzione with aggiunge i campi selezionati username, name, lang e phone. Viene aggiunta anche la colonna error se Hotline non riesce a ottenere da Telegram i dati aggiornati di una chat.

Formato CSV

Il file CSV può essere aperto in Excel, Google Sheets o importato in altri sistemi CRM per ulteriore elaborazione.

/export invia il report CSV all'operatore. Con accesso API, lo stesso report completato può essere ottenuto come TSV tramite /api/v2/export/{export_id}/report?format=tsv.

Chiamata del Comando¶

Aiuto¶

/export
/export help

Entrambi i comandi mostrano l'aiuto in inglese.

Tutti i Dialoghi Attivi¶

/export all

Esporta tutti i dialoghi attivi della connessione corrente.

Dialoghi con Etichette¶

/export mark deal
/export mark vip,deal

Se indichi più etichette, il report include i dialoghi che ne hanno almeno una. /export mark vip,deal seleziona i dialoghi con etichetta vip oppure deal.

Se una delle etichette non esiste, l'esportazione non inizia. Separa i nomi con virgole.

Escludere Etichette¶

/export all exclude spam,test
/export mark vip,deal exclude blocked

exclude rimuove i dialoghi che hanno almeno una delle etichette indicate. Può essere usato con all e mark.

Dialoghi Eliminati¶

/export deleted

Esporta le informazioni dall'archivio dei topic eliminati. Le etichette e exclude non sono usati in questa modalità.

I dati provengono dal database Hotline. Per verificare prima i topic e archiviare quelli mancanti, esegui /sync all deleted in General. Con molti dialoghi, prova prima dry su un numero limitato, ad esempio /sync 10 dry.

Dati Aggiuntivi¶

/export all with username,name
/export mark vip,deal with lang,phone
/export deleted with data

Dopo with, indica username, name, lang e phone separati da virgole. data è l'abbreviazione per tutti e quattro i campi.

I dati aggiornati vengono richiesti a Telegram, aumentando il tempo di generazione. In caso di restrizioni Telegram per account o bot connessi, alcune righe possono contenere un valore in error invece dei dati richiesti.

Selezionare una Connessione¶

/export all instance INSTANCE_ID
/export mark vip,deal instance INSTANCE_ID with data

instance INSTANCE_ID esegue l'esportazione solo per la connessione indicata. È utile quando più bot o account usano lo stesso gruppo backend.

Arrestare l'Esportazione¶

/export stop

Arresta l'esportazione attiva della connessione. Non viene creato un report parziale. Per ogni connessione può essere eseguita una sola esportazione alla volta.

Note Importanti¶

Diritti di accesso

L'accesso è controllato da EXTENSIONS_ALLOWED. Se l'elenco è vuoto o assente, tutti gli operatori del gruppo backend possono usare il comando. Un elenco non vuoto lo consente solo agli operatori indicati.

Riservatezza

Il CSV può contenere identificatori delle chat, attributi interni di segmentazione, nomi e numeri di telefono. Rispetta le regole di riservatezza. È consigliabile scaricare subito i file e rimuoverli dalla chat al termine.

Esportazione regolare

Effettua esportazioni regolari del database per creare backup.

Limite di Dimensione

Un report può contenere fino a 100.000 righe. Se il risultato supera questo limite, l'esportazione termina con un errore.

Esportazione Database Clienti con il Comando /export¶