Webhooks einrichten

Webhooks senden ausgewählte TicketingHub-Ereignisse, sobald sie eintreten, an ein anderes System.

Bevor Sie beginnen

• Webhooks müssen für Ihr TicketingHub-Konto aktiviert sein. Wenden Sie sich an TicketingHub, wenn der Bereich „Webhooks“ fehlt.
• Sie benötigen Administrator- oder Managerzugriff.
• Das empfangende System muss eine öffentliche HTTPS-URL bereitstellen.

Einen Webhook hinzufügen

1. Gehen Sie zu Einstellungen → Erweitert.
2. Suchen Sie nach Webhooks und wählen Sie Bearbeiten aus.
3. Wählen Sie Neuer Webhook aus.
4. Geben Sie die HTTPS-URL ein, an die die Ereignisse gesendet werden.
5. Wählen Sie die zu sendenden Ereignistypen aus, zum Beispiel eine bestätigte oder stornierte Buchung.
6. Optional: Geben Sie ein sicheres Geheimnis ein, damit das empfangende System jede Anfrage überprüfen kann.
7. Erstellen Sie den Webhook und führen Sie anschließend eines der ausgewählten Ereignisse aus, um ihn zu testen.

Wenn Sie ein Geheimnis hinzufügen, signiert TicketingHub jede Anfrage und sendet die Signatur im Header X-TicketingHub-Signature-256. Ihr Entwickler sollte diese Signatur überprüfen, bevor die Daten akzeptiert werden.

Den Webhook aktiv halten

Das empfangende System sollte zügig mit einem erfolgreichen 2xx-Status antworten. TicketingHub versucht Zustellungen erneut, wenn eine Zeitüberschreitung auftritt oder eine nicht erfolgreiche Antwort zurückgegeben wird. Ein Endpunkt, bei dem weiterhin Fehler auftreten, wird automatisch deaktiviert. Beheben Sie das Problem im empfangenden System und aktivieren Sie den Endpunkt anschließend auf der Seite „Webhooks“ wieder.

TicketingHub sendet Ereignisse nur an öffentliche Adressen. Wenn die URL auf eine private Netzwerkadresse verweist, beispielsweise auf einen Server in Ihrem eigenen Netzwerk, sendet TicketingHub das Ereignis nicht und deaktiviert den Webhook sofort. Auf der Seite „Webhooks“ wird „Die URL verweist auf eine private Netzwerkadresse“ angezeigt, und die Administratoren Ihres Kontos erhalten eine E-Mail. Ändern Sie die URL in eine öffentliche HTTPS-Adresse und aktivieren Sie den Webhook anschließend wieder.

Wählen Sie nur die Ereignisse aus, die Sie benötigen, und vermeiden Sie die Verwendung einer Test-URL in einem Produktivkonto. Informationen zum Senden von Ereignissen an Zapier, ohne einen eigenen Empfänger zu erstellen, finden Sie unter TicketingHub mit Zapier verbinden. Informationen zum Erstellen einer Integration, die zusätzlich Daten von TicketingHub abruft, finden Sie unter Ein API-Token erstellen und verwenden.