Blog

Zoho CRM auf Autopilot: Wie du Leads mit externen APIs automatisch anreicherst und qualifizierst

In einer datengetriebenen Welt ist die Qualität deiner Leads entscheidend für den Vertriebserfolg. Manuelle Recherche, um mehr über einen neuen Kontakt herauszufinden, kostet wertvolle Zeit und ist fehleranfällig. Doch was, wenn du diesen Prozess vollständig automatisieren könntest? In diesem Fachartikel zeigen wir dir, wie du dein Zoho CRM mit externen Datenanreicherungs-APIs verbindest, um aus einer einfachen E-Mail-Adresse einen hochqualifizierten, kontextreichen Lead zu machen. Wir tauchen tief in die Welt der Workflows, Custom Functions mit Deluge und der nahtlosen Integration von Tools wie Zoho Cliq ein. Das Ziel: Dein Vertriebsteam bekommt nur noch Leads, die sofort bearbeitet werden können – mit allen relevanten Informationen auf einen Blick.

Die Herausforderung: Von der E-Mail zum qualifizierten B2B-Lead

Stell dir ein typisches Szenario vor: Ein potenzieller Kunde füllt ein Kontaktformular auf deiner Website aus, das mit Zoho Forms erstellt wurde. Du erhältst einen Namen, eine E-Mail-Adresse und vielleicht eine kurze Nachricht. Doch für eine effektive B2B-Vertriebsansprache fehlen entscheidende Informationen:

• In welchem Unternehmen arbeitet die Person?
• Wie groß ist dieses Unternehmen?
• In welcher Branche ist es tätig?
• Welche Position hat der Ansprechpartner?

Dein Vertriebsteam muss diese Informationen nun manuell auf Plattformen wie LinkedIn oder Xing recherchieren. Dieser Prozess ist nicht nur zeitaufwendig, sondern auch inkonsistent. Die Lösung liegt darin, diesen gesamten Anreicherungsprozess zu automatisieren, sobald der Lead in deinem Zoho CRM System erfasst wird.

Schritt-für-Schritt: Automatisierte Lead-Anreicherung mit Deluge und externen APIs

Wir bauen einen automatisierten Workflow, der sich bei der Erstellung eines neuen Leads aktiviert, eine externe API zur Datenanreicherung aufruft und die gewonnenen Informationen direkt in den Lead-Datensatz schreibt. Zum Schluss benachrichtigen wir das zuständige Team in Echtzeit.

1. Vorbereitung: Felder in Zoho CRM und API-Zugang

Zuerst musst du sicherstellen, dass dein Zoho CRM die zusätzlichen Informationen speichern kann. Gehe zu Einstellungen > Module und Felder > Leads und füge benutzerdefinierte Felder hinzu, falls sie noch nicht existieren:

• Unternehmensgröße (Zahlenfeld oder Auswahlliste)
• Branche (Textfeld)
• Website (URL-Feld)
• Lead Score (Zahlenfeld)

Als Nächstes benötigst du einen API-Schlüssel von einem Datenanreicherungsdienst. Es gibt viele Anbieter auf dem Markt, wie zum Beispiel Clearbit, Hunter.io, ZoomInfo oder People Data Labs. Für dieses Beispiel verwenden wir die konzeptionelle Logik einer solchen API, die auf Basis einer E-Mail-Domain Unternehmensdaten liefert.

2. Workflow-Regel in Zoho CRM erstellen

Navigiere zu Einstellungen > Automatisierung > Workflow-Regeln und erstelle eine neue Regel für das Modul „Leads“.

• Regelname: „Lead-Anreicherung via API“
• Wann soll diese Regel ausgeführt werden? Wähle „Bei einer Datensatzaktion“ und „Erstellen“.
• Welche Leads sollen einbezogen werden? Setze die Bedingung auf „Alle Leads“.

Klicke auf „Weiter“. Nun definieren wir die Aktionen, die ausgeführt werden sollen.

3. Das Herzstück: Die Custom Function in Deluge

Wähle als „Sofortige Aktion“ die Option „Funktion“. Klicke auf „Neue Funktion“ und wähle „Eigene Funktion schreiben“.

• Funktionsname: enrichLeadData
• Anzeigename: Lead Daten anreichern
• Beschreibung: Ruft eine externe API auf, um Lead-Informationen basierend auf der E-Mail-Domain anzureichern.

Nun musst du ein Argument definieren, damit die Funktion weiß, auf welchen Lead sie sich beziehen soll. Klicke auf „Argumente bearbeiten“ und erstelle ein Argument:

• Name: leadId
• Typ: Int
• Wert: Wähle im Dropdown „#“ und dann „Lead“ > „Lead-ID“.

Füge nun den folgenden Deluge-Code in den Editor ein. Der Code ist kommentiert, um jeden Schritt zu erklären.

// Deluge-Skript zur Anreicherung von Lead-Daten
// Funktion: enrichLeadData
// Argument: leadId (die ID des neu erstellten Leads)

// 1. Den Lead-Datensatz abrufen, um die E-Mail-Adresse zu erhalten
leadDetails = zoho.crm.getRecordById("Leads", leadId);
email = ifnull(leadDetails.get("Email"),"");

// 2. Prüfen, ob eine E-Mail-Adresse vorhanden ist
if (email != "")
{
    // 3. Domain aus der E-Mail-Adresse extrahieren
    // Wir nehmen an, dass es sich um eine Firmen-E-Mail handelt
    domain = email.substring(email.indexOf("@") + 1);

    // 4. API-Endpunkt und Authentifizierung vorbereiten
    // ERSETZE 'DEIN_API_SCHLUESSEL' mit deinem echten API-Schlüssel
    // Hier als Beispiel die Clearbit Enrichment API
    apiKey = "DEIN_API_SCHLUESSEL";
    url = "https://company.clearbit.com/v2/companies/find?domain=" + domain;
    
    // Header für die Authentifizierung
    headers = Map();
    headers.put("Authorization", "Bearer " + apiKey);
    
    // 5. API-Aufruf (GET-Request) durchführen
    try
    {
        apiResponse = invokeurl
        [
            url: url
            type: GET
            headers: headers
        ];
        
        // 6. JSON-Antwort parsen und Daten in eine Map für das Update schreiben
        companyData = apiResponse.toJSON();
        updateMap = Map();
        
        // Daten aus der API-Antwort den CRM-Feldern zuordnen
        // Die Feldnamen (z.B. "name", "metrics.employees") hängen von der API ab!
        if (companyData.get("name") != null)
        {
            updateMap.put("Company", companyData.get("name"));
        }
        if (companyData.get("site") != null && companyData.get("site").get("websiteUrl") != null)
        {
            updateMap.put("Website", companyData.get("site").get("websiteUrl"));
        }
        if (companyData.get("category") != null && companyData.get("category").get("industry") != null)
        {
            // "Branche" ist der API-Name deines benutzerdefinierten Feldes
            updateMap.put("Branche", companyData.get("category").get("industry"));
        }
        if (companyData.get("metrics") != null && companyData.get("metrics").get("employees") != null)
        {
            // "Unternehmensgrosse" ist der API-Name deines benutzerdefinierten Feldes
            updateMap.put("Unternehmensgrosse", companyData.get("metrics").get("employees"));
        }
        
        // 7. Lead-Datensatz in Zoho CRM aktualisieren, wenn Daten gefunden wurden
        if (updateMap.size() > 0)
        {
            updateResponse = zoho.crm.updateRecord("Leads", leadId, updateMap);
            info "Lead " + leadId + " erfolgreich angereichert: " + updateResponse;
        }
    }
    catch (e)
    {
        // Fehlerbehandlung: Bei einem Fehlschlag eine Notiz zum Lead hinzufügen
        errorData = Map();
        errorData.put("Note_Title", "API Anreicherung fehlgeschlagen");
        errorData.put("Note_Content", "Die Datenanreicherung via API ist fehlgeschlagen. Fehler: " + e);
        errorData.put("Parent_Id", leadId);
        errorData.put("se_module", "Leads");
        addNote = zoho.crm.createRecord("Notes", errorData);
        info "Fehler bei der Anreicherung für Lead " + leadId + ": " + addNote;
    }
}

Speichere die Funktion und verknüpfe sie mit deiner Workflow-Regel.

4. Benachrichtigung in Zoho Cliq

Füge eine zweite „Sofortige Aktion“ zu deinem Workflow hinzu. Wähle „Benachrichtigung senden“ und dann „Via Cliq“.

• Wähle aus, ob die Benachrichtigung an einen Benutzer, eine Gruppe, einen Kanal oder einen Bot gesendet werden soll. Ideal ist ein Kanal wie „#neue-leads“.
• Gestalte die Nachricht, indem du Merge-Felder (#) verwendest, um die neu angereicherten Daten direkt anzuzeigen:

Nachrichtentitel: Neuer qualifizierter Lead!

Nachricht:
Ein neuer Lead wurde erstellt und automatisch angereichert:
Firma: ${Leads.Company}
Name: ${Leads.Last Name}
Branche: ${Leads.Branche}
Mitarbeiter: ${Leads.Unternehmensgrosse}
Zuständig: ${Leads.Lead Owner}
Direkt zum Lead im CRM

Speichere die Workflow-Regel. Ab sofort wird jeder neue Lead automatisch verarbeitet.

Tipps und Best Practices

• Sichere API-Schlüssel-Verwaltung: Hardcode deine API-Schlüssel niemals direkt im Skript. Nutze stattdessen die Verbindungen (Connections) in Zoho CRM oder speichere sie sicher in Zoho Vault. Dies erleichtert die Verwaltung und erhöht die Sicherheit.
• Umgang mit API-Limits: Jeder API-Dienst hat ein Nutzungslimit. Überwache deine Aufrufe. Bei sehr hohem Lead-Aufkommen kann es sinnvoll sein, den Prozess über Zoho Flow zu steuern, da es eine bessere Übersicht über die Ausführungen und ein ausgefeilteres Error-Handling bietet. Für extrem komplexe, serverlose Logik ist Zoho Catalyst die richtige Wahl.
• Fehlerbehandlung ausbauen: Unser Skript fügt bei einem Fehler eine Notiz hinzu. Du könntest stattdessen auch eine Aufgabe für einen Admin erstellen oder eine Benachrichtigung in einen speziellen Fehler-Kanal in Cliq senden, um sofort reagieren zu können.
• Asynchrone Verarbeitung: Wenn die externe API langsam antwortet, kann dies die Erstellung des Leads im User-Interface verzögern. In solchen Fällen kann es besser sein, den Workflow zeitversetzt (z.B. 5 Minuten nach Erstellung) auszuführen.

Zusätzliche Erweiterungsmöglichkeiten im Zoho-Ökosystem

Diese Automatisierung ist nur der Anfang. Die angereicherten Daten eröffnen dir viele weitere Möglichkeiten:

• Personalisiertes Marketing: Nutze die Branchen- oder Unternehmensgrößendaten, um Leads automatisch in die richtigen Segmente in Zoho Campaigns oder Zoho Marketing Automation einzusortieren und ihnen hochrelevante Inhalte zu senden.
• Datenvisualisierung: Erstelle in Zoho Analytics Dashboards, die dir zeigen, aus welchen Branchen und Unternehmensgrößen deine besten Leads kommen. So optimierst du deine Marketingstrategie.
• Automatisierte Support-Tickets: Wenn die Nachricht des Leads Schlüsselwörter wie „Problem“, „Hilfe“ oder „Fehler“ enthält, könntest du mit einer weiteren Workflow-Regel automatisch ein Ticket in Zoho Desk erstellen.

Fazit

Die Integration von externen APIs direkt in Zoho CRM über Custom Functions ist ein mächtiges Werkzeug, um manuelle Prozesse zu eliminieren und die Datenqualität massiv zu steigern. Du sparst nicht nur wertvolle Arbeitszeit, sondern ermöglichst deinem Vertriebsteam auch, schneller und fundierter auf neue Anfragen zu reagieren. Dieser Anwendungsfall zeigt eindrucksvoll, wie die Flexibilität der Zoho-Plattform es dir erlaubt, maßgeschneiderte Lösungen für deine spezifischen Geschäftsanforderungen zu bauen und das volle Potenzial deiner Daten auszuschöpfen.

Verwendete Zoho Apps in diesem Beispiel:

• Zoho CRM: Als zentrale Plattform für das Lead-Management und die Automatisierung.
• Zoho Forms: Zur Erfassung der Leads auf deiner Website.
• Zoho Cliq: Für die sofortige Benachrichtigung des Vertriebsteams.