Zoho CRM, Deluge Custom Functions und API-Integration im Lead-Management Tutorial

Intelligente Lead-Verteilung im B2B-Vertrieb: So kombinierst Du Zoho CRM, Custom Functions und externe APIs

Wenn Dein Unternehmen wächst, wächst auch die Anzahl der Leads in Deinem CRM. Was zunächst ein Luxusproblem ist, wird schnell zur echten Herausforderung: Wie verteilst Du diese Leads effizient, fair und vor allem intelligent an Dein Vertriebsteam? Eine manuelle Zuweisung per Hand ist fehleranfällig, langsam und demotiviert auf Dauer. Besonders im B2B-Umfeld, wo Du vielleicht mehrere Produkte, Dienstleistungen oder, wie in unserem Praxisbeispiel, verschiedene Events betreust, brauchst Du einen automatisierten und dennoch steuerbaren Prozess. In diesem Artikel zeigen wir Dir, wie Du mit einer cleveren Kombination aus Zoho CRM, der Skriptsprache Deluge und externen APIs ein System aufbaust, das nicht nur Leads verteilt, sondern sie auch anreichert und Deinem Team zielgerichtet zur Verfügung stellt.

Praxisbeispiel: Die Herausforderung im B2B-Event-Management

Stell Dir ein Unternehmen vor, das mehrmals im Jahr hochspezialisierte B2B-Konferenzen und Summits veranstaltet – etwa einen Kongress für Medizintechnik, ein Gipfeltreffen für die Finanzbranche oder eine Messe für nachhaltige Logistik. Über Jahre hat sich eine Datenbank mit über 40.000 Kontakten im Zoho CRM angesammelt. Die Herausforderungen sind typisch:

Ineffiziente Zuweisung: Neue Leads werden unregelmäßig oder nach Bauchgefühl verteilt.
Veraltete Daten: Vertriebsmitarbeiter haben Listen mit hunderten Kontakten von längst vergangenen Veranstaltungen, die ihre "Power Dialer"-Ansichten verstopfen.
Schlechte Datenqualität: Ein Großteil der Leads hat keine direkte Telefondurchwahl, was die Kaltakquise massiv erschwert.
Fehlende Priorisierung: Welcher Lead ist für welche der kommenden Veranstaltungen am relevantesten? Eine KI-gestützte Logik fehlt.

Das Ziel ist klar: Ein System zu schaffen, das die richtigen Leads, angereichert mit validen Kontaktdaten, dem passenden Vertriebsmitarbeiter für eine spezifische Veranstaltungskampagne zuweist.

Schritt-für-Schritt Anleitung zur Lösung

Wir bauen ein semi-automatisiertes System, das von einem Prozessverantwortlichen (z.B. einem Sales-Manager) gesteuert wird. Dieser "Manual-First"-Ansatz ist bewusst gewählt, um den Prozess zu Beginn kontrollieren, lernen und optimieren zu können, bevor eine Vollautomatisierung erfolgt.

1. Die Architektur: Das Fundament in Zoho CRM

Das Herzstück unserer Lösung ist ein benutzerdefiniertes Modul in Zoho Creator oder direkt in Zoho CRM (Enterprise Edition oder höher), das wir "Vertriebskampagnen" nennen. Dieses Modul repräsentiert eine konkrete Veranstaltung.

Erstelle ein neues Modul "Vertriebskampagnen" mit folgenden Feldern:

Kampagnenname: z.B. "Medizintechnik-Kongress 2026" (Textfeld)
Status: Aktiv / Inaktiv / Abgeschlossen (Auswahlliste)
Recycling-Zyklus (Tage): z.B. 180 (Zahlenfeld). Definiert, nach wie vielen Tagen ein nicht erreichter Lead wieder für neue Kampagnen verfügbar ist.
Potenzielle Leads: Anzahl der passenden Leads im System (Formelfeld, wird später per Skript befüllt).
Zugewiesene Leads: Anzahl der bereits zugewiesenen Leads (Rollup-Feld).

Anschließend erstellen wir ein weiteres benutzerdefiniertes Modul namens "Kampagnenzuordnung". Es verbindet die Kampagne mit den Vertriebsmitarbeitern.

Modul "Kampagnenzuordnung" mit den Feldern:

Kampagne: Lookup-Feld zum Modul "Vertriebskampagnen"
Mitarbeiter: Lookup-Feld zum "Benutzer"-Modul
Aktiv für Zuweisung: Checkbox (Ja/Nein)

Diese Struktur erlaubt es uns, pro Kampagne einen oder (in einer späteren Ausbaustufe) mehrere Mitarbeiter für die automatische Lead-Zuweisung zu aktivieren.

2. Die Logik: Intelligente Zuweisung mit Deluge

Im Modul "Vertriebskampagnen" erstellen wir nun einen benutzerdefinierten Button mit dem Namen "Leads zuweisen". Dieser Button löst eine Deluge Custom Function aus, die die eigentliche Arbeit erledigt.

Die Funktion führt folgende Schritte aus:

Sie holt sich die ID der aktuellen Kampagne.
Sie sucht im Modul "Kampagnenzuordnung" nach dem Mitarbeiter, der für diese Kampagne auf "Aktiv für Zuweisung" gesetzt ist.
Sie durchsucht das Leads-Modul nach passenden Kontakten. Kriterien sind hierbei z.B. die Branche, frühere Interaktionen oder ein KI-Score. Ein entscheidendes Kriterium ist: Telefon != null.
Sie weist eine definierte Anzahl (z.B. 10) dieser Leads dem aktiven Mitarbeiter zu, indem sie das Feld "Lead-Inhaber" aktualisiert.

Hier ein vereinfachtes Deluge-Skript als Beispiel für die Custom Function:

code

// Funktion, die an den Button "Leads zuweisen" gebunden ist
// Argumente: campaignId (Long), leadsToAssign (Int)

void assignLeadsToRep(int campaignId, int leadsToAssign)
{
    // 1. Finde den aktiven Mitarbeiter für diese Kampagne
    activeAssignment = zoho.crm.searchRecords("Kampagnenzuordnung", "(Kampagne:equals:" + campaignId + "and Aktiv_für_Zuweisung:equals:true)");
    if(activeAssignment.size() > 0)
    {
        repId = activeAssignment.get(0).get("Mitarbeiter").get("id");
        repName = activeAssignment.get(0).get("Mitarbeiter").get("name");

        // 2. Suche passende, unzugewiesene Leads
        // Kriterien: Kein Inhaber (oder Inhaber = Admin), Telefonnummer vorhanden, passender KI-Score (hier vereinfacht)
        criteria = "((Lead_Owner:equals:null) and (Phone:starts_with_none:not available,n/a) and (Email_Opt_Out:equals:false))";
        
        // Wichtig: 'searchRecords' ist auf 200 limitiert. Für große Datenmengen COQL oder Paging verwenden.
        potentialLeads = zoho.crm.searchRecords("Leads", criteria, 1, leadsToAssign, "Created_Time:asc");

        if(potentialLeads.size() > 0)
        {
            // 3. Iteriere durch die gefundenen Leads und weise sie zu
            leadIdsList = List();
            for each lead in potentialLeads
            {
                leadIdsList.add(lead.get("id"));
            }
            
            // Bulk-Update für bessere Performance
            updateMap = Map();
            updateMap.put("Owner", repId);
            
            updateResponse = zoho.crm.bulkUpdate("Leads", leadIdsList, updateMap);
            info "Zuweisung erfolgreich: " + potentialLeads.size() + " Leads an " + repName + " zugewiesen. Antwort: " + updateResponse;
        }
        else
        {
            info "Keine passenden Leads zur Zuweisung gefunden.";
        }
    }
    else
    {
        info "Kein aktiver Mitarbeiter für diese Kampagne gefunden.";
    }
}

3. Datenanreicherung: Die Verbindung zur Außenwelt via API

Die beste Zuweisungslogik scheitert, wenn die Daten unvollständig sind. Das Hauptproblem ist oft eine fehlende Telefonnummer. Hier kommen externe Datenanreicherungs-Dienste wie Lusha oder Better Contact ins Spiel. Wir können deren APIs direkt aus Zoho CRM über eine Deluge-Funktion ansteuern.

Ein Workflow könnte so aussehen: Immer wenn ein neuer Lead ohne Telefonnummer erstellt wird, wird eine Custom Function ausgelöst, die eine API-Anfrage an den externen Dienst sendet.

Beispielhafter API-Aufruf mit invokeurl in Deluge für einen fiktiven Anreicherungsdienst:

code

// Funktion zur Anreicherung eines Leads
// Argument: leadId (Long)

void enrichLeadData(int leadId)
{
    // Lead-Daten abrufen (Name, Firma, E-Mail)
    leadDetails = zoho.crm.getRecordById("Leads", leadId);
    companyName = leadDetails.get("Company");
    firstName = leadDetails.get("First_Name");
    lastName = leadDetails.get("Last_Name");

    // API-Anfrage vorbereiten
    apiUrl = "https://api.enrichmentservice.com/v1/person";
    apiKey = "DEIN_API_SCHLUESSEL"; // Sicher in Zoho Vault speichern!
    
    params = Map();
    params.put("company_name", companyName);
    params.put("first_name", firstName);
    params.put("last_name", lastName);

    headers = Map();
    headers.put("Authorization", "Bearer " + apiKey);

    // API aufrufen
    response = invokeurl
    [
        url :apiUrl
        type :GET
        parameters:params
        headers:headers
    ];

    // Antwort verarbeiten und Lead aktualisieren
    if(response.get("responseCode") == 200)
    {
        responseData = response.get("data");
        phoneNumber = responseData.get("phone_number");
        linkedinUrl = responseData.get("linkedin_url");
        
        updateMap = Map();
        if(phoneNumber != null)
        {
            updateMap.put("Phone", phoneNumber);
        }
        if(linkedinUrl != null)
        {
            updateMap.put("LinkedIn_Profil", linkedinUrl); // Benutzerdefiniertes Feld
        }
        
        if(updateMap.size() > 0)
        {
            updateResp = zoho.crm.updateRecord("Leads", leadId, updateMap);
            info "Lead " + leadId + " erfolgreich angereichert: " + updateResp;
        }
    }
}

Neben Telefonnummern ist die Anreicherung mit LinkedIn-Profilen extrem wertvoll. Dies kann ebenfalls über spezialisierte APIs oder über eine automatisierte Google-Suche via API erfolgen, um einen weiteren Kontaktkanal zu erschließen.

4. Reporting und Analyse mit Zoho Analytics

Um den Erfolg zu messen und den Gesamtüberblick zu behalten, ist ein Dashboard unerlässlich. Hierfür synchronisierst Du Deine Zoho CRM Daten mit Zoho Analytics. Erstelle dort einen Bericht, der pro "Vertriebskampagne" folgende Kennzahlen anzeigt:

Gesamtes Lead-Potenzial (Anzahl aller thematisch passenden Leads)
Anzahl Leads mit Telefonnummer
Anzahl bereits zugewiesener Leads
Erfolgsquote (z.B. Anzahl der durch die Kampagne generierten Deals)

Dieses Dashboard gibt dem Management eine klare, datengestützte Entscheidungsgrundlage für zukünftige Kampagnenplanungen.

Tipps und Best Practices

Datenqualität ist alles: Fördere eine Kultur im Team, in der Notizen konsequent und faktenbasiert im CRM erfasst werden. Jede Information – "hat aktuell kein Budget", "entscheidet erst im nächsten Quartal" – ist Gold wert für die zukünftige KI-gestützte Bewertung und das Lead-Recycling. Subjektive Kommentare wie "wertloser Lead" sollten vermieden werden.
Skalierbarkeit planen: Beginne mit dem semi-manuellen Prozess. Wenn dieser reibungslos läuft, kannst Du über eine Vollautomatisierung nachdenken. Die Logik muss dann erweitert werden, um Leads fair zwischen mehreren gleichzeitig aktiven Mitarbeitern zu verteilen (z.B. per Round-Robin-Verfahren).
Flexibler Recycling-Prozess: Nicht jeder Lead-Zyklus ist gleich. Für eine halbjährliche Veranstaltung ist ein Recycling nach 180 Tagen sinnvoll, für eine jährliche nach 365. Das Feld "Recycling-Zyklus" in unserem Custom Module macht dies flexibel steuerbar.
"Cherry-Picking" vermeiden: Das Risiko, dass Mitarbeiter nur die "einfachen" Leads bearbeiten und schwierige zurückgeben, ist real. Mit einem zentralen Prozessmanager, der für die Bereinigung der Listen und die Zuweisung verantwortlich ist, wird dieses Risiko minimiert.
Sichere API-Keys: Speichere sensible Daten wie API-Schlüssel niemals direkt im Code. Nutze stattdessen Zoho Vault oder die Organisationsebene für Verbindungen in Zoho CRM, um sie sicher zu verwalten.

Zusätzliche Integrationsmöglichkeiten

Das Zoho-Ökosystem bietet noch mehr Potenzial zur Optimierung dieses Prozesses:

Zoho Flow: Für komplexere Workflows, die mehrere Apps und externe Dienste verbinden, kann Zoho Flow als "Klebstoff" dienen und Dir helfen, Logik ohne tiefgehende Deluge-Kenntnisse zu erstellen.
Zoho SalesIQ: Wenn ein zugewiesener Lead Deine Webseite besucht, kann der Chat automatisch an den zuständigen Inhaber im CRM geroutet werden.
Zoho Campaigns oder Zoho Marketing Automation: Nutze die Kampagnenzuordnung im CRM, um hochgradig personalisierte E-Mail-Sequenzen zu starten, nachdem ein Vertriebsmitarbeiter den Lead kontaktiert hat.
WordPress-Formulare: Ein häufiger Quell von Leads sind Formulare auf der Webseite. Stelle sicher, dass die Integration zu Zoho CRM reibungslos funktioniert. Manchmal sind Plugins wie "Code Snippets Pro" nötig, um die Datenübertragung zu gewährleisten, besonders bei mehrsprachigen Seiten.

Fazit

Die intelligente Verteilung und Anreicherung von Leads ist kein Hexenwerk, sondern das Ergebnis eines durchdachten Prozesses und der cleveren Nutzung der richtigen Werkzeuge. Indem Du Zoho CRM als zentrale Datenplattform nutzt und es über Deluge-Skripte und APIs mit der Außenwelt verbindest, verwandelst Du eine statische Datenbank in ein dynamisches, selbstoptimierendes Vertriebssystem. Du steigerst nicht nur die Effizienz und die Datenqualität, sondern motivierst auch Dein Sales-Team, da es sich auf die vielversprechendsten und am besten vorbereiteten Kontakte konzentrieren kann. Dies ist ein perfektes Beispiel dafür, wie die wahre Stärke von Zoho in der Kombination seiner Apps und seiner offenen Architektur liegt.

Verwendete Zoho Apps in diesem Szenario:

Zoho CRM
Zoho Creator (optional, für erweiterte Modul-Logik)
Zoho Analytics
Zoho Flow (optional, für komplexere Integrationen)
Zoho Vault (optional, für sicheres API-Key-Management)