Blog

WordPress, Zoho Flow und Azure API integrieren: Automatisierte Angebots- und Projektprozesse umsetzen

  • Beitrags-Autor:

Jenseits der Standard-Integration: Wie du Zoho mit WordPress, Azure & Co. per API verbindest

Einleitung

Wenn du das Zoho-Ökosystem nutzt, weißt du seine Stärke zu schätzen: eine Vielzahl von Apps, die nahtlos ineinandergreifen. Doch die wahre Magie entfaltet sich erst, wenn du Zoho als offene Plattform begreifst und es gezielt mit externen Spezialwerkzeugen verbindest. Viele Unternehmen stehen vor der Herausforderung, dass ihre Prozesse nicht an den Grenzen einer einzelnen Software-Suite enden. Eine Anfrage auf einer WordPress-Website, komplexe Berechnungen in einer Individualanwendung oder die Archivierung von Daten in einer Cloud-Plattform wie Microsoft Azure – all das sind typische Szenarien. In diesem Artikel zeigen wir dir, wie du solche Insellösungen auflöst und einen durchgängigen, automatisierten Prozess schaffst, der von einer Web-Anfrage bis zur Projektanlage und externen Datenübergabe reicht. Wir bauen eine Brücke zwischen Marketing, Vertrieb, Finanzen und Projektmanagement.

Das Praxisbeispiel: Von der komplexen Web-Anfrage zum automatisierten Projekt

Stell dir vor, du bietest hochgradig individualisierte Produkte oder Dienstleistungen an. Ein potenzieller Kunde füllt ein detailliertes Anfrageformular auf deiner WordPress-Website aus. Diese Anfrage ist keine simple Lead-Erfassung. Sie enthält technische Spezifikationen, Dateianhänge und individuelle Anforderungen, die eine manuelle Kalkulation erfordern.

Der Standard-Workflow – eine E-Mail-Benachrichtigung oder ein einfacher Eintrag im CRM – reicht hier nicht aus. Das Ziel ist ein vollautomatisierter Prozess:

  1. Die Anfrage aus WordPress wird sicher an Zoho übermittelt.
  2. Ein Deal im Zoho CRM wird automatisch angelegt.
  3. Eine spezielle Logik für die Kalkulation wird in einer benutzerdefinierten Anwendung in Zoho Creator ausgeführt.
  4. Basierend auf der Kalkulation wird ein Angebot in Zoho Books erstellt.
  5. Das Angebot wird per Zoho Sign zur digitalen Unterschrift versendet.
  6. Nach der Annahme wird automatisch ein Projekt in Zoho Projects angelegt und das Team via Zoho Cliq informiert.
  7. Relevante Projektdaten werden zur Langzeitarchivierung oder für Business-Intelligence-Zwecke an einen externen Dienst wie Microsoft Azure übermittelt.

Dieser Prozess überbrückt nicht nur verschiedene Zoho-Apps, sondern integriert auch externe Systeme und zeigt die Flexibilität der Zoho-Plattform durch APIs und Webhooks.

Der Tech-Stack für unsere Lösung

Um diesen Workflow umzusetzen, nutzen wir eine Kombination aus Zoho-Apps und externen Diensten. Jedes Werkzeug erfüllt eine spezifische Aufgabe:

  • WordPress: Das Frontend für den Kunden. Hier steht das Anfrageformular (z.B. mit Gravity Forms oder Contact Form 7).
  • Zoho Flow: Die zentrale Datendrehscheibe. Flow empfängt die Daten per Webhook und orchestriert die ersten Schritte des Workflows.
  • Zoho Creator: Das Gehirn für unsere individuelle Geschäftslogik. Hier bauen wir eine kleine App, die die komplexen Kalkulationen durchführt, die im CRM nicht abgebildet werden können.
  • Zoho CRM: Das Herzstück des Vertriebsprozesses. Hier wird der Deal verwaltet.
  • Zoho Books: Verantwortlich für die Finanzen. Hier erstellen wir das offizielle Angebot.
  • Zoho Sign: Für den rechtssicheren, digitalen Vertragsabschluss.
  • Zoho Projects: Das Werkzeug für die operative Umsetzung nach Auftragserteilung.
  • Zoho Cliq: Das Kommunikationstool für sofortige Benachrichtigungen an das Team.
  • Microsoft Azure (optional): Ein Beispiel für eine externe Plattform zur Datenarchivierung oder für erweiterte Analysen, angebunden über eine REST-API.

Schritt-für-Schritt: Die Umsetzung im Detail

Schritt 1: Das Tor zu Zoho – Der Webhook in Zoho Flow

Der erste Schritt ist, die Daten aus dem WordPress-Formular sicher zu Zoho zu bekommen. Anstatt einer fehleranfälligen E-Mail-Analyse nutzen wir einen Webhook.

  1. Erstelle einen neuen Flow in Zoho Flow. Wähle als Trigger „Webhook“ aus der Kategorie „Apps“.
  2. Zoho Flow generiert eine eindeutige URL. Kopiere diese.
  3. Gehe in deinem WordPress-Backend zu den Einstellungen deines Formular-Plugins. Die meisten professionellen Plugins (wie Gravity Forms oder Fluent Forms) unterstützen Webhooks als Aktion nach dem Absenden des Formulars.
  4. Füge die URL von Zoho Flow ein und konfiguriere das Formular so, dass es die Daten als JSON-Payload sendet. Führe einen Testlauf durch, indem du das Formular einmal ausfüllst. Zoho Flow erkennt nun die Datenstruktur.

Schritt 2: Daten annehmen und eine Custom Function aufrufen

In Zoho Flow könntest du nun direkt einen Deal im CRM anlegen. Da wir aber eine komplexe Logik benötigen, delegieren wir diese Aufgabe an eine leistungsfähigere Komponente: eine Custom Function in Zoho Creator.

Füge in deinem Flow nach dem Webhook-Trigger eine „Custom Function“-Aktion hinzu. Wir übergeben die gesamte JSON-Payload des Webhooks an diese Funktion.

Schritt 3: Die Logik in Zoho Creator mit Deluge

In Zoho Creator erstellst du eine neue Anwendung, z.B. „Anfrage-Kalkulator“. Hier kannst du Formulare und Felder für deine spezifischen Berechnungen definieren. Das Herzstück ist jedoch eine globale Custom Function, die wir mit Deluge, der Scriptsprache von Zoho, schreiben.

Diese Funktion nimmt die Daten von Zoho Flow entgegen, führt die folgenden Aktionen aus und ist damit das zentrale Element unserer Automatisierung:

  1. Daten parsen: Die JSON-Daten aus dem Webhook werden ausgelesen.
  2. Kontakt/Account prüfen: Überprüfen, ob der Kontakt oder die Firma bereits im CRM existiert. Falls nicht, neu anlegen.
  3. Deal erstellen: Einen neuen Deal im Zoho CRM anlegen und mit dem Kontakt/Account verknüpfen.
  4. Kalkulation durchführen: Die spezifische Geschäftslogik ausführen und das Ergebnis berechnen.
  5. Angebot in Books erstellen: Über die API von Zoho Books ein neues Angebot (Estimate) mit den kalkulierten Positionen erstellen.

Hier ist ein vereinfachtes Beispiel für eine solche Deluge-Funktion:


// Deluge Custom Function in Zoho Creator
// Sie akzeptiert ein JSON-Objekt namens 'requestData' von Zoho Flow

map processWebInquiry(map requestData)
{
    // 1. Daten aus dem Webhook extrahieren
    contactEmail = requestData.get("email");
    companyName = requestData.get("company");
    inquiryDetails = requestData.get("details");
    
    // 2. Kontakt im CRM suchen oder erstellen
    searchResponse = zoho.crm.searchRecords("Contacts", "(Email:equals:" + contactEmail + ")");
    contactId = null;
    if(searchResponse.size() > 0)
    {
        contactId = searchResponse.get(0).get("id");
    }
    else
    {
        contactMap = Map();
        contactMap.put("Last_Name", requestData.get("lastName"));
        contactMap.put("Email", contactEmail);
        createResponse = zoho.crm.createRecord("Contacts", contactMap);
        contactId = createResponse.get("id");
    }
    
    // 3. Deal im CRM erstellen
    dealMap = Map();
    dealMap.put("Deal_Name", "Anfrage von " + companyName);
    dealMap.put("Stage", "Analyse");
    dealMap.put("Contact_Name", {"id": contactId});
    createDealResponse = zoho.crm.createRecord("Deals", dealMap);
    dealId = createDealResponse.get("id");
    
    // 4. Komplexe Kalkulation (hier vereinfacht)
    // In einem echten Szenario würde hier deine Geschäftslogik stehen
    calculatedPrice = 1500.00; // Beispielwert
    
    // 5. Angebot in Zoho Books erstellen
    // Wichtig: Zuerst eine Connection zu Zoho Books einrichten
    organizationId = "YOUR_ORGANIZATION_ID"; // Deine Zoho Books Org ID
    estimateMap = Map();
    estimateMap.put("customer_id", contactId); // Annahme: CRM-ID ist mit Books-ID synchron
    lineItems = List();
    lineItem = Map();
    lineItem.put("name", "Individualisierte Dienstleistung");
    lineItem.put("rate", calculatedPrice);
    lineItem.put("quantity", 1);
    lineItems.add(lineItem);
    estimateMap.put("line_items", lineItems);
    
    // API-Aufruf an Zoho Books
    response = invokeurl
    [
        url :"https://www.zohoapis.eu/books/v3/estimates?organization_id=" + organizationId
        type :POST
        parameters:{"JSONString": estimateMap.toString()}
        connection:"zohobooks_connection" // Name deiner API-Connection
    ];
    
    info "Angebot erstellt: " + response;
    
    // Rückgabe der erstellten IDs
    returnMap = Map();
    returnMap.put("dealId", dealId);
    returnMap.put("estimateResponse", response);
    return returnMap;
}

Schritt 4: Angebot versenden und Projekt anlegen

Der Rest des Prozesses kann nun durch Standard-Workflows in den jeweiligen Zoho-Apps gesteuert werden:

  • Angebot versenden: Ein Workflow in Zoho Books kann das neu erstellte Angebot automatisch per E-Mail an den Kunden senden und dabei eine Zoho Sign-Vorlage verwenden.
  • Projekt erstellen: Zoho Sign kann bei Abschluss eines Dokuments einen Webhook auslösen. Erstelle einen weiteren, einfachen Flow in Zoho Flow, der auf diesen Webhook reagiert. Wenn das Angebot als „Abgeschlossen“ markiert wird, kann dieser Flow:
    1. Den Deal im CRM auf die Stufe „Gewonnen“ setzen.
    2. Ein neues Projekt in Zoho Projects basierend auf einer Vorlage erstellen.
    3. Eine Nachricht im relevanten Kanal in Zoho Cliq posten: „Neues Projekt XY gestartet! Kunde: [Kundenname]“.

Schritt 5: Daten an ein externes System wie Azure übergeben

Angenommen, du möchtest alle Projektdaten für eine Langzeitanalyse in einer Azure SQL-Datenbank speichern. Du kannst die Deluge-Funktion, die das Projekt anlegt, erweitern, um Daten über die `invokeurl`-Anweisung an eine externe REST-API zu senden.

Dafür benötigst du einen API-Endpunkt, zum Beispiel eine „Azure Function“, die auf HTTP-Anfragen wartet.


// Teil einer Deluge-Funktion, die nach der Projekterstellung aufgerufen wird
projectId = "12345...";
projectName = "Neues Webprojekt";
customerName = "Beispiel GmbH";

// Daten für die externe API vorbereiten
azurePayload = Map();
azurePayload.put("project_id_zoho", projectId);
azurePayload.put("project_name", projectName);
azurePayload.put("customer", customerName);
azurePayload.put("creation_date", zoho.currenttime);

// API-Aufruf an die Azure Function
azureResponse = invokeurl
[
    url :"https://your-azure-function-app.azurewebsites.net/api/archiveProject"
    type :POST
    headers:{"x-functions-key":"YOUR_AZURE_FUNCTION_KEY"} // Authentifizierung
    parameters:azurePayload.toString()
];

info "Daten an Azure gesendet: " + azureResponse;

Tipps und Best Practices

  • Sicherheit geht vor: Speichere API-Schlüssel, Tokens und andere Zugangsdaten niemals direkt im Code. Nutze die integrierten „Connections“ in Zoho, die eine sichere OAuth2- oder Token-basierte Authentifizierung ermöglichen.
  • Fehlerbehandlung einbauen: Was passiert, wenn ein API-Aufruf fehlschlägt? Nutze `try-catch`-Blöcke in deinem Deluge-Skript, um Fehler abzufangen und Benachrichtigungen zu senden, damit du den Prozess manuell überprüfen kannst.

    • …

  • Skalierbarkeit bedenken: Für einfache bis mittlere Workloads sind Custom Functions in CRM oder Creator ideal. Wenn du jedoch Tausende von Anfragen pro Tag erwartest, solltest du die Logik auf die serverlose Plattform Zoho Catalyst auslagern. Catalyst ist für hohe Lasten ausgelegt und bietet noch mehr Flexibilität.
  • Modularer Aufbau: Zerlege komplexe Prozesse in kleinere, wiederverwendbare Funktionen. Eine Funktion für die Kontaktsuche, eine für die Dealerstellung etc. Das macht deinen Code lesbarer und wartbarer.

Fazit

Die wahre Stärke des Zoho-Ökosystems liegt in seiner Offenheit. Indem du gezielt Webhooks, APIs und die Skriptsprache Deluge einsetzt, kannst du hochgradig individuelle und automatisierte Workflows schaffen, die weit über die Standardfunktionen hinausgehen. Du bist nicht auf die Zoho-Welt beschränkt, sondern kannst Best-of-Breed-Lösungen wie WordPress für dein Marketing, Magento für deinen E-Commerce oder Microsoft Azure für deine Datenanalyse nahtlos integrieren.

Diese Art der Prozessautomatisierung spart nicht nur massiv Zeit und reduziert manuelle Fehler, sondern schafft auch einen nahtlosen Datenfluss durch dein gesamtes Unternehmen. Du gewinnst die Flexibilität, auf spezifische Kundenanforderungen schnell zu reagieren, ohne auf teure und langwierige Individualentwicklungen angewiesen zu sein.

Verwendete Zoho Apps in diesem Beispiel: