Μια Πρώτη Ματιά στα Webhooks (v2)

ΠΡΟΣΟΧΗ: Σημειώστε ότι αυτή η λειτουργία ή το άρθρο απευθύνεται σε προχωρημένους χρήστες.

Ένα webhook είναι ένας τρόπος για μια εφαρμογή ή λογισμικό όπως το Ultimate Multisite να παρέχει σε άλλες εφαρμογές πληροφορίες σε πραγματικό χρόνο. Ένα webhook παραδίδει δεδομένα ή payloads σε άλλες εφαρμογές τη στιγμή που συμβαίνουν, που σημαίνει ότι λαμβάνετε τα δεδομένα αμέσως.

Αυτό είναι χρήσιμο αν χρειάζεται να ενσωματώσετε ή να μεταφέρετε συγκεκριμένα δεδομένα από το Ultimate Multisite σε κάποιο άλλο CRM ή σύστημα κάθε φορά που ενεργοποιείται ένα συμβάν. Για παράδειγμα, χρειάζεται να στείλετε το όνομα και τη διεύθυνση email του χρήστη σε μια λίστα αλληλογραφίας κάθε φορά που δημιουργείται ένας νέος λογαριασμός χρήστη.

Πώς να δημιουργήσετε ένα webhook

Για να δημιουργήσετε ένα webhook, μεταβείτε στον πίνακα διαχείρισης του δικτύου σας. Κάντε κλικ στο Ultimate Multisite > Webhooks > Add New Webhook.

Κατά τη δημιουργία ενός νέου webhook θα σας ζητηθούν πληροφορίες όπως Name, URL, και Event. Μπορείτε να χρησιμοποιήσετε οποιοδήποτε όνομα θέλετε για το webhook σας. Τα πιο σημαντικά πεδία είναι το URL και το Event.

Το URL είναι το endpoint ή ο προορισμός στον οποίο το Ultimate Multisite θα στείλει το payload ή τα δεδομένα. Αυτή είναι η εφαρμογή που θα λάβει τα δεδομένα.

Το Zapier είναι η πιο συνηθισμένη λύση που χρησιμοποιούν οι χρήστες για να διευκολύνουν την ενσωμάτωση με εφαρμογές τρίτων. Χωρίς μια πλατφόρμα όπως το Zapier, θα χρειαστεί να δημιουργήσετε χειροκίνητα μια προσαρμοσμένη συνάρτηση που θα λαμβάνει τα δεδομένα και θα τα επεξεργάζεται. Δείτε αυτό το άρθρο για το πώς να χρησιμοποιήσετε το webhook του Ultimate Multisite με το Zapier.

Σε αυτό το άρθρο, θα εξετάσουμε τη βασική έννοια του πώς λειτουργεί ένα webhook και τα διαθέσιμα συμβάντα στο Ultimate Multisite. Θα χρησιμοποιήσουμε έναν ιστότοπο τρίτου μέρους που ονομάζεται requestbin.com. Αυτός ο ιστότοπος θα μας επιτρέψει να δημιουργήσουμε ένα endpoint και να λάβουμε το payload χωρίς να γράψουμε κώδικα. Αποποίηση ευθύνης: το μόνο που θα κάνει είναι να μας δείξει ότι τα δεδομένα έχουν ληφθεί. Δεν θα γίνει καμία επεξεργασία ή οποιαδήποτε ενέργεια στο payload.

Μεταβείτε στο requestbin.com και κάντε κλικ στο Create Request Bin.

Αφού κάνετε κλικ σε αυτό το κουμπί, θα σας ζητηθεί να συνδεθείτε αν έχετε ήδη λογαριασμό ή να εγγραφείτε. Αν έχετε ήδη λογαριασμό, θα σας οδηγήσει απευθείας στον πίνακα ελέγχου τους. Στον πίνακα ελέγχου τους, θα δείτε αμέσως το endpoint ή το URL που μπορείτε να χρησιμοποιήσετε για τη δημιουργία του webhook σας στο Ultimate Multisite.

Προχωρήστε και αντιγράψτε το URL και επιστρέψτε στο Ultimate Multisite. Τοποθετήστε το endpoint στο πεδίο URL και επιλέξτε ένα συμβάν από το αναπτυσσόμενο μενού. Σε αυτό το παράδειγμα, θα επιλέξουμε Payment Received.

Αυτό το συμβάν ενεργοποιείται κάθε φορά που ένας χρήστης πραγματοποιεί μια πληρωμή. Όλα τα διαθέσιμα συμβάντα, η περιγραφή τους και τα payloads παρατίθενται στο κάτω μέρος της σελίδας. Κάντε κλικ στο κουμπί Add New Webhook για να αποθηκεύσετε το webhook.

Τώρα μπορούμε να στείλουμε ένα δοκιμαστικό συμβάν στο endpoint για να δούμε αν το webhook που δημιουργήσαμε λειτουργεί. Μπορούμε να το κάνουμε αυτό κάνοντας κλικ στο Send Test Event κάτω από το webhook που δημιουργήσαμε.

Αυτό εμφανίζει ένα παράθυρο επιβεβαίωσης που λέει ότι η δοκιμή ήταν επιτυχής.

Τώρα αν επιστρέψουμε στον ιστότοπο Requestbin θα δούμε ότι το payload έχει ληφθεί και περιέχει κάποια δοκιμαστικά δεδομένα.

Αυτή είναι η βασική αρχή του πώς λειτουργούν τα webhooks και τα endpoints. Αν πρόκειται να δημιουργήσετε ένα προσαρμοσμένο endpoint, θα χρειαστεί να δημιουργήσετε μια προσαρμοσμένη συνάρτηση για να επεξεργαστείτε τα δεδομένα που λαμβάνετε από το Ultimate Multisite.