Datenanreicherung (generischer Connector)
Verweisen Sie auf Ihren Anreicherungsanbieter (Clearbit, Apollo, Hunter, People Data Labs, welchen Sie bevorzugen) und füllen Sie automatisch die leeren Felder von Unternehmen und Kontakten aus.
Die Datenanreicherung ist ein generischer, neutraler Connector: Sie nutzen das Konto des von Ihnen bevorzugten Anreicherungsanbieters (Clearbit, Apollo, Hunter, People Data Labs, unter anderen). Sie geben die Adresse des Anbieters, die Art der Authentifizierung und eine Feldzuordnung an; das CRM fragt den Anbieter ab und füllt nur die leeren Felder des Datensatzes aus. Es entstehen keine Kosten auf unserer Seite, und Konto und Abrechnung gehören dem von Ihnen gewählten Anbieter.
Der Connector startet inaktiv: Es passiert nichts, bis Sie ihn konfigurieren. Der von Ihnen angegebene API-Schlüssel wird verschlüsselt gespeichert und niemals wieder angezeigt.
Voraussetzungen
- Ein Konto bei einem Anreicherungsanbieter (Clearbit, Apollo, Hunter, People Data Labs oder einem anderen) mit einem aktiven API-Schlüssel und ausreichenden Guthaben/Plan.
- Die API-Dokumentation dieses Anbieters griffbereit: den Endpunkt, den Authentifizierungsheader (z. B. Authorization: Bearer oder X-Api-Key) und die Struktur des Antwort-JSON (um die Zuordnung zu erstellen).
- In Sellio Administratorzugriff, um den Connector unter Einstellungen → Integrationen zu speichern.
Schritt für Schritt beim Anbieter
- Melden Sie sich im Dashboard Ihres Anreicherungsanbieters an und suchen Sie den Bereich API/Developers.
- Erzeugen (oder kopieren) Sie einen API-Schlüssel.
- Notieren Sie sich den Abfrageendpunkt nach Domain und/oder E-Mail sowie das genaue Format des erforderlichen Authentifizierungsheaders. Jeder Anbieter hat seinen eigenen.
So konfigurieren Sie es
- Öffnen Sie Einstellungen → Integrationen und gehen Sie zur Karte „Datenanreicherung“.
- Endpunkt (URL): Fügen Sie die Adresse des Anbieters mit den Platzhaltern {domain} und/oder {email} ein. Das CRM ersetzt {domain} durch die Domain des Datensatzes (aus Website/Domain oder der E-Mail-Domain) und {email} durch die E-Mail des Datensatzes.
- Authentifizierungsheader und Präfix: Geben Sie den Headernamen (z. B. Authorization) und das Wertpräfix (z. B. „Bearer “ mit Leerzeichen) an. Manche Anbieter verwenden einen eigenen Header wie X-Api-Key ohne Präfix.
- API-Schlüssel: Fügen Sie Ihren Anbieterschlüssel ein. Er wird verschlüsselt gespeichert.
- Feldzuordnung: Jede Zeile verknüpft einen Pfad in der Antwort des Anbieters (links) mit einem CRM-Feld (rechts). Fügen Sie so viele Zeilen hinzu, wie Sie benötigen.
- Speichern Sie den Connector. Nutzen Sie anschließend auf den Detailseiten eines Unternehmens oder Kontakts die Schaltfläche „Anreichern“.
So erstellen Sie die Zuordnung
Die linke Seite ist der Pfad zum Wert innerhalb der JSON-Antwort des Anbieters, wobei Punkte zum Absteigen in Ebenen dienen (und Zahlen für Listenpositionen). Die rechte Seite ist der api_name des CRM-Felds, das den Wert erhält. Es werden nur LEERE Felder ausgefüllt: bereits vorhandene Daten im Datensatz werden niemals überschrieben.
Für die Anreicherung muss der Datensatz mindestens eine Website/Domain oder eine E-Mail haben, da dort {domain}/{email} der Abfrage herkommen. Unternehmen haben meist eine Website; Kontakte und Leads eine E-Mail.
Kein eigener Anbieter: System-Modus und simulierter Modus
Wenn Sie keinen eigenen Anbieter konfigurieren, ist die Schaltfläche „Anreichern“ trotzdem verfügbar. Wenn Sellio über einen aktivierten System-Anbieter verfügt, füllt jede Anreicherung die standardmäßigen firmografischen Felder (Mitarbeiterzahl, Umsatz, Branche, Technologien, LinkedIn, Land) und verbraucht 1 Guthaben pro Datensatz, transparent auf Ihrer Rechnung ausgewiesen. Ganz ohne Anbieter nutzt das CRM simulierte Beispieldaten (kostenlos), praktisch um den Ablauf auszuprobieren. Die Integrationskarte zeigt an, welcher Modus aktiv ist.
Massen- und automatische Anreicherung
- Massenanreicherung: Wählen Sie mehrere Datensätze in der Liste Unternehmen, Kontakte oder Leads aus und klicken Sie in der Aktionsleiste auf „Anreichern“. Das CRM reichert alle auf einmal an und füllt nur die leeren Felder.
- Automatisch bei Erstellung: Aktivieren Sie unter Einstellungen → Integrationen „Bei Datensatzerstellung automatisch anreichern“. Jedes neue Unternehmen, jeder neue Kontakt oder Lead erhält seine leeren Felder direkt nach der Erstellung ausgefüllt.
- Tägliches Nachziehen: Eine automatische Routine überprüft aktuelle Datensätze von Mandanten mit aktivierter Option und vervollständigt alles Ausstehende innerhalb eines Tageslimits. Die erneute Verarbeitung desselben Datensatzes wird niemals doppelt berechnet.
So testen Sie es
- Öffnen Sie ein Unternehmen mit Website/Domain (oder einen Kontakt mit E-Mail), dessen Felder teilweise leer sind.
- Klicken Sie auf „Anreichern“.
- Prüfen Sie, ob die leeren Felder gemäß Ihrer Zuordnung ausgefüllt wurden. Vergleichen Sie mit der erwarteten Antwort des Anbieters, um die JSON-Pfade zu validieren.
Fehlerbehebung
- 401/403 vom Anbieter: falscher/abgelaufener API-Schlüssel oder falscher Authentifizierungsheader. Prüfen Sie Headername und Präfix (z. B. „Bearer “ mit Leerzeichen) und fügen Sie den Schlüssel erneut ein.
- Nichts wird ausgefüllt: Prüfen Sie, ob die Zuordnungspfade mit dem tatsächlichen JSON des Anbieters übereinstimmen (Punkte zum Absteigen in Ebenen und Indizes für Listen, z. B. contacts.0.email). Nur einfache Werte (Text/Zahl) passen in ein Feld; ganze Objekte/Listen werden ignoriert.
- Manche Felder werden nicht aktualisiert, obwohl der Anbieter Daten zurückgibt: Die Anreicherung schreibt nur in LEERE Felder. Hat ein Feld bereits einen Wert, bleibt dieser bewusst erhalten.
- Die Schaltfläche „Anreichern“ tut nichts: Bestätigen Sie, dass der Datensatz eine Website/Domain oder E-Mail hat (die Abfrage verwendet {domain}/{email}) und dass der Endpunkt diese Platzhalter verwendet.
- 404/ungültiger Endpunkt: Überprüfen Sie die Endpunkt-URL und ob der Anbieter eine Domain oder E-Mail in der Abfrage erwartet.