Blog

Zoho CRM, Deluge und externe APIs: Automatisierte Kundenkommunikation bei Servicefällen effizient umsetzen

  • Beitrags-Autor:

Vom Silo zur Kommandozentrale: Wie Du mit Zoho CRM und APIs proaktive Kundenkommunikation automatisierst

In einer vernetzten Welt erwarten Kunden schnelle und präzise Informationen – besonders, wenn es um Serviceeinschränkungen oder Wartungsarbeiten geht. Manuelle Prozesse, bei denen Du mühsam E-Mail-Listen aus verschiedenen Systemen zusammenstellst, sind nicht nur zeitaufwendig, sondern auch extrem fehleranfällig. Schnell wird ein wichtiger Ansprechpartner vergessen oder ein bereits gekündigter Kunde fälschlicherweise informiert. Das schadet nicht nur Deiner Effizienz, sondern auch Deinem professionellen Ansehen. Dieser Artikel zeigt Dir, wie Du mit einem maßgeschneiderten Modul in Zoho CRM, etwas Deluge-Logik und der cleveren Anbindung externer APIs eine robuste und automatisierte Kommunikationszentrale für Servicefälle aufbaust. Wir lösen die Herausforderung, zielgerichtet nur die relevanten Kontakte zu informieren und den gesamten Vorgang sauber zu dokumentieren.

Das Praxisbeispiel: Gezielte Kundenkommunikation bei Wartungsarbeiten

Stell Dir vor, Du arbeitest für ein Unternehmen, das Dienstleistungen in verschiedenen geografischen Zonen anbietet – zum Beispiel ein lokaler Internetanbieter, ein Energieversorger oder ein Facility-Management-Dienstleister. Für nächste Woche ist eine wichtige Wartung am Netzwerkknoten in der „Zone Nord“ geplant, die zu einem kurzen Serviceausfall führen wird. Deine Aufgabe ist es, alle betroffenen Kunden rechtzeitig zu informieren.

Die Herausforderung: Wie findest Du zuverlässig alle Ansprechpartner, die der „Zone Nord“ zugeordnet sind? Du musst sicherstellen, dass nur aktive Kunden benachrichtigt werden und gekündigte Kunden außen vor bleiben. Gleichzeitig soll der gesamte Kommunikationsvorgang nachvollziehbar sein. Du möchtest später im CRM-Datensatz eines Kontakts sehen können, dass er über diesen spezifischen Vorfall informiert wurde. Ein manueller Export und Abgleich in Zoho Sheet ist hier keine skalierbare Lösung.

Die Lösung im Detail: Ein „Service Update“-Modul in Zoho CRM

Wir bauen eine zentrale Schaltstelle direkt in Deinem Zoho CRM. Das Ziel ist ein Prozess, bei dem Du ein neues „Service Update“ anlegst, die betroffene Zone auswählst und per Knopfdruck eine Liste aller relevanten Kontakte generieren lässt. Diese Kontakte werden direkt mit dem Update verknüpft, was eine lückenlose Dokumentation sicherstellt.

Schritt 1: Die Datenbasis schaffen – Custom Fields in Zoho CRM

Die Grundlage jeder Automatisierung sind saubere Daten. Stelle sicher, dass Du die folgenden Felder in Deinem CRM angelegt hast:

  • Im Modul Accounts (Kunden): Ein Picklist-Feld namens „Kundenstatus“ mit Werten wie „Aktiv“, „Gekündigt“, „Interessent“. Dieses Feld ist entscheidend, um nur aktive Kundenbeziehungen zu berücksichtigen.
  • Im Modul Kontakte: Ein Picklist-Feld namens „Wartungs- und Störungszone“. Hier hinterlegst Du die Zonen, denen ein Kontakt zugeordnet ist (z.B. „Zone Nord“, „Zone Süd“, „Rechenzentrum A“).

Diese Felder sind die Filterkriterien für unsere spätere Automatisierung.

Schritt 2: Das Herzstück – Das Custom Module „Service Updates“

Navigiere in Zoho CRM zu Einstellungen > Anpassung > Module und Felder und erstelle ein neues Modul. Nennen wir es „Service Updates“. Dieses Modul dient als zentrale Anlaufstelle für alle Vorfälle und geplanten Wartungen. Statte es mit den folgenden Feldern aus:

  • Update-Titel (Text, Pflichtfeld): Eine kurze, prägnante Beschreibung (z.B. „Netzwerkwartung KW48“).
  • Betroffene Zone (Picklist): Die Werte dieser Liste sollten identisch mit denen im Kontakt-Feld „Wartungs- und Störungszone“ sein.
  • Startzeitpunkt (Datum/Uhrzeit): Wann beginnt der Vorfall?
  • Endzeitpunkt (Datum/Uhrzeit): Wann endet der Vorfall voraussichtlich?
  • Beschreibung (Mehrzeiliger Text): Detaillierte Informationen für die Kundenkommunikation.
  • Status (Picklist): z.B. „Geplant“, „In Bearbeitung“, „Abgeschlossen“.

Schritt 3: Die Verbindung herstellen – Related List und Junction Module

Damit wir nachvollziehen können, welche Kontakte über ein bestimmtes Update informiert wurden, benötigen wir eine Verknüpfung zwischen unserem neuen „Service Updates“-Modul und dem „Kontakte“-Modul. Da ein Update viele Kontakte betreffen kann und ein Kontakt im Laufe der Zeit über viele Updates informiert werden kann, brauchen wir eine Many-to-Many-Beziehung.

Gehe dazu in die Moduleinstellungen des „Service Updates“-Moduls und füge über den Layout-Editor eine neue „Mehrfach-Auswahlliste“ (Multi-Select Lookup) hinzu, die auf das Modul „Kontakte“ verweist. Zoho CRM erstellt daraufhin automatisch im Hintergrund ein sogenanntes Junction Module (Verknüpfungsmodul), das die Verknüpfungen sauber speichert. Du erkennst es daran, dass in Deinem Update-Datensatz eine neue „Related List“ für Kontakte erscheint.

Schritt 4: Die Automatisierung – Der Custom Button und Deluge

Jetzt kommt die Magie ins Spiel. Wir erstellen einen Button im „Service Updates“-Modul, der die Logik zur Kontaktsuche und -verknüpfung ausführt. Gehe zu Einstellungen > Anpassung > Module und Felder > Service Updates > Schaltflächen und erstelle einen neuen Button, z.B. mit dem Namen „Betroffene Kontakte finden“.

Wähle „Funktion schreiben“ und füge das folgende Deluge-Skript ein. Dieses Skript holt sich die Zone aus dem aktuellen Datensatz, sucht nach allen passenden, aktiven Kontakten und verknüpft sie.


// Deluge Custom Function, um Kontakte zu finden und zu verknüpfen
// Argument: 'serviceUpdateId' vom Typ Long

// 1. Details des aktuellen "Service Update"-Datensatzes abrufen
serviceUpdateDetails = zoho.crm.getRecordById("Service_Updates", serviceUpdateId);
if(serviceUpdateDetails.size() > 0)
{
    // 2. Die ausgewählte Zone aus dem Datensatz extrahieren
    targetZone = serviceUpdateDetails.get("Betroffene_Zone");
    
    // Prüfen, ob eine Zone ausgewählt wurde
    if(targetZone != null)
    {
        // 3. COQL-Abfrage, um die relevanten Kontakte zu finden
        // Kriterien: Zone stimmt überein UND der zugehörige Kunde ist "Aktiv"
        // Wichtig: 'Wartungs_und_Stoerungszone' und 'Kundenstatus' sind hier API-Namen der Felder!
        coqlQuery = "select id, Last_Name, Email from Contacts where Wartungs_und_Stoerungszone = '" + targetZone + "' and Account_Name.Kundenstatus = 'Aktiv'";
        
        // 4. Die Abfrage ausführen
        matchingContacts = zoho.crm.coql(coqlQuery);
        
        // 5. Die gefundenen Kontakte mit dem "Service Update" verknüpfen
        if(matchingContacts.size() > 0)
        {
            // API-Name des Junction-Moduls lautet typischerweise "Modul1_X_Modul2"
            junctionModuleName = "Service_Updates_X_Contacts";
            recordsToLink = list();

            for each contact in matchingContacts
            {
                linkMap = map();
                linkMap.put("Service_Updates", serviceUpdateId);
                linkMap.put("Contacts", contact.get("id"));
                recordsToLink.add(linkMap);
            }
            
            // Verknüpfungen in einem Batch-Aufruf erstellen (effizienter als einzelne Aufrufe)
            createLinksResponse = zoho.crm.createRecord(junctionModuleName, recordsToLink);
            info createLinksResponse;
            
            // Erfolgsmeldung für den Anwender
            return {"success":{"message":matchingContacts.size() + " Kontakte wurden erfolgreich verknüpft."}};
        }
        else
        {
            return {"failure":{"message":"Keine passenden Kontakte für die Zone '" + targetZone + "' gefunden."}};
        }
    }
    else
    {
        return {"failure":{"message":"Bitte wähle zuerst eine betroffene Zone aus."}};
    }
}
return {"failure":{"message":"Service Update konnte nicht gefunden werden."}};

Nach dem Speichern dieses Skripts kannst Du einen Testdatensatz anlegen, eine Zone auswählen und auf den Button klicken. Die gefundenen Kontakte erscheinen kurz darauf in der zugehörigen Liste des Datensatzes.

Schritt 5: Der Versand – Anbindung an Zoho Campaigns oder ZeptoMail

Sobald die Kontakte verknüpft sind, kannst Du den eigentlichen Versandprozess starten. Hier gibt es mehrere Möglichkeiten:

  • Manuell via Zoho Campaigns: Erstelle eine benutzerdefinierte Ansicht im Kontakte-Modul, die alle Kontakte eines bestimmten Service Updates anzeigt. Diese Ansicht kannst Du dann in Zoho Campaigns importieren und eine gezielte Kampagne versenden.
  • Automatisiert via Zoho ZeptoMail: Erweitere das Deluge-Skript um eine Funktion, die nach der Verknüpfung eine transaktionale E-Mail über ZeptoMail an jeden Kontakt sendet. Das ist ideal für standardisierte Benachrichtigungen.
  • Flexibel via Zoho Flow: Erstelle einen Workflow in Zoho Flow, der durch einen Webhook-Aufruf am Ende Deines Deluge-Skripts getriggert wird. Flow kann dann die E-Mails über den Kanal Deiner Wahl (z.B. Zoho Mail, ZeptoMail) versenden und zusätzlich eine Benachrichtigung in einem Zoho Cliq-Kanal posten.

Der Tech-Stack im Überblick

Diese Lösung zeigt eindrucksvoll, wie die Stärke von Zoho in der Kombination verschiedener Tools liegt. Wir haben nicht nur eine einzelne App genutzt, sondern ein kleines Ökosystem geschaffen.

Zoho-intern

  • Zoho CRM: Die zentrale Datenbasis für Kunden, Kontakte und unser neues „Service Updates“-Modul.
  • Deluge: Die Low-Code-Skriptsprache, die als „Klebstoff“ dient und unsere Geschäftslogik abbildet.
  • COQL (CRM Object Query Language): Eine SQL-ähnliche Abfragesprache, um hochspezifische Datenabfragen im CRM durchzuführen, wie z.B. das Filtern von Kontakten basierend auf dem Status des zugehörigen Kunden.
  • Optionale Erweiterungen: Zoho Campaigns für Marketing-orientierte E-Mails, Zoho ZeptoMail für zuverlässige transaktionale E-Mails oder Zoho Flow für komplexe, App-übergreifende Workflows.

Externe Anbindungen via API und Webhooks

Denke den Prozess weiter! Ein „Service Update“ muss nicht manuell erstellt werden. Hier sind einige Ideen für die Anbindung externer Systeme:

  • Automatisierte Ticketerstellung aus Monitoring-Tools: Ein Monitoring-Dienst wie Datadog, UptimeRobot oder Pingdom könnte bei einem Ausfall automatisch über die Zoho CRM API einen neuen „Service Update“-Datensatz anlegen. Der API-Aufruf (z.B. per cURL) könnte so aussehen: 
    
# Beispiel: Erstellen eines Service Updates via Zoho CRM API v4
curl -X POST "https://www.zohoapis.de/crm/v4/Service_Updates" 
-H "Authorization: Zoho-oauthtoken DEIN_OAUTH_TOKEN" 
-H "Content-Type: application/json" 
-d '{
    "data": [
        {
            "Update_Titel": "Automatische Störungsmeldung: Server Z123 nicht erreichbar",
            "Betroffene_Zone": "Rechenzentrum A",
            "Status": "In Bearbeitung"
        }
    ]
}'
  • Status-Seite aktualisieren: Das Deluge-Skript kann am Ende einen Webhook an eine externe Status-Seite wie Statuspage.io (von Atlassian), Instatus oder Better Uptime senden, um Deine Kunden auch öffentlich über den Vorfall zu informieren. In Deluge nutzt Du dafür einfach den `invokeurl`-Befehl.
  • Interne Kommunikation: Informiere Dein Support-Team automatisch. Sende per Webhook eine Nachricht an einen Kanal in Slack oder Microsoft Teams, sobald ein neues „Service Update“ erstellt wird.

Tipps und Best Practices

  • Datenqualität ist alles: Der beste Prozess nützt nichts, wenn die Daten nicht stimmen. Etabliere einen Prozess, um regelmäßig zu prüfen, ob die „Wartungs- und Störungszonen“ und die Ansprechpartner bei Deinen Kontakten noch aktuell sind.
  • Skalierbarkeit durch ein „Zonen“-Modul: Wenn Deine Zonen komplexer werden (z.B. mit eigenen Ansprechpartnern, technischen Details etc.), ersetze das Picklist-Feld durch ein eigenes Custom Module „Zonen“. Du kannst dann das Feld „Betroffene Zone“ in ein Lookup-Feld umwandeln. Das sorgt für mehr Konsistenz und vermeidet Tippfehler bei der Dateneingabe.
  • Umfassend testen: Nutze eine Sandbox oder dedizierte Testkunden (z.B. mit „Testkunde“ im Namen), bevor Du die Funktion live schaltest. Nichts ist peinlicher, als versehentlich echte Kunden mit Testnachrichten zu bombardieren.
  • Mehrstufiger Prozess: Erwäge, den Button nicht direkt die Verknüpfung durchführen zu lassen, sondern zunächst eine Vorschauseite in einem Widget zu öffnen. Dort kann ein Mitarbeiter die Liste der gefundenen Kontakte prüfen und den Prozess manuell bestätigen. Das schaffst Du mit Zoho CRM Widgets.

Fazit

Du hast gesehen, wie Du mit den Bordmitteln von Zoho CRM und etwas Logik einen manuellen, fehleranfälligen Prozess in ein automatisiertes, nachvollziehbares und professionelles System verwandeln kannst. Der Schlüssel liegt darin, Zoho nicht als isolierte Anwendung, sondern als eine offene Plattform zu betrachten. Durch die Kombination von Custom Modules, Deluge-Skripting und der Anbindung an interne sowie externe Dienste über APIs und Webhooks schaffst Du Lösungen, die exakt auf Deine Geschäftsanforderungen zugeschnitten sind.

Diese Umsetzung spart nicht nur wertvolle Arbeitszeit, sondern erhöht auch die Qualität Deiner Kundenkommunikation erheblich und stärkt das Vertrauen in Deine Dienstleistungen. Es ist ein perfektes Beispiel dafür, wie Du Dein CRM von einem reinen Datenspeicher zu einer aktiven Kommandozentrale für Deine Geschäftsprozesse ausbaust.

Verwendete Zoho Apps: Zoho CRM, mit optionalen Erweiterungen durch Zoho Flow, Zoho Campaigns und Zoho ZeptoMail.