# Konver.ai Integration: Strategie & Architektur

**Status:** Vertrag unterzeichnet (Fokus: Telefon-Enrichment).
**Risiko:** Wegfall von Dealfront (Lead Gen) ohne adäquaten, automatisierten Ersatz.
**Ziel:** Nutzung von Konver.ai nicht nur als manuelles "Telefonbuch", sondern als **skalierbare Quelle** für die Lead-Fabrik (Company Explorer).

## 1. Das Zielszenario (The "Golden Flow")

Wir integrieren Konver.ai via API direkt in den Company Explorer. Der CE fungiert als Gatekeeper, um Credits zu sparen und Dubletten zu verhindern.

```mermaid
flowchart TD
    subgraph "RoboPlanet Ecosystem"
        Notion[("Notion Strategy\n(Verticals/Pains)")]
        SO[("SuperOffice CRM\n(Bestand)")]
        CE["Company Explorer\n(The Brain)"]
    end

    subgraph "External Sources"
        Konver["Konver.ai API"]
        Web["Web / Google / Wiki"]
    end

    %% Data Flow
    Notion -->|1. Sync Strategy| CE
    SO -->|2. Import Existing (Blocklist)| CE
    
    CE -->|3. Search Query + Exclusion List| Konver
    Note right of Konver: "Suche: Altenheime > 10 Mio\nExclude: Domain-Liste aus SO"
    
    Konver -->|4. Net New Candidates| CE
    
    CE -->|5. Deep Dive (Robotik-Check)| Web
    
    CE -->|6. Enrich Contact (Phone/Mail)| Konver
    Note right of CE: "Nur für Firmen mit\nhohem Robotik-Score!"
    
    CE -->|7. Export Qualified Lead| SO
```

## 2. Die kritische Lücke: "Exclusion List"

Da Dealfront (unser bisheriges "Fischnetz") abgeschaltet wird, müssen wir Konver zur **Neukunden-Generierung** nutzen.
Ohne eine **Ausschluss-Liste (Exclusion List)** bei der Suche verbrennen wir Geld und Zeit:

1.  **Kosten:** Wir zahlen Credits für Firmen/Kontakte, die wir schon haben.
2.  **Daten-Hygiene:** Wir importieren Dubletten, die wir mühsam bereinigen müssen.
3.  **Blindflug:** Wir wissen vor dem Kauf nicht, ob der Datensatz "netto neu" ist.

### Forderung an Konver (Technisches Onboarding)

*"Um Konver.ai als strategischen Nachfolger für Dealfront in unserer Marketing-Automation nutzen zu können, benötigen wir zwingend API-Funktionen zur **Deduplizierung VOR dem Datenkauf**."*

**Konkrete Features:**
*   **Domain-Exclusion:** Upload einer Liste (z.B. 5.000 Domains), die in der API-Suche *nicht* zurückgegeben werden.
*   **Contact-Check:** Prüfung (z.B. Hash-Abgleich), ob eine E-Mail-Adresse bereits "bekannt" ist, bevor Kontaktdaten enthüllt (und berechnet) werden.

## 3. Workflow-Varianten

### A. Der "Smart Enricher" (Wirtschaftlich)
Wir nutzen Konver nur für Firmen, die **wirklich** relevant sind.

1.  **Scraping:** Company Explorer findet 100 Altenheime (Web-Suche).
2.  **Filterung:** KI prüft Websites -> 40 davon sind relevant (haben große Flächen).
3.  **Enrichment:** Nur für diese 40 fragen wir Konver via API: *"Gib mir den Facility Manager + Handy"*.
4.  **Ergebnis:** Wir zahlen 40 Credits statt 100. Hohe Effizienz.

### B. Der "Mass Loader" (Teuer & Dumm - zu vermeiden)
1.  Wir laden "Alle Altenheime" aus Konver direkt nach SuperOffice.
2.  Wir zahlen 100 Credits.
3.  Der Vertrieb ruft an -> 60 davon sind ungeeignet (zu klein, kein Bedarf).
4.  **Ergebnis:** 60 Credits verbrannt, Vertrieb frustriert.

## 4. Fazit & Next Steps

Wir müssen im Onboarding-Gespräch klären:
1.  **API-Doku:** Wo ist die Dokumentation für `Search` und `Enrich` Endpoints?
2.  **Exclusion:** Wie filtern wir Bestandskunden im API-Call?
3.  **Bulk-Enrichment:** Können wir Listen (Domains) zum Anreichern hochladen?

Ohne diese Features ist Konver ein Rückschritt in die manuelle Einzelbearbeitung.

## 5. Kommunikations-Vorlagen

### A. Interne Klärung (an Projektverantwortlichen)
*Ziel: Strategische Ausrichtung (Enrichment vs. Neukunden) und technische Implikationen klären, ohne "Schlafende Hunde" zu wecken.*

**Betreff:** Technische Konzeption der Konver.ai-Integration – Rückfragen zum Einsatzszenario

Sehr geehrte(r) [Name des Ansprechpartners],

ich befasse mich derzeit mit der technischen Konzeption für die Einbindung von Konver.ai in unsere bestehende Systemlandschaft. Da ich leider erst sehr spät in den Prozess hinzugekommen bin und die bisherigen Präsentationen von Konver.ai nicht verfolgen konnte, haben sich für mich zwei zentrale Fragen zur optimalen technischen Integration ergeben:

**1. Fokus der Nutzung (Enrichment vs. Neukunden-Recherche)**
Ist geplant, Konver.ai primär für die Anreicherung bereits bestehender Datensätze im CRM zu nutzen (z. B. Ergänzung fehlender Mobilnummern)? Oder soll das Tool, ähnlich wie zuvor Dealfront, auch für die aktive Suche nach neuen, bisher unbekannten Ansprechpartnern eingesetzt werden (z. B. „Suche Facility Manager bei Unternehmen X“)?

Diese Unterscheidung ist für die Implementierung einer automatisierten Dublettenprüfung und den effizienten Einsatz von Credits von großer Bedeutung.

**2. Art der Datenbereitstellung (Echtzeit-Datenbank vs. Live-Recherche)**
Können Sie mir sagen, ob Konver.ai die angefragten Daten sofort aus einer bestehenden Datenbank liefert oder ob die Recherche jeweils erst zum Zeitpunkt der Anfrage „live“ gestartet wird? Davon hängt ab, ob wir die Integration synchron (Daten sind sofort verfügbar) oder asynchron (mit einer zeitlichen Verzögerung und Warteschlange) abbilden müssen.

Für eine kurze Einschätzung Ihrerseits wäre ich Ihnen sehr dankbar, um die technische Umsetzung von Beginn an passgenau planen zu können.
Gerne stelle ich die Fragen auch direkt an Konver.ai, ich möchte hier nur nicht querschießen.

Mit freundlichen Grüßen

[Ihr Name]

---

### B. Externe Anfrage (an Konver.ai Support / Tech)
*Ziel: Technische Dokumentation erhalten und Deduplizierungs-Möglichkeiten prüfen.*

**Betreff:** Technische Integration API - Dokumentation & Workflow (Wackler/Roboplanet)

Sehr geehrte Damen und Herren / Hallo Support-Team,

wir sind derzeit dabei, Konver.ai technisch in unsere Systemlandschaft (SuperOffice CRM & interne Lead-Intelligence) zu integrieren.
Um den Aufwand und die Architektur (synchron vs. asynchron) planen zu können, benötigen wir bitte folgende Informationen bzw. Unterlagen:

**1. API Dokumentation**
Könnten Sie uns bitte die aktuelle technische Dokumentation (OpenAPI/Swagger Specs) für die `Search` und `Enrich` Endpoints zukommen lassen?

**2. Person Search & Deduplizierung (Pre-Purchase Check)**
Unser geplanter Use-Case sieht vor, gezielt nach Ansprechpartnern für vorqualifizierte Unternehmen zu suchen (z.B. `domain="klinikum-x.de"` AND `job_title="Facility Manager"`).
*   Gibt es einen Endpunkt, der uns erlaubt, **vor** dem kostenpflichtigen "Reveal" zu prüfen, ob wir einen Datensatz (E-Mail/Telefon) bereits besitzen (z.B. via Hash-Abgleich oder Exclusion-List)?
*   Wir möchten vermeiden, Credits für Daten zu verbrauchen, die bereits in unserem CRM vorhanden sind.

**3. Datenbereitstellung (Sync vs. Async)**
Erfolgt die Rückgabe der Daten bei einer API-Anfrage synchron (direkt aus einer Datenbank) oder wird ein Live-Recherche-Prozess angestoßen?
Falls "Live": Bieten Sie Webhooks an, um uns über die Fertigstellung der Datenanreicherung zu informieren, oder muss gepollt werden?

Vielen Dank für Ihre Unterstützung beim technischen Onboarding.

Mit freundlichen Grüßen

[Ihr Name]

