Blog

Zoho jenseits der Grenzen: Wie Du externe KI-Dienste und Web-Scraping für maximale Automatisierung nutzt

In der Welt der Unternehmenssoftware ist die nahtlose Integration verschiedener Systeme der Schlüssel zu echter Effizienz. Du nutzt Zoho One vielleicht schon für CRM, Finanzen und Projektmanagement, aber was passiert, wenn Deine Prozesse auf externe Systeme stoßen, die keine moderne API anbieten? Viele Unternehmen stehen vor genau dieser Herausforderung: Manuelle Datenübertragung aus PDFs oder das mühsame Ausfüllen von Webformularen in starren Partnerportalen sind zeitraubend und fehleranfällig. Dieser Artikel zeigt Dir einen praxisnahen Weg, wie Du diese Hürden überwindest. Wir tauchen tief in die Materie ein und kombinieren die Stärke von Zoho mit externen KI-Diensten wie Microsoft Co-Pilot und cleveren Automatisierungstricks wie Web-Scraping über einen dedizierten Server, um auch die hartnäckigsten manuellen Prozesse zu digitalisieren.

Das Praxisbeispiel: Vertragsmanagement im Filialgeschäft

Stell Dir ein Unternehmen im Telekommunikations-Retail vor. In den Filialen wird eine maßgeschneiderte Kiosk-Anwendung, entwickelt mit Zoho Creator, genutzt, um neue Kundenverträge oder Vertragsverlängerungen abzuwickeln. Am Ende dieses Prozesses wird ein PDF-Vertragsdokument von einem großen Netzbetreiber generiert und im System hinterlegt. Hier beginnen die Herausforderungen:

• Manuelle Dateneingabe: Wichtige Kundendaten aus diesem PDF (z.B. Vertragsnummer, Tarifdetails) müssen manuell in die Kundendatensätze im Zoho CRM übertragen werden. Das kostet Zeit und birgt das Risiko von Tippfehlern.
• Externe Portale ohne API: Kündigungen oder Tarifwechsel müssen manuell in ein B2B-Partnerportal des Netzbetreibers eingetragen werden. Dieses Portal bietet keine Schnittstelle (API) für eine automatisierte Datenübertragung.

Das Ziel ist klar: Diese beiden manuellen Prozessschritte sollen vollständig automatisiert werden, um die Mitarbeiter in den Filialen zu entlasten und die Datenqualität zu sichern. Die Lösung liegt in einer intelligenten Kombination von Zoho-eigenen Werkzeugen und externen Technologien.

Schritt-für-Schritt: PDF-Daten mit KI auslesen und in Zoho CRM speichern

Die erste Hürde ist das Auslesen der unstrukturierten Daten aus den PDF-Verträgen. Anstatt auf komplexe und oft unzuverlässige OCR-Lösungen zu setzen, nutzen wir die Kraft eines modernen KI-Sprachmodells. Viele Unternehmen haben bereits Lizenzen für Dienste wie Microsoft Co-Pilot for Business, die nicht nur einen Chatbot bieten, sondern auch eine API für Entwickler bereitstellen und dabei DSGVO-konform arbeiten.

1. Der Trigger: Das PDF kommt ins System

Der Prozess startet, sobald das Vertrags-PDF in den Anhang eines Datensatzes in Deiner mit Zoho Creator erstellten App oder direkt im Zoho CRM hochgeladen wird. Wir erstellen eine Workflow-Regel, die bei „Erstellen“ oder „Bearbeiten“ eines Datensatzes ausgelöst wird, sobald ein Anhang vorhanden ist.

2. Die Logik: Eine Custom Function mit Deluge

Diese Workflow-Regel ruft eine benutzerdefinierte Funktion auf, die in Deluge, der Skriptsprache von Zoho, geschrieben ist. Diese Funktion ist das Herzstück unserer Automatisierung.

3. Der API-Aufruf an den KI-Dienst

Die Deluge-Funktion führt folgende Schritte aus:

• Sie holt sich den Datensatz und die angehängte PDF-Datei.
• Sie bereitet den API-Aufruf an den externen KI-Dienst vor. Die PDF-Datei wird dabei oft als Base64-kodierter String im Body der Anfrage gesendet.
• Sie sendet die Anfrage mit invokeurl an den Endpunkt der KI-API und gibt dabei präzise Anweisungen (Prompt), welche Daten extrahiert werden sollen (z.B. „Extrahiere aus dem folgenden Dokument die Vertragsnummer, den Kundennamen und das Startdatum des Vertrags und gib das Ergebnis als sauberes JSON zurück.“).
• Sie empfängt die Antwort der KI, die idealerweise ein strukturiertes JSON-Objekt enthält.
• Sie parst dieses JSON und aktualisiert die entsprechenden Felder im Zoho CRM-Datensatz.

Codebeispiel: Deluge-Funktion zum Auslesen eines PDFs via KI-API

Hier ist ein vereinfachtes Beispiel, wie eine solche Deluge-Funktion aussehen könnte. Beachte, dass der genaue API-Endpunkt und die Authentifizierungsmethode von Deinem KI-Anbieter abhängen.

// Deluge Custom Function in Zoho CRM oder Creator
// 'recordId' wird von der Workflow-Regel übergeben
void extractDataFromPdfWithAI(int recordId)
{
    // 1. Datensatz und Anhang abrufen
    // 'Contracts' ist der API-Name des Moduls
    recordDetails = zoho.crm.getRecordById("Contracts", recordId);
    attachments = zoho.crm.getRelatedRecords("Attachments", "Contracts", recordId);

    if (attachments.size() > 0)
    {
        // Wir nehmen den ersten Anhang an
        attachmentId = attachments.get(0).get("id");
        pdfFile = zoho.crm.downloadFile(attachmentId);

        // 2. API-Request vorbereiten
        apiUrl = "https://api.dein-ki-anbieter.com/v1/document/extract";
        // Ersetze 'DEIN_API_KEY' durch deinen tatsächlichen API-Schlüssel
        headers = {"Authorization": "Bearer DEIN_API_KEY", "Content-Type": "application/json"};
        
        // Der Prompt ist entscheidend für die Qualität des Ergebnisses
        prompt = "Extrahiere die folgenden Felder: 'customerName', 'contractNumber', 'startDate', 'monthlyFee'. Gib das Ergebnis als JSON-Objekt zurück.";

        // Body für die API-Anfrage erstellen
        requestBody = Map();
        requestBody.put("prompt", prompt);
        // Die Datei wird als Base64-String gesendet
        requestBody.put("fileContent", pdfFile.toString("base64"));

        // 3. API aufrufen mit invokeurl
        apiResponse = invokeurl
        [
            url :apiUrl
            type :POST
            headers:headers
            parameters:requestBody.toString()
        ];
        
        info "API Response: " + apiResponse;

        // 4. Antwort verarbeiten und CRM-Datensatz aktualisieren
        if (apiResponse.get("responseCode") == 200)
        {
            extractedData = apiResponse.get("response").toJSON();
            updateMap = Map();
            updateMap.put("Customer_Name", extractedData.get("customerName"));
            updateMap.put("Contract_Number_Field", extractedData.get("contractNumber"));
            
            // Datum muss eventuell noch formatiert werden
            if(extractedData.get("startDate") != null)
            {
                 updateMap.put("Contract_Start_Date", extractedData.get("startDate").toDate());
            }
            
            // CRM-Datensatz aktualisieren
            updateResponse = zoho.crm.updateRecord("Contracts", recordId, updateMap);
            info "Update Response: " + updateResponse;
        }
        else
        {
            // Fehlerbehandlung: Sende eine Benachrichtigung oder erstelle einen Task
            zoho.cliq.postToChannel("fehler-im-system", "Fehler bei der PDF-Extraktion für Vertrag ID " + recordId + ". Status: " + apiResponse.get("responseCode"));
        }
    }
}

Lösung Teil 2: Prozesse ohne API via Web-Scraping automatisieren

Was aber, wenn das Zielsystem – wie das Partnerportal des Netzbetreibers – keine API hat? Hier müssen wir kreativer werden. Die Lösung ist ein sogenannter „Bot“ oder „Web-Scraper“, der eine menschliche Interaktion mit der Webseite simuliert.

Die Architektur: Zoho + VPS + Bot

Ein solcher Bot sollte nicht direkt aus der Zoho-Cloud ausgeführt werden. Eine robustere und sicherere Methode ist der Betrieb auf einem kleinen, dedizierten Server, einem sogenannten Virtual Private Server (VPS). Anbieter wie Hetzner oder IONOS bieten hierfür kostengünstige Lösungen.

1. Trigger in Zoho: Ein Mitarbeiter klickt im Zoho CRM auf einen benutzerdefinierten Button, z.B. „Kündigung im Portal eintragen“.
2. API-Aufruf an den VPS: Dieser Button löst eine Deluge-Funktion aus, die die benötigten Daten (Kundennummer, Vertrags-ID etc.) sammelt und per API-Aufruf an eine kleine Web-Applikation auf Deinem VPS sendet.
3. Der Bot wird aktiv: Die Anwendung auf dem VPS startet ein Skript (oft in Python mit Bibliotheken wie Selenium oder Playwright geschrieben). Dieses Skript öffnet einen Browser, loggt sich mit hinterlegten Zugangsdaten in das Partnerportal ein, navigiert zum Kündigungsformular, füllt die von Zoho übermittelten Daten ein und klickt auf „Senden“.
4. Rückmeldung an Zoho: Nach erfolgreicher Übermittlung (oder im Fehlerfall) kann der Bot eine Rückmeldung an Zoho senden, um den Status im CRM-Datensatz zu aktualisieren (z.B. von „Kündigung offen“ auf „Kündigung übermittelt“).

Dieser Ansatz ist technisch anspruchsvoller, aber extrem mächtig. Er ermöglicht die Automatisierung von Systemen, die sonst komplett abgeschottet wären.

Tipps und Best Practices

• Achte auf variable Layouts: Ein großes Risiko, sowohl bei der KI-gestützten PDF-Extraktion als auch beim Web-Scraping, sind unangekündigte Änderungen am Layout. Wenn der Netzbetreiber das Design seiner PDFs oder seines Webportals ändert, können Deine Automatisierungen fehlschlagen. Plane regelmäßige Prüfungen und ein robustes Fehlermanagement ein.
• Fehlerbehandlung ist Pflicht: Was passiert, wenn die KI die Daten nicht erkennt oder der Bot sich nicht einloggen kann? Implementiere immer eine Fallback-Lösung. Sende eine Benachrichtigung über Zoho Cliq an ein zuständiges Team oder erstelle automatisch eine Aufgabe in Zoho Projects, damit jemand den Fall manuell prüfen kann.
• Sicherheit geht vor: Wenn Du einen VPS nutzt, stelle sicher, dass er ordnungsgemäß abgesichert ist. Speichere Zugangsdaten für externe Portale niemals im Klartext, sondern nutze sichere Speicherorte wie Zoho Vault und rufe sie bei Bedarf über die API ab.
• Projektmanagement für komplexe Integrationen: Nutze ein Tool wie Zoho Projects, Zoho Sprints oder auch ein externes Tool wie Trello, um die Entwicklung und Wartung solcher komplexen Integrationen zu organisieren. Transparenz über den Fortschritt und eine klare Aufgabenzuweisung sind entscheidend für den Erfolg.

Zusätzliche Potenziale im Zoho-Ökosystem

Sobald die Daten einmal sauber und automatisch in Deinem Zoho-System sind, eröffnen sich unzählige weitere Möglichkeiten:

• Finanzdaten: Übertrage Vertragsdaten automatisch an Zoho Books oder Zoho Billing, um Rechnungen oder wiederkehrende Zahlungen zu erstellen.
• Marketing: Nutze die extrahierten Vertragsdaten (z.B. das Enddatum), um automatisierte Follow-up-Kampagnen mit Zoho Campaigns oder Zoho Marketing Automation für Vertragsverlängerungen zu starten.
• Analyse: Werte mit Zoho Analytics aus, wie lange die automatisierte Verarbeitung dauert, wie hoch die Fehlerquote ist und welche Vertragstypen am häufigsten vorkommen.
• Digitale Signatur: Auch wenn die automatische Platzierung von Signaturfeldern bei variablen Layouts schwierig ist, kannst Du mit Zoho Sign den Prozess nach der Dateneingabe standardisieren, indem Du Vorlagen für die gängigsten Dokumententypen erstellst.

Fazit: Denke über den Tellerrand hinaus

Die wahre Stärke des Zoho-Ökosystems liegt nicht nur in der Vielfalt seiner Apps, sondern auch in seiner Offenheit und Flexibilität. Mit Deluge-Skripting als mächtigem Werkzeug kannst Du Brücken zu fast jedem externen System bauen. Die Integration von KI-Diensten zur Datenextraktion und der Einsatz von Web-Scraping-Bots für nicht-API-fähige Systeme sind fortgeschrittene, aber äußerst wirkungsvolle Techniken, um manuelle Arbeit zu eliminieren, die Datenqualität zu steigern und Dein Unternehmen effizienter zu machen. Es lohnt sich, diese Wege zu erkunden, um das volle Potenzial Deiner Zoho-Implementierung auszuschöpfen.

In diesem Artikel erwähnte Zoho Apps:

• Zoho One
• Zoho Creator
• Zoho CRM
• Zoho Cliq
• Zoho Projects
• Zoho Vault
• Zoho Books
• Zoho Billing
• Zoho Campaigns
• Zoho Analytics
• Zoho Sign