Incoming Webhooks

Incoming Webhooks ist eine Methode, um Informationen von einem Drittdienst oder einer API-Anfrage in Zoho Books zu übertragen, wenn ein Ereignis auftritt. In Zoho Books können Sie die Aktion in einem Drittdienst als Auslöser verwenden, um eine Aufgabe in Zoho Books auszuführen.
Hier sind einige Szenarien, um dies besser zu erklären:

Szenario 1: Zylker ist ein Unternehmen, das Stoff herstellt. Wenn eine Bestellung platziert wird, teilt das Verkaufs-Team den Bestellinhalt dem Produktions-Team in der Gruppe mit. Die Nachricht enthält eine Finish-Schaltfläche, die der Produktionsleiter klicken kann, sobald die Menge produziert wurde. Wenn die Schaltfläche geklickt wird, wird ein Incoming Webhook ausgelöst und automatisch eine Rechnung in Zoho Books erstellt.

Szenario 2: Patricia, die Marketingmanagerin von Zylker, zeigt die Produkte von Zylker an einer Veranstaltung. Sie sammelt während der Veranstaltung die E-Mail-Adressen der Leads, die ihren Stand besuchen. Danach sendet sie ihnen ein Formular, in dem die Kunden ihre Daten eingeben und die gewünschten Produkte kaufen können. Wenn ein Kunde seine Daten im Formular eingibt und auf „Absenden“ klickt, wird ein Incoming Webhook ausgelöst und die Kundeninformationen werden in Zoho Books eingetragen.

Incoming Webhooks erstellen

Sie können mehrere Incoming Webhooks erstellen, basierend auf den Funktionen, die Sie in Zoho Books ausführen möchten.

Um einen Incoming Webhook zu erstellen:

Melden Sie sich in Ihr Zoho Books-Organisationen an.
Gehe zu Einstellungen.
Wählen Sie unter Entwicklungsraum Incoming Webhooks aus.
Klicken Sie im oberen rechten Bereich auf + Neuer Incoming Webhook.

Geben Sie den Namen und die Beschreibung für den Incoming Webhook ein.
Geben Sie eine Funktion im Editor mit Deluge ein.
Klicken Sie auf Speichern.

Die OAuth-URL und die ZAPI-Key-URL werden generiert und in einem Popup angezeigt. Sie können die URL aus dem Popup kopieren.

Sie können die URLs auch kopieren, indem Sie auf die Pfeilspitze neben dem Namen des Incoming Webhooks in der Liste klicken. Copy URL

Einblick: Wenn Sie die Webhook-URL erneut generieren, müssen Sie die alte URL in allen Stellen ersetzen, an denen sie verwendet wurde. Sie können die URL erneut generieren, indem Sie die Schaltfläche „Regenerieren“ auf der Seite „Incoming Webhook bearbeiten“ klicken.

Notiz: Stellen Sie sicher, dass nur ein autorisierter Benutzer auf die URL zugreifen kann. Wenn die URL offen ist, kann jeder Benutzer, der auf die URL zugreifen kann, die Daten abrufen.

Sie können die URL nun in der dritten Partei-Anwendung konfigurieren, um eingehende Webhooks einzurichten. Wenn Sie Attribute in der Skript-Datei hinzufügen möchten, können Sie dies beim Aufruf der API tun.

Attribute	Beschreibung
Header	Der Header der API-Anfrage.
Params	Parameter sind die variablen Teile des Skripts, die durch die Anfrage der dritten Partei-API gegeben werden.
Body	Es ist ein String, der die Anfrage-Daten der API-Aufruf enthält.

Sobald konfiguriert, wird der eingehende Webhook erstellt.

Wenn nun eine Aktivität in der dritten Partei-Anwendung stattfindet, wird der eingehende Webhook ausgelöst und die in der Funktion angegebene Aktion wird ausgeführt.

Logs anzeigen

Sie können die Liste aller eingehenden Webhooks, die in Zoho Books ausgeführt wurden, unter dem Abschnitt „Logs anzeigen“ auf der Seite „Incoming Webhooks bearbeiten“ sehen.