Liste der Felder in Webhook

Webhooks einrichten

Die Einrichtung von Webhooks umfasst die folgenden drei Schritte:

• Einen Webhook erstellen.
• Webhook mit einer Workflow-Regel verknüpfen.
• Webhook-Integration testen.

So erstellen Sie einen Webhook

1. Navigieren Sie zu Setup > Automatisierung > Aktionen > Webhooks.
2. Klicken Sie auf der Seite Webhooks auf Webhook konfigurieren.
3. Geben Sie auf der Seite Neuer Webhook alle erforderlichen Parameter an.
4. Klicken Sie auf Speichern.

Nicht unterstützte Zusammenführungs-Feldwerte erkennen

Manchmal kann es vorkommen, dass die Werte der Platzhalterfelder, die Sie im Editor Wertbeschreibung Ihres Webhook verwendet haben, als ${Unsupported_Field} angezeigt werden. Im Folgenden sind einige der Gründe dafür aufgeführt.

Benutzerdefiniertes Feld gelöscht

Das Platzhalterfeld, dessen Wert Sie eingefügt haben, wurde gelöscht. Wenn der Editor für die Wertbeschreibung Ihres Webhook weiterhin den Wert des Platzhalterfelds eines gelöschten Felds enthält, wird dieser Wert als ${Unsupported_Field} angezeigt.

Benutzerdefiniertes Suchfeld gelöscht

Das benutzerdefinierte Suchfeld, dessen Wert Sie eingefügt haben, wurde gelöscht. Wenn der Editor für die Wertbeschreibung Ihres Webhook weiterhin den Wert des Platzhalterfelds eines gelöschten Suchfelds enthält, wird dieser Wert als ${Unsupported_Field} angezeigt.

Feld nicht in der Liste der verfügbaren Platzhalterfelder aufgeführt

Wenn Sie den Platzhalterfeldwert eines Felds verwendet haben, das nicht in der Liste der verfügbaren Platzhalterfelder für das ausgewählte Modul enthalten ist, wird es als ${Unsupported_Field} angezeigt.

Wenn Sie beispielsweise den Wert des Platzhalterfelds "${Leads.Lead Id}" im Editor für die Wertbeschreibung des "Deals"-Moduls eingeben, wird er als nicht unterstütztes Feld angezeigt.

Integration/Funktionen deaktiviert

Wenn eine Funktion oder Integration für Ihr Konto deaktiviert wurde, stehen die Felder, die im Rahmen der Integration angelegt wurden, nach der Deaktivierung auch für das Konto nicht mehr zur Verfügung. Wenn der Wert eines Platzhalterfelds in den Editor für die Wertbeschreibung eingefügt wurde, wird er als ${Unsupported_Field} angezeigt. Dies gilt für die folgenden Funktionen/Integrationen.

• Google AdWords Integration: Google AdWords-Felder, die nicht mehr verfügbar sind, werden nicht unterstützt.
• Besuchernachverfolgung (Zoho SalesIQ Integration): Nicht mehr verfügbare Felder zur Besuchernachverfolgung werden nicht mehr unterstützt.
• Gebietsverwaltung: Felder, die nicht mehr verfügbar sind, werden nicht unterstützt.
• Mehrere Währungen: Deaktivierte Währungen werden nicht unterstützt.

So verknüpfen Sie einen Webhook mit einer Workflow-Regel

1. Navigieren Sie zu Setup > Automatisierung > Workflow-Regeln.
2. Klicken Sie auf der Seite Workflow-Regeln auf die Schaltfläche Regel erstellen.
3. Geben Sie auf der Seite Neue Regel erstellen die Parameter der Workflow-Regel an.
4. Wählen Sie unter Workflow-Aktionen Webhooks aus.
5. Wählen Sie im Popup "Webhook aufrufen" den gewünschten Webhook aus, und klicken Sie auf Verknüpfen.
6. Klicken Sie auf Speichern.

So testen Sie die Webhook-Integration

1. Fügen Sie gemäß Ihren Kriterien für Workflow-Regeln Testdaten in CRM hinzu.
2. Überprüfen Sie in Ihrer Anwendung die von Zoho CRM über eine Webhook-Benachrichtigung empfangenen Daten.
3. Wenn ein Fehler oder eine Dateninkongruenz vorliegt, ändern Sie Ihre Webhook-Einstellungen in Zoho CRM.
4. Setzen Sie diesen Test fort, bis die erforderlichen Daten aus Zoho CRM in Ihrer Anwendung eingegangen sind.

Wichtige Hinweise

• Sie können bis zu 6 (1 Sofortaktion und 5 zeitbasierte Aktionen) Webhooks pro Workflow-Regel zuordnen.
• Sie können Daten für maximal 10 CRM-Felder von Zoho CRM über Webhooks an Drittanbieteranwendungen übertragen.
• Sie können Daten aus anderen Apps in Zoho CRM über Webhooks abrufen.
• Sie müssen das API-Ticket regelmäßig entsprechend den Einschränkungen in Drittanwendungen aktualisieren.
• Sie erhalten keine E-Mail-Benachrichtigung, wenn die Webhook-Integration aufgrund eines Problems in einer Drittanbieter-API nicht mehr funktioniert.
• In Webhooks sind maximal 10.000 Zeichen für ein benutzerdefiniertes Format zulässig, während die POST-Methode verwendet wird.
• Wenn es einen Fehler im Prozess gibt, sendet Webhook zuerst eine Benachrichtigung, und das Zoho CRM-System sendet nach 15 Minuten eine zweite Benachrichtigung. Danach sendet das System keine Webhook-Benachrichtigungen für diesen bestimmten Workflow-Auslöser.
• Wenn Sie die maximale Anzahl pro Tag überschreiten, sendet das System keine Benachrichtigungen über verbleibende Webhooks an Drittanbieteranwendungen und benachrichtigt den Administrator.
• Wenn Sie im Feld URL zur Benachrichtigung eine Portnummer angeben möchten, beachten Sie, dass nur die Portnummern 80 und 443 unterstützt werden.
• Zoho CRM bietet die Möglichkeit, das gewünschte Datum/Datum-Uhrzeit-Format und die Zeitzone während der Webhook-Parameterkonfiguration auszuwählen.
• Grenzwerte für Webhooks:
• Professional Edition – 10.000 Aufrufe/Tag oder 100 Aufrufe/Benutzerlizenz (je nachdem, welcher Wert niedriger ist).
• Enterprise Edition – 20.000 Aufrufe/Tag oder 500 Aufrufe/Benutzerlizenz (je nachdem, welcher Wert niedriger ist).

Geschäftsszenario 1

Berechnen Sie die Verkaufsprovision in der Zoho Creator-App, wenn Sie eine Verkaufchance in Zoho CRM abschließen.

Zweck

Vertriebsleiter und das Lohnabrechnungs-Team können mit der Sales Commission-App die Vergütung für Ihre Vertriebsmitarbeiter nach einer vordefinierten Formel berechnen, die von Ihrem Unternehmen festgelegt wurde (z. B. pauschal 2 % des Vertragsabschlusses oder Verkaufsbetrags). Diese Anwendung hilft Ihnen, manuelle Eingaben zu reduzieren, Fehler zu minimieren und Zeit bei der Berechnung der Provision für Ihre Vertriebsmitarbeiter zu sparen. Darüber hinaus können Vertriebsmitarbeiter ihre monatlichen Provisionen an einem zentralen Ort verfolgen.

Voraussetzung

• Konto in der Zoho Creator-Anwendung
• Berechtigung zum Zugriff auf die Zoho-API
• Vertrautheit im Umgang mit Zoho Creator

Vorgehensweise

1. Erstellen Sie die Sales Commission-App in Zoho Creator (siehe Zoho Creator-Tutorial zum Erstellen von Apps)
2. Webhook in Zoho CRM konfigurieren
3. Workflow-Regel einrichten
4. Webhook-Integration testen

Schritt 1: Erstellen Sie die Sales Commission-App in Zoho Creator

Erstellen Sie in Zoho Creator die Sales Commission-App mit folgenden Feldern:

• Vertriebsmitarbeiter
• Name Geschäftsabschluss
• Name des Kunden
• Betrag der Verkaufschance
• Art des Unternehmens: Neugeschäft oder bestehendes Geschäft
• Abschlussdatum
• Provision

Informationen zur Erstellung einer Anwendung in Zoho Creator finden Sie in der Online-Hilfe.

Schritt 2: Webhook konfigurieren

Wählen Sie die folgenden Felder im "Deal"-Modul aus, während Sie benutzerdefinierte Parameter einrichten:

• Name Geschäftsabschluss
• Abschlussdatum
• Typ
• Datensatzbesitzer
• Betrag

Geben Sie in Webhook die folgenden Details an:

Zu benachrichtigende URL:

1. https://creator.zoho.com/api/xml/write – POST-Methode

Benutzerdefinierte Parameter (XML oder JSON)

Benutzerdefinierte Parameter:

Parameter	Beschreibung
authtoken*	Geben Sie einen Authentifizierungstoken aus Ihrem Creator-Konto an. Weitere Informationen finden Sie in der Hilfe zu Creator.
zc_ownername*	Geben Sie den Namen des Anwendungseigentümers Ihres Creator-Kontos an.

Schritt 3: Workflow-Regel einrichten

Führen Sie diese Schritte auf der Seite "Workflow-Regel" aus:

1. Workflow-Kriterien einrichten als:
   • Typ ist Neugeschäft
   • Phase ist abgeschlossen (gewonnen)
2. Klicken Sie auf Weiter.
   
3. Wählen Sie Webhook als sofortige Aktion aus.
4. Wählen Sie im Popup Webhook aufrufen den gewünschten Webhook aus der Liste aus, und klicken Sie auf Verknüpfen.
5. Speichern Sie die Workflow-Regel.

 

Webhook mit der Workflow-Regel verknüpfen

Schritt 4: Integration testen

1. Fügen Sie in CRM einen Testabschluss mit den Feldern "Typ" und "Phase" als "Neugeschäft" bzw. "Abgeschlossen (gewonnen)" hinzu. Achten Sie bei der Eingabe von Testdaten darauf, dass auch "Betrag", "Abschlussdaten", "Datensatzbesitzer", "Kontoname" und "Deal-Name" eingegeben werden.
2. Öffnen Sie Ihre Sales Commission-App in Zoho Creator, und suchen Sie nach den CRM-Daten. 
   Wenn Sie keine Daten erhalten haben, ändern Sie die Webhook-Konfiguration, und setzen Sie den Test fort. Entfernen Sie nach einem erfolgreichen Test die Testeinträge, und implementieren Sie diese Integration bei Ihren CRM-Benutzern.

Geschäftsszenario 2

Senden von SMS-Benachrichtigungen an Kunden und Vertriebsmitarbeiter.

Zweck

Eine Zahlung eines Kunden ist heute fällig. Sie können eine SMS mit dem Fälligkeitsdatum der Zahlung, dem Kundennamen und den Betragsdetails an Ihren Vertriebsmitarbeiter senden, indem Sie Webhook mit der zeitbasierten Aktion in der Workflow-Regel verknüpfen.

Voraussetzung

• Konto im SMS-Gateway-Dienst
• Berechtigung zum Zugriff auf Workflow-Regeln

Vorgehensweise

1. Konto im SMS-Gateway-Dienst erstellen
2. Webhook in Zoho CRM konfigurieren
3. Workflow-Regel einrichten
4. Webhook-Integration testen

Schritt 1: Konto im SMS-Gateway-Dienst erstellen

Erstellen Sie in Ihrem SMS-Gateway-Dienst ein Konto, und rufen Sie diese Details ab, um Webhook zu konfigurieren:

• Vertriebsmitarbeiter
• Name Geschäftsabschluss
• Name des Kunden
• Betrag der Verkaufschance
• Art des Unternehmens: Neugeschäft
• Phase: abgeschlossen (gewonnen)
• Fälligkeitsdatum der Zahlung (benutzerdefiniertes Feld)

Derzeit arbeitet Zoho mit den folgenden Anbietern von SMS-Gateways zusammen:

• Bulk SMS
• Clickatell
• Screen Magic
• Valueleaf
• Solutions Infini

Sie können SMS-Gutschriften und API-Details bei den oben genannten Anbietern erwerben.

Schritt 2: Webhook konfigurieren

Wählen Sie die folgenden Felder aus dem "Leads"-Modul aus, während Sie benutzerdefinierte Parameter einrichten:

• Domänenname des SMS-Gateways
• Benutzername
• Authentifizierungstoken

Geben Sie in Webhook die folgenden Details an:

Zu benachrichtigende URL:

1. http://<Domain Name>/smsgateway/post – POST-Methode

Benutzerdefinierte Parameter (XML oder JSON)

Schritt 3: Workflow-Regel einrichten

Führen Sie diese Schritte auf der Seite "Workflow-Regel" aus:

1. Workflow-Kriterien einrichten als:
   • Typ ist Neugeschäft.
   • Phase ist abgeschlossen (gewonnen).
   • Wählen Sie das Abschlussdatum.
2. Wählen Sie den Webhook als zeitbasierte Aktion aus.
3. Speichern Sie die Workflow-Regel.

Kriterien für Workflow-Regeln

Webhook mit der Workflow-Regel verknüpfen

Schritt 4: Integration testen

1. Fügen Sie ein Testangebot in CRM mit den Feldern "Typ" und "Fälligkeitsdatum" als "bestehendes Geschäft" bzw. "heute" hinzu. Achten Sie bei der Eingabe von Testdaten darauf, dass auch "Betrag", "Abschlussdaten", "Datensatzbesitzer", "Kontoname" und "Deal-Name" eingegeben werden.
2. Überprüfen Sie Ihr Smartphone auf SMS-Benachrichtigungen.
   Wenn Sie keine SMS erhalten haben, ändern Sie die Webhook-Konfiguration, und setzen Sie den Test fort. Entfernen Sie nach einem erfolgreichen Test die Testeinträge, und implementieren Sie diese Integration bei Ihren CRM-Benutzern.

---

Siehe Fehlercodes

Wenn die Ausführung von Webhook fehlschlägt, wird in Zoho CRM eine der folgenden Fehlermeldungen angezeigt:

HTTP-Statuscodes

• 400 Bad Request – oft fehlt ein erforderlicher Parameter.
• 401 Unauthorized – kein gültiger Authentifizierungstoken vorhanden.
• 402 Request Failed – Parameter waren gültig, aber Anforderung ist fehlgeschlagen.
• 404 Not Found – der gewünschte Artikel existiert nicht.
• 500, 502, 503, 504 Server errors –Fehler in der Drittanbieteranwendung.
• Error Code 1 – vorübergehend nicht in der Lage, sich mit dem API-Server zu verbinden. Überprüfen Sie die API-Serverprotokolle und Firewalleinstellungen auf Anfragen aus dem CRM.

Benutzerdefinierte Fehler

• Interner Prozessausfall – wenn der Webhook aufgrund von Fehlern in der Verarbeitung des Webhook nicht ausgeführt wird.
• Tageslimit erreicht – wenn das Unternehmen das maximale Limit für den Tag erreicht hat.
• Wenn der Webhook aufgrund einer SSRF-gefährdeten oder ungültigen URL nicht ausgeführt wird.