Aktion Webhook

Im Marketplace kommen Webhooks zum Einsatz, um bestimmte Services automatisiert in Anspruch zu nehmen.

Unter Webhooks versteht man allgemein den Aufruf speziell präparierter Webseiten um gezielt Informationen weiterzugeben, so dass hierfür kein regelmäßiges Polling betrieben werden muss.

Diese Services haben keine sichtbare GUI für den Benutzer, sondern laufen im Hintergrund. Ausgelöst werden die Webhooks durch bestimmte Aktionen, z.B. beim Speichern einer Immobilie, wenn sich bestimmte Felder geändert haben. So werden die Sprengnetter-Immobilienbewertung oder der Newsletter Connector als Webhooks ausgeführt. Ändern sich z.B. Preis- oder Flächenfelder einer Immobilie, wird der Sprengnetter-Webhook ausgelöst, der eine erneute Immobilienbewertung anstößt.

Über den Prozessschritt “Webhook” kann eine Information an einen Service eines onOffice Marketplaceteilnehmers weitergeleitet werden. D.h. der Webhook des Anbieters wird ausgelöst.

Vorraussetzung ist, das der Marketplaceservice als Webhook ausgeführt wird.

Bei Fragen zu den einzelnen Webhooks kontaktieren Sie bitte den Anbieter des Marketplaceservices.
Fragen zum Prozessschritt selber stellen Sie bitte an den onOffice Support (support@onoffice.de / +49 241 44 686 122)

Start

Sie definieren links oben den Start des Prozessschrittes. Sie haben hier die Auswahl zwischen dem Start „Nach Beendigung des vorherigen“ oder nach „x Tagen nach vorherigen“.

Verantwortung

Bei der Verantwortung wählen Sie zwischen dem Prozesssverantwortlichen, dem Betreuer der/des mit dem Prozess verknüpften Immobilien- bzw. Adressdatensatzes (Voraussetzung hierfür ist natürlich, dass eine Immobilie oder ein Adressdatensatz mit dem Prozessschritt verknüpft ist) oder einem direkten Benutzer.

Deadline

Sie können eine Deadline für die Erledigung dieses Prozessschrittes in Tagen definieren. Wurde der Prozessschritt nach dem Start nicht innerhalb der gesetzten Frist (angegeben in Tagen) bearbeitet, wird eine E-Mail an den Prozess-Controller gesendet, damit er über den Verzug informiert wird. Die E-Mail-Adresse des Prozess-Controllers kann in den Prozess-Einstellungen (Schraubenschlüssel-Symbol) eingetragen werden.

Haus- und Adresssymbol

Über diese beiden Symbole entscheiden Sie, auf welche Immobilie bzw. Adresse sich dieser Prozessschritt bezieht. Eventuelle Aktivitäten- / Maklerbucheinträge werden dann in diesen Datensätzen vorgenommen.

Service / Parameter

Hier sind alle aktivierten Marketplaceservices Ihres Mandanten gelistet, die einen Webhook enthalten.

Bitte wählen Sie den gewünschten Marketplaceservice aus und wählen gegebenenfalls einen Parameter aus der Auswahl und tragen Sie den gewünschten Wert dafür ein. Diese Parameter werden beim Aufruf des Webhooks mit an die URL übergeben.

Bitte beachten Sie, der Webhook muss vom Anbieter angeboten werden und in seinem Marketplaceservice konfiguriert sein. Dabei wird festgelegt, welche Parameter möglich sind.

Experteninformation

Webhooks können eingesetzt werden, wenn im Rahmen von einem Prozess z.B. Änderungen an einer Immobilie vorgenommen werden. Mit dem Webhook kann der Service eines Marketplace-Anbieters angesprochen werden, um z.B. den Marktwert neu zu ermitteln und in der Immobilie einzutragen.