Πώς να ρυθμίσετε τα webhooks

Τα webhooks στέλνουν επιλεγμένα συμβάντα του TicketingHub σε άλλο σύστημα τη στιγμή που συμβαίνουν.

Πριν ξεκινήσετε

• Τα webhooks πρέπει να είναι ενεργοποιημένα για τον λογαριασμό σας στο TicketingHub. Επικοινωνήστε με το TicketingHub αν δεν εμφανίζεται η ενότητα Webhooks.
• Χρειάζεστε πρόσβαση διαχειριστή ή υπευθύνου.
• Το σύστημα που λαμβάνει τα δεδομένα πρέπει να παρέχει μια δημόσια διεύθυνση URL HTTPS.

Προσθήκη webhook

1. Μεταβείτε στις Ρυθμίσεις → Για προχωρημένους.
2. Εντοπίστε την επιλογή Webhooks και επιλέξτε Επεξεργασία.
3. Επιλέξτε Νέο webhook.
4. Εισαγάγετε τη διεύθυνση URL HTTPS στην οποία θα αποστέλλονται τα συμβάντα.
5. Επιλέξτε τους τύπους συμβάντων που θέλετε να αποστέλλονται, όπως μια επιβεβαιωμένη ή ακυρωμένη κράτηση.
6. Προαιρετικά, εισαγάγετε ένα ισχυρό μυστικό, ώστε το σύστημα που λαμβάνει τα δεδομένα να μπορεί να επαληθεύει κάθε αίτημα.
7. Δημιουργήστε το webhook και, στη συνέχεια, εκτελέστε ένα από τα επιλεγμένα συμβάντα για να το δοκιμάσετε.

Αν προσθέσετε ένα μυστικό, το TicketingHub υπογράφει κάθε αίτημα και στέλνει την υπογραφή στην κεφαλίδα X-TicketingHub-Signature-256. Ο προγραμματιστής σας θα πρέπει να επαληθεύει αυτήν την υπογραφή πριν αποδεχτεί τα δεδομένα.

Διατήρηση του webhook ενεργού

Το σύστημα που λαμβάνει τα δεδομένα θα πρέπει να απαντά εγκαίρως με επιτυχή κατάσταση 2xx. Το TicketingHub επαναλαμβάνει την αποστολή όσων παραδόσεων λήγουν λόγω χρονικού ορίου ή επιστρέφουν ανεπιτυχή απάντηση. Ένα endpoint που εξακολουθεί να αποτυγχάνει απενεργοποιείται αυτόματα. Διορθώστε το σύστημα που λαμβάνει τα δεδομένα και, στη συνέχεια, επιστρέψτε στη σελίδα Webhooks για να το ενεργοποιήσετε ξανά.

Το TicketingHub στέλνει συμβάντα μόνο σε δημόσιες διευθύνσεις. Αν η διεύθυνση URL παραπέμπει σε διεύθυνση ιδιωτικού δικτύου, όπως σε έναν διακομιστή μέσα στο δικό σας δίκτυο, το TicketingHub δεν στέλνει το συμβάν και απενεργοποιεί αμέσως το webhook. Η σελίδα Webhooks εμφανίζει το μήνυμα “Η διεύθυνση URL παραπέμπει σε διεύθυνση ιδιωτικού δικτύου” και οι διαχειριστές του λογαριασμού σας λαμβάνουν email. Αλλάξτε τη διεύθυνση URL σε μια δημόσια διεύθυνση HTTPS και, στη συνέχεια, ενεργοποιήστε ξανά το webhook.

Επιλέξτε μόνο τα συμβάντα που χρειάζεστε και αποφύγετε τη χρήση URL δοκιμών σε ενεργό λογαριασμό. Για να στέλνετε συμβάντα στο Zapier χωρίς να δημιουργήσετε δικό σας σύστημα λήψης, δείτε το άρθρο Πώς να συνδέσετε το TicketingHub με το Zapier. Για να δημιουργήσετε μια ενσωμάτωση που ζητά επίσης δεδομένα από το TicketingHub, δείτε το άρθρο Πώς να δημιουργήσετε και να χρησιμοποιήσετε ένα διακριτικό API.