Kundendatenbank-Export mit Befehl `/export`¶

Der Befehl /export exportiert Informationen über Hotline-Dialoge als tabellarischen Bericht mit Benutzern und Gruppenchats. Sie können alle aktiven Dialoge exportieren, Dialoge nach einem oder mehreren Labels auswählen, bestimmte Labels ausschließen oder Informationen über gelöschte Topics abrufen. Außerdem können Sie die Dialogliste mit aktuellen Telegram-Daten wie Sprache, Username, Name und Telefonnummer anreichern.

Auf dieser Seite bezeichnet Label eine Hotline-Markierung (mark), die mit dem Befehl /mark erstellt und zugewiesen wird. In der Befehlssyntax und im CSV-Feld bleibt daher der technische Begriff mark unverändert.

Funktionsweise¶

Der Befehl funktioniert nur im Topic General der Backend-Gruppe. Nach dem Start erscheint dort eine Meldung, und der Operator erhält im privaten Chat mit dem Setup-Bot eine Benachrichtigung über die Berichtserstellung.

Die fertige CSV-Datei wird dem Operator im privaten Chat mit dem Setup-Bot gesendet. In General erscheint nur eine kurze Zusammenfassung mit Exportmodus, Zeilenanzahl und Fehleranzahl. Wenn der Setup-Bot dem Operator keine private Nachricht senden kann, startet der Export nicht.

Hauptfunktionen¶

Export aller aktiven Dialoge
Auswahl nach einem oder mehreren Labels
Ausschluss von Dialogen mit bestimmten Labels
Export von Informationen über gelöschte Topics
Ergänzung aktueller Telegram-Daten: Username, Name, Sprache und Telefonnummer
Auswahl einer Verbindung bei mehreren Verbindungen in derselben Backend-Gruppe
Stoppen eines laufenden Exports

Exportformat¶

Für aktive Dialoge enthält die CSV-Datei folgende Felder:

Feld	Beschreibung
`chat_id`	Telegram-Chat- oder Benutzer-ID; Topics verwenden das Format `chat_id(thread_id)`
`last_date`	Datum der letzten Nachricht im Topic
`status`	Aktueller Dialogstatus (`user_answered`, `support_answered`, `closed`)
`title`	Topic-Name
`frontend_type`	Topic-Typ (`private`, `group`, `channel` usw.)
`topic_link`	Link zum Topic in der Backend-Gruppe
`marks`	Mit `/mark` zugewiesene Hotline-Markierungen, auf dieser Seite Labels genannt
`ignore_chat`	Zeigt an, ob der Chat im Parameter `IGNORE_CHATS` enthalten ist

Für gelöschte Dialoge stehen die Felder chat_id, last_date, status, title und frontend_type zur Verfügung.

Die Option with fügt ausgewählte Felder username, name, lang und phone hinzu. Zusätzlich erscheint die Spalte error, wenn Hotline aktuelle Telegram-Daten für einen bestimmten Chat nicht abrufen konnte.

CSV-Format

Die CSV-Datei kann in Excel, Google Sheets geöffnet oder zur weiteren Verarbeitung in andere CRM-Systeme importiert werden.

Der Befehl /export sendet dem Operator den Bericht als CSV. Mit API-Zugriff kann derselbe fertige Bericht über den Endpoint /api/v2/export/{export_id}/report?format=tsv als TSV abgerufen werden.

Befehl aufrufen¶

Hilfe¶

/export
/export help

Beide Befehle zeigen die Hilfe auf Englisch an.

Alle aktiven Dialoge¶

/export all

Exportiert alle aktiven Dialoge der aktuellen Verbindung.

Dialoge mit Labels¶

/export mark deal
/export mark vip,deal

Wenn mehrere Labels angegeben werden, enthält der Bericht Dialoge mit mindestens einem davon. /export mark vip,deal wählt beispielsweise Dialoge mit dem Label vip oder deal aus.

Existiert eines der angegebenen Labels nicht, startet der Export nicht. Trennen Sie Label-Namen durch Kommas.

Labels ausschließen¶

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

Die Option exclude entfernt Dialoge, die mindestens eines der danach aufgeführten Labels haben. Sie kann mit den Modi all und mark verwendet werden.

Gelöschte Dialoge¶

/export deleted

Exportiert Informationen aus dem Archiv gelöschter Topics. Labels und exclude werden in diesem Modus nicht verwendet.

Die Exportdaten stammen aus der Hotline-Datenbank. Um vorher zu prüfen, ob Topics noch existieren, und fehlende Topics ins Archiv zu verschieben, führen Sie /sync all deleted im Topic General aus. Bei vielen Dialogen empfiehlt sich zuerst ein Test mit dry und einer begrenzten Anzahl, zum Beispiel /sync 10 dry.

Zusätzliche Daten¶

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

Nach with können Sie die Felder username, name, lang und phone durch Kommas getrennt angeben. data ist die Kurzform für alle vier Felder.

Die aktuellen Daten werden über Telegram abgerufen, wodurch die Berichtserstellung länger dauert. Bei Telegram-seitigen Einschränkungen für verbundene Konten oder Bots kann in einzelnen Zeilen statt der angeforderten Daten ein Wert in der Spalte error stehen.

Verbindung auswählen¶

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

Die Option instance INSTANCE_ID führt den Export nur für die angegebene Verbindung aus. Das ist nützlich, wenn mehrere Bots oder Konten mit derselben Backend-Gruppe verbunden sind.

Export stoppen¶

/export stop

Stoppt den aktiven Export der Verbindung. Beim Stoppen wird kein Teilbericht erstellt. Pro Verbindung kann nur ein Export gleichzeitig ausgeführt werden.

Wichtige Hinweise¶

Zugriffsrechte

Der Zugriff wird über den Parameter EXTENSIONS_ALLOWED gesteuert. Ist die Liste leer oder nicht vorhanden, steht der Befehl allen Operatoren der Backend-Gruppe zur Verfügung. Eine nicht leere Liste erlaubt ihn nur den angegebenen Operatoren.

Vertraulichkeit

Die CSV-Datei kann Chat-IDs, interne Segmentierungsmerkmale, Namen und Telefonnummern enthalten. Beachten Sie beim Umgang mit exportierten Daten die Datenschutzregeln. Es wird empfohlen, Exportdateien sofort herunterzuladen und nach Abschluss der Arbeit aus dem Chat zu löschen.

Regelmäßiger Export

Führen Sie regelmäßige Datenbankexporte durch, um Backups zu erstellen.

Größenlimit

Ein Bericht kann bis zu 100.000 Zeilen enthalten. Überschreitet das Ergebnis dieses Limit, wird der Export mit einem Fehler beendet.

Kundendatenbank-Export mit Befehl /export¶