Daten importieren: CSV-Assistent für Leads, Kontakte, Beziehungen

Tesoro verfügt über einen integrierten Import-Assistenten. Drei Arten von Datensätzen: Leads, Kontakte und Beziehungen. Automatische Spaltenzuordnung, Testimport vor dem endgültigen Import, Batchverarbeitung für große Dateien. Nur für Admins.

Wann verwenden Sie dies?

500 Kontakte aus einem vorherigen CRM im CSV-Format
Eine Liste von Leads aus einer Marketingkampagne
Manuell zusammengestellte Sammlung von Geschäftsbeziehungen (Unternehmen)

Vier Importtypen

Typ	Beschreibung	Navigation
Lead	Buyer-Leads mit Tracking	Leads → Import
Lead (Owner)	Verkäufer mit Immobiliendetails	Leads → Import (Owner wählen)
Contact	Qualifizierte Kontakte	Contacts → Import
Relation	Unternehmen, Geschäftspartner	Relations → Import

CSV-Anforderungen

Eigenschaft	Anforderung
Typ	`.csv`
Maximale Größe	50 MB
Trennzeichen	Komma oder Semikolon (automatische Erkennung)
Kopfzeile	Erste Zeile = Spaltenüberschriften
Codierung	UTF-8 empfohlen

CSV vorbereiten: Richtlinien

Laden Sie die Beispieldatei herunter und verwenden Sie sie als Vorlage.
Behalten Sie die Kopfzeile mit den korrekten Tesoro-Feldnamen bei.
UTF-8 für Sonderzeichen.
Pflichtfelder ausfüllen: sonst werden Zeilen übersprungen.

Telefonnummern

Internationales Format mit Ländervorwahl: +31612345678
Leerzeichen werden automatisch entfernt
Klammern/Bindestriche können Fehler verursachen

Mehrere Werte in einer Zelle

Trennen Sie mit Komma innerhalb derselben Zelle:

property_details.type: apartment, villa, townhouse
property_details.location: Marbella, Estepona, Benahavis

Verschachtelte Felder: Punktsyntax

Präfix	Verschachtelt unter	Beispiel
`address.`	Adresse	`address.city`, `address.street`
`lead.`	Lead-Tracking	`lead.source`, `lead.status`
`property_details.`	Immobilienwünsche	`property_details.type`, `property_details.price_min`
`property_address.`	Immobilienadresse (Verkäufer)	`property_address.street`
`timing.`	Timing	`timing.looking_to`, `timing.timeline_max`
`social.`	Soziale Medien (Beziehungen)	`social.facebook`, `social.linkedIn`

Felder pro Importtyp

Lead-Import

Spalte	Pflicht
`type` (immer `lead`)	Ja
`status`	Ja
`owner_email`	Ja
`salutation`	Nein
`language`	Nein
`first_name`, `last_name`	Ja
`email`, `phone`	Ja
`additional_information`	Nein

Spalte
`address.city`, `address.country`, `address.state`, `address.street`, `address.zip_code`

Spalte	Werte
`lead.source`	Website, Referral, Portals, Cold Calling, …
`lead.status`	New, Contacted, Qualified, Unqualified, Lost, Converted
`lead.stage`	Hot, Neutral, Cold

Spalte
`property_details.type` (mehrere, kommagetrennt)
`property_details.location` (mehrere)
`property_details.number_of_bedrooms`, `_bathrooms`
`property_details.price_min`, `_max`
`property_details.size_min`, `_max`, `size`
`property_details.market_price`

Spalte
`commision` (Provisions-%)
`way_of_selling`
`property_address.street`, `_city`, `_state`, `_zip_code`, `_country`, `_address_line_2`

Spalte
`timing.looking_to`, `timing.timeline_max`

Contact-Import

Spalte	Pflicht
`type` (immer `contact`)	Ja
`status`, `owner_email`	Ja
`salutation`, `role`, `language`	Nein
`first_name`, `last_name`, `email`, `phone`	Ja
`additional_information`	Nein
`address.*`	Nein
`do_not_contact`, `portal_user` (true/false)	Nein

Relation-Import

Spalte	Pflicht
`name`, `type`, `email`, `phone_number`, `status`	Ja
`website_url`, `preferred_communication`, `note`, `credit_terms`	Nein
`address.*`	Nein
`social.facebook`, `social.linkedIn`, `social.instagram`	Nein

Der Import-Assistent: vier Schritte

Datei auswählen: navigieren Sie zum entsprechenden Typ (Leads/Contacts/Relations → Import).

Der Import-Assistent.

CSV hochladen (max. 50 MB). Auf dieser Seite auch:
- Beispieldatei herunterladen für den Typ (Leads: wählen Sie zwischen Leads-Variante und Owners-Variante)
- Importverlauf öffnen für frühere Importe
Weiter →
Felder zuweisen (Mapping): Tesoro analysiert und zeigt pro Spalte:
- Spaltenname aus Datei
- Beispielwert aus Zeile 2
- Dropdown mit Tesoro-Feldern
Automatisches Matching:
- Exakte Übereinstimmung (z.B. first_name)
- Exaktes Label (z.B. First Name)
- Teilweise Übereinstimmung (nicht case-sensitive)
- Vorherige Zuordnung bei gleichen Spaltennamen
Pflichtfelder müssen alle zugewiesen sein, sonst kann nicht fortgefahren werden.

Vorschau → Testimport.
Validieren (Vorschau): KEINE Datensätze erstellt. Pro Zeile:
- Zeilennummer
- Status: erfolgreich / fehlgeschlagen
- Fehlermeldung bei Fehlschlag
Fehler? Zurück zu Schritt 1, CSV korrigieren, erneut hochladen.

Zufrieden? Import klicken → endgültig.
Fertig: Importprotokoll mit erfolgreichen/übersprungenen Zeilen. Bei Erfolg: Verweis auf erstellten Datensatz.

Wie Auto-Mapping funktioniert

Drei Strategien:

Exakte Wert-Übereinstimmung: first_name matcht first_name
Label-Übereinstimmung: First Name (Label) matcht
Teilweise Übereinstimmung: nicht case-sensitive
Vorherige Zuordnung: gleiche Spaltennamen wie bei vorherigem Import → Zuordnungen wiederhergestellt

Pflichtfelder pro Typ

Typ	Pflicht
Lead	first_name, last_name, email, phone, owner_email
Contact	first_name, last_name, email, phone, owner_email
Relation	name, type, email, phone_number, status

Eigentümer bestimmen

owner_email-Spalte → Benutzer pro Zeile gesucht
Fallback → erster Benutzer Ihres Unternehmens

Duplikate: keine Auto-Erkennung

Tesoro führt keine Duplikaterkennung während des CSV-Imports durch. Alle Zeilen werden erstellt, auch bei bestehenden E-Mails.

Duplikate vermeiden:

Überprüfen Sie Ihre CSV im Voraus
Entfernen Sie Duplikate in der Quelle
Testimport zur Ansicht der Anzahlen
Manuell nach dem Import zusammenführen

Häufige Fehler

Fehler	Ursache	Lösung
Pflichtfeld leer	first_name, last_name, email leer	In CSV ausfüllen
Ungültige E-Mail	Kein @ oder Tippfehler	Überprüfen
Ungültige owner_email	Benutzer existiert nicht	Bestehenden Benutzer verwenden
Ungültiger Typ/Status	Nicht in erlaubten Optionen	Mit Beispielsdatei vergleichen
Ungültige Telefonnummer	Kein internationales Format	`+31612345678` verwenden
Ort als Zeichenkette	Multi-Werte nicht korrekt getrennt	Komma innerhalb der Zelle
Name mit Zahlen	first_name/last_name enthält numerische Zeichen	Entfernen

Importprotokoll (Test + endgültig)

Pro Zeile:

Zeilennummer (ab 2, da 1 = Kopfzeile)
Status (Fehler: 0 oder 1)
Fehlermeldung bei Fehlschlag
Erstellter Datensatz bei Erfolg (Ressource + ID)

Batchverarbeitung

Imports werden in Batches von 100 verarbeitet:

Große Dateien automatisch aufgeteilt
Jeder Batch als Hintergrundaufgabe
Live-Fortschritt in der Benutzeroberfläche (“150/500 verarbeitet”)
Polling alle 5 Sekunden

Importverlauf

Importverlauf öffnen auf der Importseite. Tabelle:

Spalte	Beschreibung
Dateiname	Name der CSV
Gesamtzeilen	In der Datei
Verarbeitete Zeilen	Anzahl verarbeitet
Datum	Wann

Paginiert (10 Standard, 10/20/30/40/50 möglich), sortiert neueste zuerst.

Immobilien importieren: andere Route

Nicht über den CSV-Assistenten, sondern über XML-Feed:

Kyero XML-Feeds für Immobilienfeed-Synchronisation
Manuelle XML-Uploads für einmaligen Import

Konfiguriert über Settings → XML Import. Dort legen Sie auch fest, was mit Immobilien geschehen soll, die nicht mehr im Feed sind (z.B. Status “Removed by Feed”).

Acht Tipps für erfolgreichen Import

Beginnen Sie mit Testimport: Assistent macht dies automatisch im Vorschau-Schritt
Beispieldatei als Vorlage: vermeidet Mapping-Probleme
Internationale Telefonnummern mit Ländervorwahl
Gültige E-Mail-Adressen: sonst übersprungen
owner_email matcht bestehenden Benutzer: sonst Fallback
Große Dateien aufteilen: einfacher zu überprüfen im Protokoll
UTF-8 für Sonderzeichen
Multi-Werte mit Komma: nicht Semikolon innerhalb der Zellen

Nächste Schritte

Migrationsübersicht Vollständige Migration zu Tesoro, durch das Tesoro-Team.

Kontakte verwalten Arbeiten Sie mit importierten Kontakten.

Leads verwalten Verwalten Sie importierte Leads in Ihrer Pipeline.