Webhooks: sofort wissen, dass ein Ticket verkauft ist

Angenommen, Sie möchten, dass der Zähler auf Ihrer Website sofort weiterspringt, sobald ein Ticket verkauft ist. Dafür gibt es zwei Wege, und einer ist deutlich besser.

Dieser Artikel erklärt, was ein Webhook ist und ob Sie einen brauchen. Wie Sie einen einrichten, Schaltfläche für Schaltfläche, steht in Webhooks einrichten.

Die umgekehrte Welt

Ohne Webhook muss Ihre Website ständig nachfragen. Jede Minute, den ganzen Tag: „Ist schon etwas verkauft?“ Meistens lautet die Antwort nein. Das sind vierzehnhundert Fragen, um dreimal ja zu hören — und zwischen zwei Fragen stimmt Ihr Zähler nicht.

Mit einem Webhook drehen Sie das um. Sie geben uns eine Adresse auf Ihrer eigenen Website, und sobald etwas geschieht, schicken wir dorthin eine kurze Nachricht. Eine Nachricht, im Moment selbst.

Daher der Name: ein hook ist ein Haken, an den wir etwas hängen, sobald es so weit ist.

Was Sie damit machen können

• den Zähler auf Ihrer Website weiterspringen lassen, sobald verkauft wurde;
• eine Nachricht in Ihrem Teamchat bei jeder Bestellung über einem Betrag;
• Ihre Mitgliederliste aktualisieren, wenn jemand eine Jahreskarte kauft;
• sich selbst eine E-Mail schicken, wenn eine Bestellung storniert wird;
• Ihrer Kasse oder Buchhaltung sofort mitteilen, dass Geld eingegangen ist.

Was Sie brauchen

Drei Dinge, und Ihr Webbauer kennt alle drei:

1. Eine Adresse auf Ihrer eigenen Website, die Nachrichten annehmen kann. Das ist eine gewöhnliche Seite, die niemand besucht; sie ist nur da, um unsere Nachricht anzunehmen. Sie muss mit https:// beginnen.
2. Eine Stelle, an der Sie diese Adresse eintragen. Das tun Sie selbst, unter Einstellungen → API-Zugang auf dem Reiter Webhooks — siehe Webhooks einrichten. Möchte Ihr Webbauer das lieber aus seinem eigenen Programm heraus erledigen, braucht er einen Schlüssel mit dem Recht Webhooks; siehe Einen API-Schlüssel anlegen.
3. Das Geheimnis, das zu dieser Adresse gehört. Sie bekommen es von uns, sobald die Adresse eingerichtet ist, und damit prüft Ihre Website nach, dass eine Nachricht wirklich von uns kommt.

Das Dritte ist wichtig. Ohne Prüfung des Geheimnisses kann jeder, der Ihre Adresse errät, Ihrer Website weismachen, dass etwas verkauft wurde. Mit der Prüfung nicht.

Wie das aussieht

Es kommt eine kurze Nachricht an, die sagt, was geschehen ist und worüber. Ihre Website schaut auf das Geheimnis, sieht, dass es stimmt, und macht dann etwas damit: einen Zähler erhöhen, eine Zeile schreiben, eine E-Mail senden.

Was genau in so einer Nachricht steht und wie Sie die Prüfung des Geheimnisses programmieren, steht im Entwicklerportal — das ist die Seite, die Sie an denjenigen weiterleiten, der es baut.

Drei Dinge, die oft schiefgehen

Antworten Sie schnell. Unsere Nachricht wartet höchstens zehn Sekunden auf eine Antwort, nicht bis Ihre Website mit all ihrer Arbeit fertig ist. Nehmen Sie die Nachricht an, bestätigen Sie den Eingang, und erledigen Sie die Arbeit danach.

Rechnen Sie mit Wiederholungen. War Ihre Website kurz nicht erreichbar, versuchen wir es erneut — bis zu sechsmal, verteilt über gut anderthalb Tage. Dieselbe Nachricht kann also zweimal ankommen. Sorgen Sie dafür, dass Ihre Website das verträgt — dieselbe Nachricht zweimal darf nicht zweimal dieselbe E-Mail ergeben.

Halten Sie das Geheimnis geheim. Es gehört in die Einstellungen Ihres Servers, nicht in Code, der auf Ihrer öffentlichen Website landet.

Müssen Sie das haben?

Nein. Ein Webhook ist nützlich, wenn etwas sofort geschehen muss. Reicht eine tägliche Übersicht, brauchen Sie keinen — dann genügt es, die Zahlen einmal am Tag abzuholen.

Webhooks gehören zum selben Tarif wie der Rest der API. Was in welchem Tarif enthalten ist, steht auf der Preisseite von Passavo.

Weiterlesen

• Webhooks einrichten — der Bildschirm selbst: eine Adresse hinzufügen, eine Testnachricht senden, das Nachrichtenprotokoll lesen.
• Was ist eine API, und brauche ich das?
• Einen API-Schlüssel anlegen
• Das Entwicklerportal — für den, der die Anbindung baut.