Kontakt-Import & -Export

Massenimport von Kontakten

CSV- und Excel-Datei-Import

Das System bietet umfassende Massenimport-Funktionen für effizientes Kontaktmanagement:

Unterstützte Dateiformate:

CSV-Dateien: Standard-Format mit kommagetrennten Werten
Excel-Dateien: Sowohl .xls als auch .xlsx werden unterstützt
Dateivalidierung: Automatische Formaterkennung und -validierung
Dateigrößenlimits: Sinnvolle Größenlimits für die Performance

Importprozess-Überblick:

Datei-Upload: Kontaktdateien über die Massen-Upload-Oberfläche hochladen
Header-Parsing: Automatische Erkennung und Verarbeitung der Datei-Header
Feldzuordnung: Spalten der Datei Kontaktdatenbankfeldern zuordnen
Datenimport: Stapelverarbeitung für effiziente Kontakterstellung

Import-Berechtigung:

Kontakt-Erstellungsberechtigungen für Importvorgänge erforderlich
Teambasierte Zugriffskontrolle für die Importfunktion
Benutzerauthentifizierung für alle Importvorgänge erforderlich
Berechtigungsprüfung vor der Verarbeitung von Importdateien

Import-Workflow

Der Kontaktimport folgt einem strukturierten Ablauf:

Schritt 1: Datei-Upload und -Parsing

CSV- oder Excel-Dateien über das Massen-Upload-Modal hochladen
Automatische Dateiformat-Validierung (nur csv, xls, xlsx)
Header-Extraktion und Zeilenanzahl-Berechnung
Datei-Parsing mit Fehlerbehandlung bei ungültigen Formaten

Schritt 2: Feldzuordnungs-Konfiguration

Anzeige der erkannten Datei-Header zur Zuordnung
Verfügbare Kontaktfelder zur Zuordnungsauswahl
Zuordnungsvalidierung gegen doppelte Spaltenzuordnung
Option, alle Header oder nur erforderliche Spalten zuzuordnen

Schritt 3: Datenverarbeitung und Import

Kontaktdaten-Transformation über ContactDTO-Objekte
Stapelverarbeitung für effiziente Datenbankoperationen (100 Kontakte pro Stapel)
Einzelne Kontakterstellung als Fallback bei fehlgeschlagenen Stapeloperationen
Import-Erfolgsverfolgung mit Gesamtanzahl importierter Kontakte

Pipedrive-Import (Persons und Organizations)

Laden Sie den Pipedrive-„Persons“-Export (CSV/XLS/XLSX) im Dialog Kontakte → Massen-Upload/Import unter dem Tab „Pipedrive: Persons“ hoch.

Was importiert wird:

Kontakte (aus Persons): Name, E-Mail, Telefon, Firmenname und grundlegende Felder
Optionale Verknüpfung mit bestehendem Kunden über Firmennamen

Verhalten:

Idempotente Zuordnung wird intern beibehalten; Duplikate werden nicht hart blockiert, um Importe flexibel zu halten
Nach Abschluss wird eine Zusammenfassung (erstellt/aktualisiert/übersprungen) angezeigt

Für Kunden (aus Organizations) öffnen Sie Kunden → Massen-Upload/Import und nutzen den Tab „Pipedrive: Organizations“, um Organisations-/Firmendaten in Kunden zu importieren. Unterstützte Formate: CSV, XLS, XLSX.

Import-Feldzuordnung

Zuordnung von Dateispalten zu Kontaktfeldern

Das Feldzuordnungssystem ermöglicht flexible Spalten-zu-Feld-Zuordnung:

Zuordnungs-Konfiguration:

Spaltenindex: Numerischer Index der Spalten in der hochgeladenen Datei
Spaltenname: Ursprünglicher Header-Name aus der hochgeladenen Datei
Zugeordnete Spalte: Ziel-Kontaktfeld für die Datenzuweisung
Zuordnungsvalidierung: Erforderliche Zuordnungsangabe für alle genutzten Spalten

Verfügbare Kontaktfelder:

Alle Standard-Kontaktfelder über ContactDTO für die Zuordnung verfügbar
Persönliche Felder: first_name, last_name, email, phone, birth_date
Geschäftliche Felder: company_name, website, description
Adressfelder: address_line_1, city, zip, country
Soziale Felder: skype, telegram, linkedin
Systemfelder: client_id, outreach_id, company_id

Zuordnungs-Validierungsregeln:

Erforderliche Zuordnungen: Jede Zuordnung muss Index und zugeordnete Spalte angeben
Duplikatvermeidung: Dasselbe Kontaktfeld darf nicht mehreren Spalten zugeordnet werden
Spaltenvalidierung: Zugeordnete Spalten müssen gültige Kontaktfelder sein
Indexvalidierung: Spaltenindizes müssen gültige Ganzzahlen sein

Erweiterte Zuordnungsfunktionen

Das Zuordnungssystem umfasst ausgefeilte Validierung und Fehlervermeidung:

Zuordnungsvalidierung:

Duplikaterkennung: Verhindert Zuordnung mehrerer Dateispalten zum gleichen Kontaktfeld
Vollständige Zuordnung: Stellt sicher, dass alle erforderlichen Zuordnungen angegeben sind
Spaltenkonsistenz: Stellt sicher, dass zugeordnete Spalten in der Kontaktfeldliste existieren
Zuordnungsvollständigkeit: Validiert, dass alle Datei-Header Zuordnungen haben

Fehlervermeidung:

Frontend-Validierung verhindert ungültige Zuordnungskonfigurationen
Echtzeit-Validierungsrückmeldung beim Einrichten der Zuordnung
Klare Fehlermeldungen bei Zuordnungskonflikten
Zuordnungsvalidierung vor Beginn der Importverarbeitung

Flexible Zuordnungsoptionen:

Optionale Feldzuordnung ermöglicht Teil-Datenimport
Leere Spaltenzuordnung überspringt ungenutzte Dateispalten
Flexible Zuordnung unterstützt verschiedene Dateistrukturen
Integration benutzerdefinierter Felder für erweiterte Datenzuordnung

Import-Validierung

Datenvalidierung und Fehlerbehandlung

Das Import-System umfasst umfassende Validierung und Fehlerbehandlung:

Dateivalidierung:

Formatvalidierung: Nur CSV-, XLS- und XLSX-Dateien werden akzeptiert
Dateistruktur: Header-Zeilenerkennung und -validierung
Datenintegrität: Zeilenweise Datenvalidierung während der Verarbeitung
Fehlerbehebung: Saubere Behandlung von Datei-Parsing-Fehlern

Datenvalidierung beim Import:

Kontaktdaten-Validierung: Jeder Kontakt wird gegen Kontakt-Erstellungsregeln validiert
Pflichtfeldprüfung: Vorname-Pflicht wird beim Import durchgesetzt
E-Mail-Formatvalidierung: E-Mail-Adressen auf korrektes Format validiert
Feldlängenvalidierung: Feldlängenlimits werden beim Import durchgesetzt

Fehlerbehandlung beim Stapelimport:

Stapelverarbeitung: 100 Kontakte pro Stapel für Effizienz
Stapel-Fehlerbehebung: Einzelne Kontakterstellung als Fallback bei fehlgeschlagenen Stapeln
Erfolgsverfolgung: Anzahl erfolgreich importierter Kontakte wird geführt
Fehlerisolation: Fehlgeschlagene Kontakte verhindern nicht den erfolgreichen Import anderer

Import-Fehlerbehebung

Das System bietet robuste Fehlerbehebungsmechanismen:

Vorteile der Stapelverarbeitung:

Große Importe werden in handhabbaren Stapeln verarbeitet
Stapelfehler verhindern nicht den Erfolg anderer Stapel
Speichereffizienz bei großen Kontaktimporten
Performance-Optimierung für Massenoperationen

Fallback auf Einzelkontakte:

Bei fehlgeschlagenen Stapeloperationen Fallback auf Einzel-Kontakterstellung
Fehler bei Einzelkontakten werden protokolliert, stoppen aber nicht den Import
Teilweiser Import-Erfolg ermöglicht maximale Kontakt-Importabschlussrate
Detaillierte Fehlerprotokollierung zur Fehlersuche bei fehlgeschlagenen Kontakten

Fehlerberichterstattung:

Fehlgeschlagene Kontakte mit detaillierten Fehlerinformationen protokolliert
Import-Erfolgsanzahl zur Verifikation bereitgestellt
Fehlermeldungen für Benutzerfeedback zurückgegeben
Umfassende Protokollierung zur Fehlersuche bei Importproblemen

Kontakt-Export

Export von Kontaktdaten für die externe Nutzung

Das Kontaktsystem unterstützt Datenexport für externe Auswertung und Backup:

Export-Integration:

Kontaktdaten über Such- und Filter-APIs verfügbar
JSON-Format-Export für API-Integration
Kontaktsuchergebnisse können programmatisch exportiert werden
Teambasierte Export-Filterung für korrekte Zugriffskontrolle

Export-Datenstruktur:

Kontaktdaten mit allen Standardfeldern exportiert
Werte benutzerdefinierter Felder in den Exportdaten enthalten
Kundenbeziehungsinformationen enthalten
Pipeline-Zuordnungsdaten in Exporten verfügbar

Export-Zugriffskontrolle:

Exportvorgänge erfordern entsprechende Kontaktberechtigungen
Teambasierte Filterung gewährleistet korrekten Datenzugriff
Benutzer-Eigentümer-Filterung für eingeschränkte Exporte verfügbar
Berechtigungsprüfungen für alle Exportvorgänge

Export-Funktionen und -Möglichkeiten

Der Kontakt-Export ist in übergreifende Systemfunktionen integriert:

Suchbasierter Export:

Gefilterte Kontaktlisten basierend auf Suchkriterien exportieren
Team-spezifischer Kontakt-Export mit korrekter Zugriffskontrolle
Kontaktdaten inkl. Beziehungen und Zuordnungen
Flexibler Export abhängig von Benutzerberechtigungen und -zugriff

API-Integration:

Kontaktdaten über API-Endpunkte für externe Integration verfügbar
JSON-Format für einfache Integration mit externen Systemen
Suchfunktion unterstützt programmatischen Kontaktzugriff
Echtzeit-Kontaktdaten-Export

Import-Protokollierung

Verfolgung und Fehlersuche bei Importvorgängen

Das Import-System umfasst umfassende Protokollierung zur Überwachung und Fehlersuche:

Import-Prozess-Protokollierung:

Datei-Parser-Protokoll: Dedizierter file-parser-Log-Kanal für die Dateiverarbeitung
Kontakt-Import-Protokoll: Dedizierter contacts-Log-Kanal für Importvorgänge
Zeilenverarbeitung: Einzelne Zeilenverarbeitung zur Fehlersuche protokolliert
Zuordnungs-Protokoll: Feldzuordnungs-Konfiguration zur Verifikation protokolliert
Pipedrive-Import-Protokoll: Zeilenschlüssel, geparste Werte und Upsert-Aktionen zur Fehlersuche protokolliert

Detaillierte Protokollinformationen:

Dateiverarbeitung: Datei-Header, Zeilenanzahlen und Parsing-Ergebnisse
Zuordnungsdaten: Vollständige Zuordnungskonfiguration und angewendete Zuordnungen
Kontaktdaten: Einzelne Kontaktdaten-Transformation und -Erstellung
Stapeloperationen: Stapelverarbeitungsergebnisse und Erfolgs-/Fehlschlag-Verfolgung

Fehlerprotokollierung und -suche:

Datei-Parsing-Fehler: Detaillierte Fehlerprotokollierung bei Dateiverarbeitungsfehlern
Import-Fehler: Umfassende Fehlerprotokollierung bei fehlgeschlagenen Kontaktimporten
Einzelkontakt-Fehler: Spezifische Fehlermeldungen bei fehlgeschlagener Kontakterstellung
Stack-Trace-Protokoll: Vollständiger Fehlerkontext zur Fehlersuche

Import-Überwachung und -Analyse

Das Protokollierungssystem unterstützt Import-Überwachung und Performance-Analyse:

Performance-Überwachung:

Stapel-Performance: Überwachung der Stapelverarbeitungseffizienz
Import-Erfolgsraten: Verfolgung erfolgreicher vs. fehlgeschlagener Importe
Verarbeitungszeit: Performance-Metriken für Importvorgänge
Fehlermuster: Analyse häufiger Import-Fehlermuster

Import-Analysen:

Import-Volumen: Verfolgung der Kontakt-Importvolumen über die Zeit
Erfolgsmetriken: Analyse von Import-Erfolgsraten und -mustern
Fehleranalyse: Identifikation häufiger Importprobleme
Performance-Optimierung: Daten zur Optimierung der Importprozesse

Fehlersuche-Unterstützung:

Detaillierter Fehlerkontext: Vollständige Fehlerinformationen zur Problemlösung
Import-Nachverfolgung: Vollständiger Prüfpfad der Importvorgänge
Datenvalidierungs-Protokoll: Verfolgung und Analyse von Validierungsfehlern
Systemzustands-Überwachung: Performance- und Zuverlässigkeitsverfolgung des Import-Systems