Blog

Du betrachtest gerade Zoho CRM, OpenAI API und Deluge: Automatisierung von Besuchsberichten

Zoho CRM, OpenAI API und Deluge: Automatisierung von Besuchsberichten

  • Beitrags-Autor:

Vom Diktat zum Datensatz: So automatisierst Du Besuchsberichte in Zoho CRM mit KI

Im Außendienst und Vertrieb zählt jede Minute. Nach einem wichtigen Kundentermin müssen die gesammelten Informationen schnell und strukturiert ins CRM-System, damit das ganze Team auf dem gleichen Stand ist und die nächsten Schritte eingeleitet werden können. Doch die Realität sieht oft anders aus: Handschriftliche Notizen gehen unter oder das Abtippen kostet wertvolle Zeit. Die Diktierfunktion des Smartphones ist zwar schnell, liefert aber oft nur unformatierten Text voller Fehler. Genau hier liegt eine enorme Chance zur Effizienzsteigerung. Dieser Artikel zeigt Dir, wie Du einen Prozess aufbaust, der diktierte Gesprächsnotizen mithilfe einer externen KI wie OpenAI oder Anthropic automatisch bereinigt, strukturiert und direkt in Zoho CRM ablegt – als perfekt formatierten Besuchsbericht.

Die typische Herausforderung: Der „digitale Bruch“ im Vertriebsprozess

Stell Dir einen typischen Arbeitsablauf im technischen Vertrieb oder in der Industrieberatung vor: Du kommst aus einem intensiven Kundengespräch. Dein Notizbuch ist voll mit Details, technischen Spezifikationen und vereinbarten To-dos. Um nichts zu vergessen, diktierst Du die wichtigsten Punkte schnell in die Notizen-App deines Smartphones oder direkt in die mobile App von Zoho CRM. Das Ergebnis ist oft ein langer, unstrukturierter Textblock, den Du oder ein Kollege später mühsam manuell nachbearbeiten müsst. Informationen sind zwar erfasst, aber nicht direkt nutzbar. Die Erstellung von Aufgaben in Zoho Projects oder die Analyse von Gesprächsinhalten in Zoho Analytics wird dadurch unnötig erschwert.

Unser Ziel ist es, diesen manuellen Schritt vollständig zu eliminieren. Eine diktierte Notiz soll sich per Knopfdruck oder durch ein simples Schlüsselwort in einen sauberen, gegliederten Bericht verwandeln, der sofort Mehrwert stiftet.

Schritt-für-Schritt: Dein automatisierter Protokoll-Assistent in Zoho CRM

Wir bauen eine Lösung, die auf einer Workflow-Regel und einer Custom Function in Zoho CRM basiert. Diese Funktion nimmt den rohen Text, schickt ihn zur Aufbereitung an eine externe KI und speichert das Ergebnis wieder in der Notiz. Als Tech-Stack nutzen wir:

  • Zoho CRM: Als zentrale Plattform für unsere Kundendaten und als Auslöser für den Prozess (Workflow).
  • Deluge: Die Skriptsprache von Zoho, um eine Custom Function zu schreiben, die die Logik enthält.
  • Externe KI-API: Zum Beispiel die API von OpenAI (GPT-4/GPT-3.5) oder Anthropic (Claude). Diese Dienste sind darauf spezialisiert, unstrukturierten Text zu verstehen und zu formatieren.
  • Optional: Zoho Cliq: Um den Nutzer per Chat zu benachrichtigen, sobald die Verarbeitung abgeschlossen ist.

Schritt 1: Der Auslöser (Trigger) in Zoho CRM

Zuerst definieren wir, wie der Prozess gestartet wird. Ein einfacher und effektiver Weg ist die Verwendung eines Schlüsselwortes.

  1. Navigiere in Zoho CRM zu Einstellungen > Automatisierung > Workflow-Regeln.
  2. Erstelle eine neue Regel für das Modul Notizen.
  3. Nenne die Regel z.B. „KI-Protokoll-Formatierung“.
  4. Wähle als Auslöser: „Bei einer Datensatzerstellung oder -bearbeitung“.
  5. Setze die Bedingung für die Regel: „Notizinhalt“ enthält „Gesprächsprotokoll“. Dies ist unser magisches Schlüsselwort. Immer wenn Du eine Notiz diktierst, beginnst Du einfach mit „Gesprächsprotokoll“, gefolgt von Deinem Text.

Diese Konfiguration stellt sicher, dass der Workflow nur dann anspringt, wenn er explizit durch das Schlüsselwort aufgerufen wird, und nicht bei jeder normalen Notiz.

Schritt 2: Die Custom Function mit Deluge erstellen

Das Herzstück unserer Automatisierung ist eine Custom Function, die durch den Workflow aufgerufen wird. Diese Funktion kommuniziert mit der externen KI.

  1. Klicke im Workflow-Editor unter „Sofortige Aktionen“ auf „Funktion“ und „Neue Funktion schreiben“.
  2. Wähle „Deluge“ als Sprache.
  3. Gib der Funktion einen Namen, z.B. formatMeetingNotesAI.
  4. Definiere ein Argument, um die ID der Notiz zu übergeben. Nenne es z.B. noteId und wähle als Wert `#Notizen – Notiz-ID`.

Jetzt fügen wir den Deluge-Code ein. Dieser Code holt die Notiz, bereitet die Anfrage für die OpenAI-API vor, sendet sie, verarbeitet die Antwort und aktualisiert die Notiz.

// Funktion zur Formatierung von Gesprächsnotizen mit der OpenAI API
// Argument: noteId (String)

// 1. Notiz-Datensatz aus Zoho CRM abrufen
noteDetails = zoho.crm.getRecordById("Notes", noteId.toLong());
rawContent = ifnull(noteDetails.get("Note_Content"),"");

// Überprüfen, ob die Notiz bereits verarbeitet wurde, um Schleifen zu vermeiden
if(!rawContent.contains("[KI-formatiert]"))
{
    // 2. OpenAI API-Schlüssel und Endpunkt definieren
    // WICHTIG: Speichere Deinen API-Schlüssel sicher, z.B. in einer Custom Setting oder Zoho Vault Connection
    apiKey = "sk-DEIN_OPENAI_API_KEY";
    apiUrl = "https://api.openai.com/v1/chat/completions";

    // 3. Den Prompt für die KI erstellen (Prompt Engineering ist entscheidend!)
    // Wir entfernen unser Schlüsselwort aus dem zu verarbeitenden Text
    cleanContent = rawContent.remove("Gesprächsprotokoll");
    
    prompt_text = "Du bist ein professioneller Assistent für ein B2B-Unternehmen im Bereich Industrietechnik. Formatiere den folgenden, diktierten Text in einen sauberen und strukturierten Besuchsbericht. Korrigiere Rechtschreib- und Grammatikfehler. Gliedere den Bericht in die folgenden Abschnitte mit klaren Überschriften: 'Zusammenfassung', 'Besprochene Themen' und 'Nächste Schritte / Offene Punkte'. Der Ton soll sachlich und professionell sein. Hier ist der diktierte Text: nn" + cleanContent;

    // 4. API-Anfrage vorbereiten
    headers = Map();
    headers.put("Authorization", "Bearer " + apiKey);
    headers.put("Content-Type", "application/json");

    body = Map();
    messages = List();
    message = Map();
    message.put("role", "user");
    message.put("content", prompt_text);
    messages.add(message);
    body.put("model", "gpt-4-turbo-preview"); // Oder ein anderes Modell wie "gpt-3.5-turbo"
    body.put("messages", messages);
    body.put("temperature", 0.5); // Kreativität der KI (0.2 = sehr faktisch, 1.0 = sehr kreativ)

    // 5. API-Aufruf durchführen
    apiResponse = invokeurl
    [
        url :apiUrl
        type :POST
        headers:headers
        content:body.toString()
    ];
    
    // 6. Antwort verarbeiten und Notiz aktualisieren
    if(apiResponse.get("responseCode") == 200)
    {
        responseJson = apiResponse.get("response").toJSON();
        formattedContent = responseJson.get("choices").get(0).get("message").get("content");
        
        // Füge einen Hinweis hinzu, dass die Notiz bearbeitet wurde
        finalContent = "[KI-formatiert am " + zoho.currentdate + "]nn" + formattedContent;
        
        updateMap = Map();
        updateMap.put("Note_Content", finalContent);
        updateResponse = zoho.crm.updateRecord("Notes", noteId.toLong(), updateMap);
        info updateResponse;

        // Optional: Benachrichtigung an den Ersteller der Notiz via Zoho Cliq senden
        ownerId = noteDetails.get("Owner").get("id");
        ownerDetails = zoho.crm.getUser(ownerId);
        ownerEmail = ownerDetails.get("email");
        cliqMessage = "Dein Gesprächsprotokoll (Notiz-ID: " + noteId + ") wurde erfolgreich von der KI formatiert.";
        zoho.cliq.postToUser(ownerEmail, cliqMessage);
    }
    else
    {
        // Fehlerbehandlung: Füge eine Fehlermeldung zur Notiz hinzu
        errorContent = rawContent + "nn[FEHLER: KI-Formatierung fehlgeschlagen. Status: " + apiResponse.get("responseCode") + "]";
        updateMap = Map();
        updateMap.put("Note_Content", errorContent);
        zoho.crm.updateRecord("Notes", noteId.toLong(), updateMap);
    }
}

Speichere und verknüpfe diese Funktion mit Deiner Workflow-Regel. Ab sofort wird jede Notiz, die mit „Gesprächsprotokoll“ beginnt, automatisch verarbeitet.

Tipps und Best Practices für eine robuste Lösung

  • Sichere API-Schlüsselverwaltung: Hardcodiere Deinen API-Schlüssel niemals direkt im Code. Nutze stattdessen Verbindungen (Connections) in Zoho oder speichere den Schlüssel in einer geschützten Custom Setting. Für unternehmensweite Geheimnisse ist Zoho Vault die beste Wahl.
  • Prompt Engineering ist der Schlüssel: Die Qualität des Ergebnisses hängt massiv von der Qualität Deines Prompts ab. Experimentiere mit dem Anweisungstext (prompt_text). Je genauer Du der KI sagst, was Du erwartest (Format, Tonalität, Abschnitte), desto besser wird das Resultat.
  • Fehlerbehandlung: Was passiert, wenn die OpenAI-API nicht erreichbar ist? Unser Skript fängt dies ab und fügt eine Fehlermeldung in die Notiz ein. So geht keine Information verloren.
  • Kosten im Blick behalten: Die Nutzung von externen KI-APIs ist kostenpflichtig. Überwache Deinen Verbrauch beim jeweiligen Anbieter. Für die meisten KMUs sind die Kosten für eine solche Automatisierung jedoch überschaubar und amortisieren sich schnell durch die gewonnene Zeit.
  • Alternative zu Deluge: Zoho Flow: Wenn Du nicht direkt in Deluge programmieren möchtest, lässt sich ein ähnlicher Prozess auch mit Zoho Flow umsetzen. Dort kannst Du den Zoho CRM-Trigger visuell mit einem OpenAI-Connector verknüpfen.

Weitere Ausbaustufen: Das Ökosystem nutzen

Die strukturierte Notiz ist erst der Anfang. Von hier aus kannst Du weitere Automatisierungen anstoßen:

  • Automatische Aufgabenerstellung: Erweitere die Deluge-Funktion, um den Abschnitt „Nächste Schritte“ zu parsen. Für jeden Punkt könnte automatisch eine Aufgabe in Zoho Projects oder Qntrl erstellt und dem richtigen Mitarbeiter zugewiesen werden.
  • Daten für Zoho Analytics: Die strukturierten Daten sind eine Goldgrube für Analysen. Extrahiere wiederkehrende Themen oder Kundenwünsche aus den Protokollen und visualisiere sie in einem Dashboard in Zoho Analytics. So erkennst Du Trends, die in unstrukturiertem Text verborgen bleiben.
  • Integration mit Zoho Inventory und WooCommerce: Wenn in einem Gesprächsprotokoll spezifische Artikelnummern erwähnt werden, könnte ein Skript automatisch die Verfügbarkeit in Zoho Inventory prüfen oder einen Entwurf für ein Angebot erstellen, das auch mit einem angebundenen E-Commerce-System wie WooCommerce synchronisiert ist.

Fazit: Mehr als nur eine technische Spielerei

Die Automatisierung von Besuchsberichten ist ein perfektes Beispiel dafür, wie die Kombination von Zoho-eigenen Werkzeugen (CRM, Deluge) mit externen APIs einen direkten und messbaren Nutzen schafft. Du sparst nicht nur wertvolle Arbeitszeit, sondern erhöhst auch die Qualität und Konsistenz Deiner CRM-Daten drastisch. Statt unleserlicher Textwüsten erhältst Du strukturierte Informationen, die als Grundlage für weitere Prozesse, Analysen und Geschäftsentscheidungen dienen. Es zeigt eindrucksvoll, dass das Zoho-Ökosystem keine geschlossene Insel ist, sondern eine offene Plattform, die sich nahtlos in moderne Tech-Stacks integrieren lässt, um reale Geschäftsprobleme elegant zu lösen.

Verwendete Zoho Apps in diesem Konzept: