Tutorial: Webhooks in Zoho CRM einrichten – Schritt für Schritt
Hier ist ein detailliertes Tutorial, wie Sie Webhooks in Zoho CRM einrichten, um Daten automatisch an andere Anwendungen (wie Slack, Zapier oder Ihren eigenen Server) zu senden.
Webhooks sind eine leistungsstarke Methode, um Echtzeit-Benachrichtigungen von Zoho CRM an externe Anwendungen zu senden. Sobald ein bestimmtes Ereignis in Ihrem CRM eintritt (z. B. ein neuer Lead wird erstellt), sendet Zoho automatisch Daten an eine von Ihnen festgelegte URL.
Voraussetzungen
- Ein Zoho CRM-Konto (Enterprise- oder Ultimate-Edition erforderlich für Workflows).
- Eine Ziel-URL (Endpoint), an die die Daten gesendet werden sollen.
- Grundkenntnisse darüber, welche Daten Sie übertragen möchten.
Schritt 1: Erstellen des Webhooks (Die Aktion)
Bevor Sie eine Regel festlegen, müssen Sie definieren, wohin die Daten fließen sollen.
- Melden Sie sich bei Zoho CRM an.
- Klicken Sie oben rechts auf das Einstellungen-Symbol (Zahnrad).
- Wählen Sie unter der Rubrik Automatisierung den Punkt Workflow-Regeln.
- Klicken Sie im oberen Menü nicht auf "Regel erstellen", sondern auf den Reiter Aktionen und wählen Sie dort Webhooks.
- Klicken Sie auf den Button + Webhook konfigurieren.
Konfigurations-Details:
- Name: Geben Sie dem Webhook einen aussagekräftigen Namen (z.B. „Neuer_Lead_an_Slack“).
- URL zu benachrichtigen: Geben Sie hier die Ziel-URL (Endpoint) ein.
- Methode: Wählen Sie meistens POST (um Daten zu senden).
- Parameter für URL-Abfrage / Body:
- Hier entscheiden Sie, welche Felder übertragen werden.
- Wählen Sie unter Parameter im Body hinzufügen die Option Modulparameter.
- Wählen Sie das Modul (z.B. Leads) und die entsprechenden Felder (z.B. Nachname, E-Mail).
- Geben Sie jedem Feld einen Namen, den die Ziel-App versteht (z.B.
last_name).
- Klicken Sie auf Speichern.
Schritt 2: Workflow-Regel erstellen (Der Auslöser)
Nun müssen Sie festlegen, wann der Webhook ausgelöst werden soll.
- Gehen Sie zurück zu Einstellungen > Automatisierung > Workflow-Regeln.
- Klicken Sie auf + Regel erstellen.
- Wählen Sie das Modul aus (z.B. Leads) und geben Sie der Regel einen Namen.
- Wann soll diese Regel ausgeführt werden?
- Wählen Sie z.B. Datensatzaktion und dann Erstellt.
- Bedingungen:
- Wählen Sie „Alle Leads“ oder definieren Sie bestimmte Kriterien (z.B. nur Leads aus einer bestimmten Quelle).
- Sofortige Aktionen:
- Klicken Sie auf das Plus-Symbol oder „Aktion auswählen“.
- Wählen Sie Webhooks.
- Wählen Sie den Webhook aus, den Sie in Schritt 1 erstellt haben.
- Klicken Sie auf Speichern.
Schritt 3: Den Webhook testen
Es ist wichtig zu prüfen, ob die Daten korrekt ankommen.
- Tool-Tipp: Nutzen Sie eine Website wie Webhook.site, um eine temporäre URL zu generieren. Kopieren Sie diese URL in Ihren Zoho-Webhook als Test-Ziel.
- Erstellen Sie im CRM einen Test-Datensatz (z.B. einen neuen Lead).
- Überprüfen Sie auf Webhook.site, ob die JSON-Daten wie gewünscht eingegangen sind.
- Wenn alles funktioniert, ersetzen Sie die Test-URL durch Ihre echte Ziel-URL.
Wichtige Hinweise & Best Practices
- Limits: Zoho CRM hat je nach Edition tägliche Limits für die Anzahl der Webhook-Aufrufe. Achten Sie darauf, diese nicht durch Massen-Updates zu überschreiten.
- Sicherheit: Falls Sie sensible Daten senden, stellen Sie sicher, dass Ihre Ziel-URL über HTTPS verschlüsselt ist.
- Format: Zoho sendet die Daten standardmäßig im Format
application/x-www-form-urlencodedoder als JSON, je nachdem, wie Sie die Parameter konfigurieren. Stellen Sie sicher, dass Ihre Empfänger-App dieses Format verarbeiten kann.
Zusammenfassung
Die Einrichtung besteht immer aus zwei Teilen:
- Was wird gesendet? (Konfiguration unter Aktionen > Webhooks)
- Wann wird es gesendet? (Verknüpfung in der Workflow-Regel)
Mit dieser Einrichtung können Sie Zoho CRM nahtlos in Ihre restliche Software-Landschaft integrieren!