Blog

Zoho Flow, Zoho CRM und externe KI-APIs für Transkription und Bonitätsprüfung – Praxis-Tutorial

  • Beitrags-Autor:

Zoho-Automatisierung für Profis: Transkriptionen, Widgets und API-Integrationen im Praxistest

Die wahre Stärke des Zoho-Ökosystems entfaltet sich erst, wenn du die Grenzen einzelner Apps sprengst und sie intelligent miteinander und mit externen Diensten verbindest. Viele Unternehmen nutzen Zoho CRM als zentrale Kundendatenbank, doch das volle Potenzial bleibt oft ungenutzt. Standardprozesse sind gut, aber maßgeschneiderte Automatisierungen, die auf deine spezifischen Bedürfnisse zugeschnitten sind, schaffen den entscheidenden Wettbewerbsvorteil. In diesem Fachartikel zeigen wir dir, wie du durch die Kombination von Zoho Apps wie Zoho Flow und Zoho Creator mit externen KI-Diensten und Daten-APIs komplexe, wertschöpfende Prozesse aufbaust, die weit über das Standard-CRM hinausgehen.

Die Herausforderung: Manuelle Prozesse und isolierte Daten

Stell dir ein typisches Szenario in einem modernen Vertriebsteam vor: Online-Meetings und Verkaufsgespräche, die über Zoho Meeting oder andere Plattformen geführt werden, sind an der Tagesordnung. Diese Gespräche enthalten wertvolle Informationen – Kundenwünsche, Pain Points, vereinbarte nächste Schritte. Meistens werden die Aufzeichnungen in einem Laufwerk wie Zoho WorkDrive gespeichert und geraten dort in Vergessenheit. Die manuelle Verschriftlichung ist zu zeitaufwändig und fehleranfällig.

Eine weitere Herausforderung entsteht bei der Auftragsabwicklung. Bevor ein großer Auftrag finalisiert wird, ist oft eine Bonitätsprüfung des Kunden notwendig. Dieser Prozess läuft häufig manuell ab: Ein Mitarbeiter loggt sich in ein externes Portal (z.B. von Creditreform oder Dun & Bradstreet) ein, sucht den Kunden, lädt einen Bericht herunter und trägt die relevanten Informationen von Hand ins CRM ein. Das ist langsam, ineffizient und birgt das Risiko von Übertragungsfehlern.

In diesem Artikel lösen wir genau diese beiden Probleme durch eine durchdachte Automatisierungskette.

Schritt-für-Schritt: Vom Meeting-Recording zur angereicherten Sales Order

Wir bauen einen End-to-End-Prozess auf, der eine Audio- oder Videodatei automatisch transkribiert und das Ergebnis im CRM ablegt. Anschließend zeigen wir, wie du direkt aus einem Auftragsdatensatz eine Bonitätsprüfung via API anstößt und die Ergebnisse visualisierst.

Teil 1: Automatische Transkription mit Zoho Flow und einer externen KI-API

Unser Ziel ist es, jede neue Aufzeichnungsdatei, die in einem bestimmten Zoho WorkDrive-Ordner abgelegt wird, automatisch an einen Transkriptionsdienst zu senden und das Ergebnis als Notiz im zugehörigen Kontaktdatensatz in Zoho CRM zu speichern.

  1. Der Trigger: Neue Datei in Zoho WorkDrive
    Der Prozess startet in Zoho Flow. Als Trigger wählen wir „New File in Folder“ für die App Zoho WorkDrive. Du spezifizierst hier den genauen Ordner, in dem deine Vertriebsaufzeichnungen landen.
  2. Die Verbindung zur Außenwelt: Der Webhook
    Jetzt kommt der entscheidende Schritt: Wir senden die Datei an einen externen Transkriptionsdienst. Es gibt zahlreiche Anbieter mit hervorragenden APIs, z.B. AssemblyAI, Deepgram oder die OpenAI Whisper API. In Zoho Flow nutzt du dafür die „Webhook“-Aktion.
    Du sendest einen POST-Request an den API-Endpunkt des Transkriptionsdienstes. Im Body des Requests übergibst du die öffentliche URL der Datei aus dem WorkDrive-Trigger. Die Authentifizierung erfolgt meist über einen API-Key im Header.

    // Beispielhafte Konfiguration des Webhooks in Zoho Flow (logische Darstellung)
URL: https://api.assemblyai.com/v2/transcript
Method: POST
Headers: {
    "authorization": "YOUR_ASSEMBLYAI_API_KEY",
    "content-type": "application/json"
}
Body (raw): {
    "audio_url": "${workdrive.public_download_url}" 
}
  3. Warten auf das Ergebnis
    Transkriptionen sind keine Echtzeitprozesse. Große Dateien können einige Minuten dauern. Die meisten APIs arbeiten asynchron: Du sendest den Job und erhältst eine Job-ID zurück. Dann musst du den Status abfragen. In Zoho Flow kannst du dafür eine „Delay“-Aktion (z.B. 5 Minuten warten) und eine Schleife einbauen, oder, falls von der API unterstützt, einen Webhook-Callback nutzen. Wir wählen hier die einfache Abfrage-Methode.
  4. Transkript abholen und in Zoho CRM speichern
    Nach der Wartezeit senden wir einen GET-Request an den Transkriptions-Endpunkt, um das Ergebnis mit der Job-ID aus dem vorherigen Schritt abzuholen. Die Antwort ist meist ein JSON-Objekt, das den transkribierten Text enthält.
    Anschließend verwendest du die „Create Record“ oder „Update Record“-Aktion für Zoho CRM. Du suchst den passenden Kontakt oder Deal (z.B. basierend auf einer ID im Dateinamen) und fügst den transkribierten Text in ein benutzerdefiniertes mehrzeiliges Feld oder als Notiz an.

Teil 2: Visualisierung der Daten mit einem Zoho Creator Widget

Lange Transkriptionstexte in einem Standard-CRM-Feld sind unübersichtlich. Hier kommt ein Widget ins Spiel – eine kleine, in Zoho Creator gebaute Anwendung, die direkt in der Detailansicht eines CRM-Datensatzes angezeigt wird.

  1. Erstelle eine Creator-Anwendung: In Zoho Creator erstellst du eine neue Anwendung. Darin legst du eine „Page“ (Seite) an. Diese Seite wird unser Widget.
  2. Parameter übergeben: Das Widget muss wissen, welchen CRM-Datensatz es anzeigen soll. In den Einstellungen des Widgets in Zoho CRM konfigurierst du, dass die ID des Kontakts oder Deals als Parameter an die Creator Page übergeben wird.
  3. Daten abrufen und anzeigen mit Deluge: Auf der Creator Page fügst du einen HTML-Snippet hinzu und nutzt Deluge, die Skriptsprache von Zoho, um die Daten dynamisch zu laden. 
    <!-- Deluge-Skript im OnLoad-Bereich der Creator Page -->
<%
// CRM Datensatz-ID vom Widget-Parameter holen
crmRecordId = input.crmRecordId;

// Den zugehörigen Datensatz aus Zoho CRM abrufen
crmRecord = zoho.crm.getRecordById("Deals", crmRecordId.toLong());

// Den Transkriptionstext aus dem benutzerdefinierten Feld auslesen
transcriptionText = crmRecord.get("Transkription");

// Den Text für die Anzeige in HTML aufbereiten (optional)
formattedText = transcriptionText.replaceAll("n", "<br>");
%>

<!-- HTML-Teil der Creator Page -->
<h3>Gesprächstranskript</h3>
<div style="background-color:#f5f5f5; border:1px solid #ccc; padding:15px; height:300px; overflow-y:auto;">
    <p><%=formattedText%></p>
</div>
  4. Widget im CRM einbinden: In den Anpassungseinstellungen von Zoho CRM kannst du nun das erstellte Creator Widget zu den Seitenlayouts deiner Module (z.B. Deals oder Kontakte) hinzufügen.

Teil 3: Anreicherung von Auftragsdaten via API-Aufruf per Custom Function

Nun automatisieren wir die Bonitätsprüfung direkt aus dem „Sales Orders“-Modul. Anstatt Zoho Flow nutzen wir hier eine Custom Function (Deluge-Skript), die durch eine Workflow-Regel in Zoho CRM ausgelöst wird.

  1. Workflow-Regel erstellen: Gehe in die Automatisierungseinstellungen von Zoho CRM und erstelle eine neue Regel für das Modul „Sales Orders“. Als Auslöser wählst du „Bei einer Datensatzaktion“ und „Bearbeiten“. Die Regel soll nur dann greifen, wenn ein bestimmtes Feld (z.B. ein Statusfeld namens „Bonitätsprüfung“) auf „Starten“ gesetzt wird.
  2. Custom Function schreiben: Als Aktion für die Regel wählst du „Funktion“ und erstellst ein neues Deluge-Skript. Dieses Skript führt den API-Call aus. 
    // Deluge Custom Function zur Abfrage einer Bonitäts-API
void checkCreditScore(int salesOrderId)
{
    // 1. Hole den relevanten Sales Order Datensatz
    soDetails = zoho.crm.getRecordById("Sales_Orders", salesOrderId);
    accountId = soDetails.get("Account_Name").get("id");
    
    // 2. Hole den zugehörigen Account, um die Firmen-ID zu bekommen
    accountDetails = zoho.crm.getRecordById("Accounts", accountId);
    companyRegNumber = accountDetails.get("Handelsregisternummer"); // Benutzerdefiniertes Feld
    
    // Prüfe, ob eine Nummer vorhanden ist
    if(companyRegNumber != null)
    {
        // 3. Bereite den API-Aufruf vor
        apiUrl = "https://api.bonitaets-anbieter.de/v1/check"; // Fiktive URL
        // API-Keys sollten sicher in Connections oder Organisationvariablen gespeichert werden
        apiKey = zoho.crm.getOrgVariable("bonitaets.api.key"); 
        
        headers = Map();
        headers.put("Authorization", "Bearer " + apiKey);
        
        params = Map();
        params.put("registration_number", companyRegNumber);
        
        // 4. Führe den API-Aufruf aus
        response = invokeurl
        [
            url :apiUrl
            type :GET
            parameters:params
            headers:headers
        ];
        
        // 5. Verarbeite die Antwort und update den Sales Order
        creditScore = response.get("score");
        riskLevel = response.get("risk_level");
        
        updateMap = Map();
        updateMap.put("Credit_Score", creditScore); // Benutzerdefiniertes Feld
        updateMap.put("Risk_Level", riskLevel); // Benutzerdefiniertes Feld
        updateMap.put("Bonitätsprüfung", "Abgeschlossen"); // Status aktualisieren
        
        updateResponse = zoho.crm.updateRecord("Sales_Orders", salesOrderId, updateMap);
        info updateResponse;
    }
}
  3. Argumente zuordnen: Beim Speichern der Funktion musst du das Argument `salesOrderId` mit dem Feld „Sales Order Id“ aus dem CRM-Datensatz verknüpfen. Jetzt wird bei jeder Statusänderung automatisch die Bonität geprüft und direkt im Auftrag gespeichert.

Tipps und Best Practices

  • Sicherheit geht vor: Speichere API-Schlüssel und andere sensible Daten niemals direkt im Code. Nutze die „Connections“ in Zoho Flow und Zoho Creator oder Organisationsvariablen in Zoho CRM. Für höchste Sicherheit empfiehlt sich die zentrale Verwaltung in Zoho Vault.
  • Robustes Fehlerhandling: Was passiert, wenn eine externe API nicht erreichbar ist oder einen Fehler zurückgibt? Baue in deinen Deluge-Skripten immer `try…catch`-Blöcke ein, um Fehler abzufangen und z.B. eine Benachrichtigung an einen Admin über Zoho Cliq zu senden.
  • Skalierbarkeit bedenken: Achte auf die API-Limits von Zoho und den externen Diensten. Protokolliere wichtige Aktionen und deren Ergebnisse in einem benutzerdefinierten Modul oder in Zoho Analytics, um die Performance zu überwachen und Engpässe zu identifizieren.
  • Asynchrone Logik verstehen: Prozesse wie Transkriptionen sind nicht sofort abgeschlossen. Nutze die asynchronen Möglichkeiten der Plattformen. Viele APIs bieten Webhooks an, um dich zu benachrichtigen, wenn ein Job fertig ist. Das ist effizienter als ständiges Nachfragen (Polling).

Fazit: Dein Business, deine Prozesse

Dieses Praxisbeispiel zeigt eindrucksvoll, dass Zoho mehr als nur eine Ansammlung einzelner Tools ist. Es ist eine flexible Entwicklungsplattform, die es dir ermöglicht, maßgeschneiderte und hochautomatisierte Geschäftsprozesse zu erstellen. Durch die intelligente Verknüpfung von Zoho CRM, Zoho Flow, Zoho Creator und der nahtlosen Integration externer APIs kannst du manuelle Arbeit eliminieren, die Datenqualität erhöhen und letztendlich schnellere und bessere Geschäftsentscheidungen treffen. Der Aufwand, solche Prozesse einmalig zu konzipieren und umzusetzen, zahlt sich durch die tägliche Zeitersparnis und die neu gewonnenen Einblicke schnell aus.

In diesem Beispiel verwendete Zoho Apps: