Exportieren Sie Ihre Teammates und Teammate activity logs zu Amazon S3, Google Cloud Storage oder Azure Blob Storage zusammen mit Ihren Gesprächsdaten.
Geplante Datenexporte deckten früher nur Gespräche ab. Jetzt können Sie auswählen, welche Datenobjekte jeder geplante Export enthält, und Teammate-Daten nach dem gleichen Zeitplan wie alle anderen in Ihren eigenen Cloud-Speicher liefern lassen.
Verwenden Sie es für:
Zugriffsüberprüfungen und Prüfungsnachweise – wer Zugriff auf Ihren Arbeitsbereich hat und was sich geändert hat
Sicherheitsüberwachung – Anmeldungen, Berechtigungsänderungen und SSO-Änderungen in Ihrem eigenen SIEM (Security Information and Event Management System)
Data Governance und Aufbewahrung neben Ihren Gesprächsdaten
Welche Datenobjekte kann ich exportieren?
Die folgende Tabelle beschreibt jedes Datenobjekt: was es enthält und wie häufig es exportiert wird.
Datenobjekt | Inhalt | Wie es exportiert wird |
Gespräche | Gespräche und deren Teile, einschließlich Autoren, Zuweisungen, Tags und benutzerdefinierte Attribute. | Neue und aktualisierte Gespräche bei jedem Lauf |
Teammates | Jeder Teammate im Arbeitsbereich mit Name, E-Mail-Adresse und Rolle. | Ein vollständiger Schnappschuss bei jedem Lauf |
Teammate activity logs | Ein Protokoll der Teammate-Kontoaktivitäten, wie Anmeldungen, Berechtigungsänderungen und SSO-Änderungen. | Neue Aktivitäten seit dem vorherigen Lauf |
Jedes Datenobjekt läuft als eigener Export nach Ihrem bestehenden Zeitplan und wird im selben Bucket in einem separaten Ordner pro Objekt abgelegt. Läufe werden separat verfolgt, sodass ein Problem mit einem Datenobjekt die anderen nicht stoppt.
Teammate-Daten werden als JSON oder JSONL (JSON Lines – ein Format, bei dem jede Zeile ein separates JSON-Objekt ist, nützlich für das Streaming großer Datensätze) exportiert, unter Verwendung desselben Schemas wie die List all admins und List all activity logs Endpunkte der Data API version, auf die Ihr Export eingestellt ist.
Wo landen exportierte Teammate-Daten in meinem Bucket?
Teammate-Daten werden in einem eigenen Ordner pro Datenobjekt abgelegt, sodass sie sich nie mit Ihren Gesprächsdateien vermischen. Ihre bestehenden Gesprächsdateien werden nicht verschoben – sie bleiben genau dort, wo sie heute sind, im Stammordner Ihres Exports.
Teammate-Daten werden in dedizierten Unterordnern innerhalb Ihres bestehenden Export-Buckets gespeichert, getrennt von Ihren Gesprächsdateien, wie unten gezeigt.
Ordner | Inhalt |
| Ihre Gesprächsdateien, unverändert |
| Teammates |
| Teammate activity logs |
Wenn Sie Export data dated folders aktiviert haben, befindet sich der Datumsordner innerhalb des Datenobjektordners, nicht umgekehrt:
Datumsordner | Beispielpfad |
Aus |
|
An |
|
Wenn Sie Ihr Gesprächspräfix in einer nachgelagerten Pipeline mit einem Glob-Muster verwenden, funktioniert dieses Muster weiterhin unverändert und nimmt keine Teammate-Dateien auf.
Dateinamen folgen der gleichen Konvention wie Gesprächsexporte – <batch start>-<batch end>-<batch id> in UTC, wobei : durch - ersetzt wird, und eine .json- oder .jsonl-Erweiterung entsprechend Ihrem Ausgabeformat.
Anzahl der Dateien pro Lauf:
Teammates – eine Datei pro Lauf, die das gesamte Verzeichnis enthält.
Teammate activity logs – eine oder mehrere Dateien pro Lauf, aufgeteilt in Chargen wie Gespräche.
Das Datum im Ordnernamen ist das Datum, an dem der Export ausgeführt wurde, nicht das Datum, an dem die Aktivität stattfand.
Was benötige ich vor dem Export von Teammate-Daten?
Berechtigungen. Sie benötigen sowohl Manage teammates als auch See all teammates and team details. Ohne beide werden die Teammate-Datenobjekte nicht angeboten.
Ziel. Teammate-Datenobjekte sind für AWS S3, Google Cloud Storage und Azure Blob Storage verfügbar. Für Snowflake Data Share-Ziele sind sie nicht verfügbar.
Data API version. Teammate-Aktivitätsprotokolle erfordern eine aktuelle Data API version. Exporte, die auf eine ältere Version festgelegt sind, können diese nicht enthalten.
So exportieren Sie Teammate-Daten in die Cloud-Speicherung
1. Gehen Sie zu Einstellungen > Daten > Importe & Exporte > Daten exportieren und öffnen Sie Ihren bestehenden Datenexport oder wählen Sie Neuer Datenexport.
Wenn Sie einen neuen Export erstellen, folgen Sie Export conversations data to cloud storage, um Ihre Data API version, das Ausgabeformat, Ordneroptionen, Ziel-Bucket und Zeitplan zuerst zu konfigurieren.
2. Markieren Sie im Abschnitt Data objects die Datenobjekte, die Sie exportieren möchten. Sie können jede beliebige Kombination auswählen.
Ein Export benötigt mindestens ein Datenobjekt. Das letzte verbleibende markierte Kontrollkästchen ist deaktiviert – markieren Sie ein anderes Datenobjekt, bevor Sie es entfernen.
3. Scrollen Sie zum Seitenende und klicken Sie auf Aktualisieren (oder Datenexport starten für einen neuen Export).
4. Ein Bestätigungsdialog erscheint, wenn Teammate-Daten zu- oder abfließen. Es gibt zwei Versionen, je nachdem, ob Sie ein Datenobjekt hinzufügen oder entfernen – lesen Sie den Dialog und klicken Sie auf Änderungen speichern.
Wenn Sie Teammate-Daten hinzufügen, bestätigt der Dialog, dass diese ab dem nächsten geplanten Lauf enthalten sind, dass es sich um persönliche Daten handelt (Namen, E-Mail-Adressen und Rollen sowie Kontoaktivitäten wie Anmeldungen, Berechtigungsänderungen und SSO-Änderungen) und dass sie in einem von Ihnen kontrollierten Speicher geschrieben werden – daher kann Intercom sie nach dem Export nicht abrufen oder löschen.
Wenn Sie ein Datenobjekt entfernen, erklärt der Dialog, was Sie wiederherstellen können:
Teammate activity logs – wenn Sie sie innerhalb weniger Tage wieder aktivieren, holt der nächste Export die Daten nach. Danach kann nur ein historischer Export, der von Intercom angefordert wird, die Lücke füllen.
Teammates – jeder Lauf exportiert die vollständige Liste, sodass das erneute Aktivieren die kompletten Daten ohne dauerhafte Lücke wiederherstellt.
Ein Speichern, das sowohl Datenobjekte hinzufügt als auch entfernt, zeigt einen einzigen Dialog für beides. Durch Klicken auf Abbrechen wird nichts gesendet und Ihre nicht gespeicherte Auswahl bleibt auf dem Bildschirm. Sobald Sie Teammate-Datenobjekte gespeichert haben, werden Sie für nicht zusammenhängende Änderungen, wie das Wechseln des Ausgabeformats, nicht erneut aufgefordert.
5. Überprüfen Sie nach dem nächsten geplanten Lauf Ihren Bucket. Teammate-Daten erscheinen in einem eigenen Ordner pro Datenobjekt – admins/ und admin_activity_logs/.
6. Um zu bestätigen, dass ein Export ausgeführt wurde, gehen Sie zurück zu Einstellungen > Daten > Importe & Exporte > Daten exportieren und prüfen Sie den Tab Läufe. Jede Zeile ist mit dem Datenobjekt beschriftet – Conversations, Teammates oder Teammate activity logs.
7. Um zu sehen, wer Ihre Exportkonfiguration wann geändert hat, gehen Sie zu Einstellungen > Arbeitsbereich > Teammates > Aktivitätsprotokoll und filtern Sie nach Datenexportereignissen. Einträge zeigen, welche Datenobjekte betroffen waren. Ereignisse vor Einführung dieser Funktion behalten ihre ursprüngliche Formulierung ohne Datenobjekte bei.
8. Um den Export von Teammate-Daten zu stoppen, entfernen Sie die Markierungen bei den Datenobjekten, klicken Sie auf Aktualisieren und bestätigen Sie. Das Löschen des gesamten Exports entfernt die Konfiguration, löscht jedoch keine bereits in Ihrem Bucket gespeicherten Dateien.
Was sind die aktuellen Einschränkungen?
Die folgenden Einschränkungen gelten für den Export von Teammate- und Aktivitätsprotokolldaten in die Cloud-Speicherung.
Intercom kann exportierte Dateien nicht löschen. Sobald Daten in Ihren Bucket geschrieben wurden, kann Intercom nur noch schreiben – es kann nicht lesen oder löschen. Löschanfragen können nicht auf exportierte Dateien angewendet werden, daher liegt es in Ihrer Verantwortung, Daten eines Teammates aus bereits in Ihrem Bucket gespeicherten Dateien zu entfernen. Dies entspricht dem Verhalten bei bestehenden Gesprächsexporten.
Teammates ist eine vollständige Momentaufnahme, kein Delta. Jeder Lauf exportiert Ihre gesamte Liste in einer einzigen Datei. Es gibt keinen inkrementellen oder nur geänderten Modus und keine Filterung nach einzelnen Teammates oder Datumsbereichen.
Kein Self-Service-Historienexport für Teammate-Daten. Im Gegensatz zu Gesprächen gibt es keine Option für eine zweijährige Nachholung – Teammate-Daten fließen erst ab dem nächsten geplanten Lauf nach der Aktivierung. Wenn Sie frühere Aktivitäten benötigen, wenden Sie sich an den Support, und Intercom kann einen historischen Export für Sie durchführen.
Mindestens ein Datenobjekt ist erforderlich. Sie können einen Export nicht ohne markierte Datenobjekte lassen.
Teammate activity logs benötigen eine aktuelle Data API version. Exporte, die auf eine ältere Version festgelegt sind, können diese nicht enthalten.
Einige Aktivitäten sind anonymisiert. Wenn eine Aktion von einem Konto ausgeführt wurde, das nicht mehr auf der Teammate-Liste Ihres Arbeitsbereichs steht, werden die ID und IP-Adresse des Akteurs nicht einbezogen. Die Metadaten des Aktivitätsprotokolls sind auf eine kuratierte Auswahl von Feldern beschränkt, sodass ein exportiertes Aktivitätsprotokoll weniger Details enthalten kann als derselbe Datensatz aus der Data API.
Ein Arbeitsbereich pro Bucket. Wie bei Gesprächen können Sie nicht mehrere Arbeitsbereiche in denselben Bucket exportieren.
Fehlerbehebung
Wenn in Ihrer Exportkonfiguration oder Laufhistorie etwas nicht stimmt, verwenden Sie die folgende Tabelle zur Diagnose.
Was Sie sehen | Was es bedeutet |
Teammate-Kontrollkästchen fehlen, aber Conversations werden angezeigt | Wahrscheinlich fehlen Ihnen Manage teammates und/oder See all teammates and team details. |
Ein Kontrollkästchen ist ausgegraut und lässt sich nicht deaktivieren | Es ist das letzte verbleibende Datenobjekt. Markieren Sie zuerst ein anderes. |
Ein Kontrollkästchen ist markiert und ausgegraut | Der Export enthält dieses Datenobjekt bereits, aber es kann hier nicht geändert werden – Ihre Berechtigungen oder die Data API version des Exports haben sich nach der Einrichtung geändert. Bitten Sie einen Teammate mit vollen Berechtigungen oder kontaktieren Sie den Support. |
„Sie benötigen die Berechtigung, Teammates zu verwalten und alle Teammates und Teamdetails zu sehen…“ | Sie haben nicht beide erforderlichen Berechtigungen. Ein Administrator kann diese unter Einstellungen > Teammates vergeben. |
„Aktualisieren Sie die Seite, um die verfügbaren Objekttypen zu sehen…“ | Die verfügbaren Datenobjekte haben sich seit dem Laden der Seite geändert, meist eine Data API version, die keine Aktivitätsprotokolle bereitstellen kann. Aktualisieren Sie die Seite und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support. |
Ein Lauf erscheint im Tab Läufe, aber keine Datei landet in Ihrem Bucket | Meistens Berechtigungen für den Bucket. Klicken Sie erneut auf die Schaltfläche Test für Ihr Ziel und kontaktieren Sie den Support. |
Einige Aktivitätsprotokollzeilen haben keinen Akteur oder leere Metadaten | Erwartet – der Teammate, der die Aktion ausgeführt hat, ist nicht mehr auf der Liste Ihres Arbeitsbereichs. |
Exportierte Metadaten unterscheiden sich von | Erwartet — Exporte verwenden eine strengere, kuratierte Auswahl an Metadatenfeldern als die API-Antwort. |
Sie haben ein Zeitfenster verpasst und müssen es nachfüllen | Kontaktieren Sie den Support — Intercom kann einen historischen Export Ihrer Team- und Aktivitätsprotokolldaten durchführen. |