Prospector
Überblick
Der Prospector durchsucht die B2B-Firmendatenbank Ihres Anbieters und übernimmt Treffer als Lead, Kunde oder Kontakt. Erster Anbieter ist Dealfront (Firmendatenbank aus Echobot). Octibiz liest dort nur — es wird nichts an Dealfront oder an Dritte gesendet außer Ihren Suchkriterien.
Sie finden ihn unter CRM → Leads → Prospector.
Kernaufgaben
Zugang einrichten. Ohne Zugang zeigt die Seite Nicht verbunden. Eingerichtet wird er einmal unter Einstellungen → Integrationen: neue Integration mit Anbieter dealfront, im Feld api_key Ihr persönlicher API-Schlüssel aus Dealfront (Settings → Personal → API Keys), auf Wunsch account_id für ein bestimmtes Dealfront-Konto (sonst gilt das erste). Der Schlüssel wird verschlüsselt abgelegt und nie wieder angezeigt; Jetzt prüfen liest Ihr Dealfront-Profil und zeigt, ob der Schlüssel gilt. Pro Marke ist ein eigener Zugang möglich, sonst gilt der markenübergreifende.
Suchen. Name oder Domain, Land (zweistelliger Ländercode, z. B. DE), Ort, PLZ und Mitarbeiterzahl lassen sich kombinieren; mindestens ein Kriterium ist nötig. Suchen verbrauchen bei Dealfront keine Credits. Weitere laden holt die nächste Seite.
Dubletten erkennen. Jeder Treffer wird gegen Ihren Kundenstamm geprüft: gleiche USt-IdNr. oder gleiche Firmen-Domain ist ein harter Treffer (gelb), ein ähnlicher Name ein Hinweis (blau).
Übernehmen. Übernehmen öffnet die Übernahme:
- Lead — ein neuer Interessent mit Firma, Website, Branche und dem ersten gewählten Ansprechpartner.
Gibt es einen Bestandskunden mit gleicher USt-IdNr. oder Domain, wird der Lead mit ihm verknüpft. Dieselbe Firma wird nie zweimal Lead — der zweite Versuch öffnet den bestehenden.
- Neuer Kunde — mit Anschrift, Website, Telefon und USt-IdNr. (nur in gültiger Form); die gewählten
Ansprechpartner werden Kontakte. Bei einem harten Treffer verlangt Octibiz ausdrücklich Trotz bestehendem Kunden neu anlegen.
- Kontakte zu … — bei einem harten Treffer kommen die gewählten Ansprechpartner an den
Bestandskunden.
Die Ansprechpartner zeigt der Dialog mit Name und Ebene; E-Mail und Telefon holt Octibiz erst beim Übernehmen — das kann bei Dealfront Credits kosten. Gehört eine E-Mail schon einem Kontakt eines anderen Kunden, wird sie nicht doppelt angelegt und nicht umgehängt; die Übernahme meldet sie.
Felder im Detail
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Firmenname oder Domain query | eines der Kriterien | Text | Sucht in Name, Alternativnamen und Domains. |
Land countryCode | nein | ISO-Code, zwei Buchstaben | Sitz der Firma. |
Ort / PLZ city / postalCode | nein | Text | Sitz der Firma. |
Mitarbeiter employeeRanges | nein | 1-10 bis 10.000+ | Größe der Firma, mehrere Spannen möglich. |
Firma companyId | ja (Übernahme) | Kennung beim Anbieter | Welche Firma übernommen wird; die Oberfläche setzt sie aus dem Treffer. |
Bestehender Kunde customerUlid | bei Kontakte zu … | Kunde in Octibiz | Kunde, an den die Ansprechpartner kommen; die Antwort nennt hier den Kunden, an dem übernommen wurde. |
Herkunft source | nein | prospector, web_visitor | Woher die Firma stammt — steht am Lead. |
Marke brandId | nein | eine Ihrer Marken | Deren Anbieter-Zugang gilt und in ihr entstehen Lead bzw. Kunde; ohne Angabe die markenübergreifende bzw. erste Marke, in der Sie das Recht haben. |
Branchen industryCodes | nein | Branchen-Codes des Anbieters, höchstens 20 | Grenzt die Suche auf Branchen ein. |
Seitengröße pageSize | nein | 1 bis 100, Vorgabe 25 | Treffer je Abruf. |
Fortsetzung cursor | nein | Wert aus nextCursor | Holt die nächste Seite derselben Suche (Weitere laden). |
Übernehmen als target | ja | lead, customer, contact | Was in Octibiz entsteht. |
Ansprechpartner contactIds | nein | höchstens 20 | Personen, deren Kontaktdaten beim Übernehmen geholt werden. |
Trotz bestehendem Kunden neu anlegen createDespiteDuplicate | nein | Ja/Nein | Nur bei Neuer Kunde und hartem Dubletten-Treffer. |
Einstellungen & Rechte
- Modul
module.crm. crm.prospector.view— suchen und Ansprechpartner sehen;crm.prospector.import— übernehmen.
Zusätzlich braucht die Übernahme das Recht des Ziels in der Marke: crm.lead.manage für Leads, platform.customer.create und platform.contact.create für Kunden und Kontakte. Die Rolle Vertrieb hat alle drei Prospector-Rechte ab Werk.
- Datenschutz: Die Daten aus der Firmendatenbank verarbeiten Sie auf Grundlage des berechtigten
Interesses (Art. 6 Abs. 1 lit. f DSGVO). Was an Dealfront fließt, steht unter Auftragsverarbeitung.
FAQ & Fehlerbilder
„Nicht verbunden". Es gibt keinen Dealfront-Zugang für diese Marke — Integration anlegen, siehe oben.
„Der Prospector-Anbieter hat nicht geantwortet oder abgelehnt: rejected:HTTP 401 …". Der API-Schlüssel ist ungültig oder abgelaufen. In Dealfront einen neuen erzeugen und in der Integration ersetzen; Jetzt prüfen bestätigt ihn.
„Es gibt bereits den Kunden …". Harter Dubletten-Treffer. Kontakte dort übernehmen oder ausdrücklich neu anlegen.