HANS mit Zapier, Make oder n8n verbinden

Vorher nötig

• Die Rolle Leitung
• Eine Empfangsadresse aus Ihrem Automatisierungsdienst. In Zapier heißt der Baustein „Catch Hook“, in Make „Custom Webhook“, in n8n „Webhook“.

Ein Ziel eintragen

1. 1

   Öffnen Sie Einrichtung › Verbindungen, klicken Sie auf Verbindung einrichten und wählen Sie Ereignis-Webhooks.

2. 2

   Klicken Sie auf Ziel hinzufügen.

3. 3

   Fügen Sie unter Adresse die Empfangsadresse ein.

   Erlaubt sind nur https-Adressen, die direkt antworten. Interne Adressen nimmt HANS nicht an.

4. 4

   Geben Sie dem Ziel eine Bezeichnung.

5. 5

   Wählen Sie unter Diese Ereignisse senden, was gemeldet wird.

   Zur Wahl stehen neue, geänderte und stornierte Buchungen, Check-in, Check-out, verbuchte Zahlungen und neue Anfragen. Buchungen von Portalen zählen mit. Dazu kommen Kontakt angemeldet und Kontakt abgemeldet für den Newsletter. Damit schreiben Sie eine Abmeldung in ein anderes System zurück. Arbeitet Ihr Haus nur mit dem Newsletter, stehen nur diese beiden zur Wahl.

6. 6

   Entscheiden Sie über Gästedaten mitsenden.

   Ohne den Schalter gehen nur Kennungen, Daten und Beträge hinaus. Mit ihm kommen Name, E-Mail, Telefon und Land des Bestellers dazu. Meldedaten aus dem Check-in verlassen HANS nie. Bei An- und Abmeldungen steht die E-Mail-Adresse nur mit dem Schalter in der Nachricht.

7. 7

   Speichern Sie und klicken Sie beim Ziel auf Testen.

   HANS schickt ein Testereignis. In Zapier, Make oder n8n sehen Sie damit, wie die Daten aufgebaut sind.

Bis zu drei Ziele sind möglich, jedes mit eigener Auswahl.

Was dann passiert

HANS meldet ein Ereignis meist innerhalb von 30 Sekunden. Jede Nachricht trägt eine Signatur. Den Signaturschlüssel dazu zeigt HANS beim Ziel. Mit ihm prüft die Gegenstelle, dass die Nachricht wirklich von HANS kommt.

Jedes Ereignis kommt mindestens einmal an, in keiner festen Reihenfolge. Es kann also auch doppelt ankommen. Doppelte erkennen Sie an derselben Ereignis-Id im Kopf X-Hans-Event-Id.

Antwortet das Ziel nicht, versucht HANS es nach 1, 5 und 30 Minuten, nach 2 und nach 6 Stunden erneut. Was hinausging und was die Gegenstelle antwortete, steht im Zustellprotokoll unter Protokoll. Dort schickt Nochmal senden ein Ereignis erneut.

Wenn es nicht klappt