Προγραμματιστές

Webhooks

Κάθε ειδοποίηση που παράγει ο λογαριασμός σας μπορεί να σταλεί απευθείας στα δικά σας συστήματα ως υπογεγραμμένο JSON POST — έτσι, ό,τι συμβαίνει στη φιλοξενία σας μπορεί να ξεκινήσει μια ροή εργασιών οπουδήποτε αλλού.

Όλα τα έγγραφα προγραμματιστών →

Με τι μπορείτε να το συνδέσετε

Ένα webhook είναι ένα συνηθισμένο αίτημα HTTPS, επομένως οτιδήποτε μπορεί να το λάβει μπορεί να ενεργήσει βάσει αυτού. Δεν χρειάζεστε εμάς για να δημιουργήσουμε μια ενοποίηση για το εργαλείο σας.

Πλατφόρμες αυτοματισμού

Κατευθύνετε ένα webhook σε μια ροή εργασίας στο n8n, Make, Zapier, Pipedream, Activepieces και κάθε συμβάν μετατρέπεται σε έναυσμα — δημοσιεύστε σε ένα κανάλι, ανοίξτε ένα δελτίο, ενημερώστε ένα υπολογιστικό φύλλο, καλέστε ένα άλλο API. Οι αυτοφιλοξενούμενες πλατφόρμες λειτουργούν με τον ίδιο ακριβώς τρόπο, εφόσον το τελικό σημείο είναι προσβάσιμο μέσω HTTPS.

CRM και γραφεία υποστήριξης

Στείλτε συμβάντα χρέωσης και λογαριασμού στο HubSpot, Pipedrive, Salesforce ή σε οποιοδήποτε helpdesk ή CRM με εισερχόμενο webhook, ώστε το ιστορικό του πελάτη να αντικατοπτρίζει τις ενέργειες της φιλοξενίας του χωρίς να χρειάζεται κάποιος να τις αντιγράφει χειροκίνητα.

Οτιδήποτε άλλο ακούει

Slack, Discord, Google Sheets, Airtable, Notion, η δική σας παρακολούθηση, μια αποθήκη δεδομένων ή ένα μικρό σενάριο που γράψατε. Εάν μπορεί να δεχτεί HTTPS POST και να διαβάσει JSON, μπορεί να λάβει αυτά.

Τι αποστέλλεται

Επιλέγετε ποιες κατηγορίες πηγαίνουν σε ποιον προορισμό — και μπορείτε να συνδέσετε περισσότερους, ώστε η τιμολόγηση να πηγαίνει σε ένα μέρος και οι ειδοποιήσεις ιστοτόπου σε άλλο. Όλα είναι ενεργοποιημένα από προεπιλογή.

Χρέωση και πληρωμές

Εκδοθέντα και εξοφλημένα τιμολόγια, αποτυχημένες πληρωμές, κάρτες που πρόκειται να λήξουν, ανανεώσεις και ακυρώσεις.

Ιστότοποι και ασφάλεια

Η παροχή ολοκληρώθηκε, ένας ιστότοπος ανεστάλη, βρέθηκε κακόβουλο λογισμικό, αντίγραφα ασφαλείας και αλλαγές πιστοποιητικών.

Υποστήριξη και τομείς

Ανοιχτά και κλιμακωμένα αιτήματα υποστήριξης, μεταφορές τομέων, ανανεώσεις και αλλαγές DNS.

Επαλήθευση ότι ένα αίτημα προήλθε από εμάς

Κάθε αίτημα υπογράφεται με ένα μυστικό που γνωρίζετε μόνο εσείς και εμείς. Ελέγξτε την υπογραφή πριν προβείτε σε ενέργειες βάσει του σώματος — αυτές οι κεφαλίδες φτάνουν με κάθε παράδοση:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: unique per delivery; the same on every retry of it
X-Zinn-Event: invoice.paid

Η χρονική σήμανση υπογράφεται μαζί με το σώμα αντί να αποστέλλεται δίπλα σε αυτό, έτσι ώστε ένα αίτημα που έχει υποκλαπεί να μην μπορεί να αναπαραχθεί ξανά σε εσάς αργότερα. Απορρίψτε οτιδήποτε παλαιότερο από λίγα λεπτά.

Το X-Zinn-Delivery είναι μοναδικό για κάθε παράδοση: κάθε συμβάν και κάθε πάτημα της επιλογής «Δοκιμή» λαμβάνει το δικό του. Εάν το τελικό σημείο σας δεν απαντήσει με κατάσταση 2xx, στέλνουμε την ίδια παράδοση ξανά μετά από 1, 5, 25, 125 και 625 λεπτά, με το ίδιο X-Zinn-Delivery και νέα χρονική σήμανση και υπογραφή. Κρατήστε τα αναγνωριστικά που έχετε ήδη διαχειριστεί και αγνοήστε τις επαναλήψεις.

Ο πίνακας ελέγχου σας καταγράφει κάθε παράδοση κάτω από τον προορισμό της στην οθόνη «Ειδοποιήσεις» για 30 ημέρες: πότε στάλθηκε, πόσες προσπάθειες χρειάστηκαν και τι απάντησε το τελικό σημείο σας.

Το μυστικό υπογραφής σας εμφανίζεται μόνο μία φορά, όταν προσθέτετε το webhook. Δεν μπορούμε να το εμφανίσουμε ξανά — εάν το χάσετε, καταργήστε τον προορισμό και προσθέστε τον ξανά.

Ρύθμιση

  1. Στον πίνακα ελέγχου σας, ανοίξτε τις Ειδοποιήσεις και προσθέστε έναν προορισμό τύπου Webhook.
  2. Δώστε το τελικό σημείο HTTPS σας και αντιγράψτε το μυστικό υπογραφής που σας εμφανίζουμε.
  3. Πατήστε Test. Στέλνουμε ένα πραγματικό αίτημα με την ίδια μορφή όπως ένα ζωντανό, ώστε να μπορείτε να αναπτύξετε με βάση αυτό πριν συμβεί οτιδήποτε πραγματικό.
  4. Επιλέξτε ποιες κατηγορίες θα πρέπει να λαμβάνει αυτός ο προορισμός. Οι νέοι τύποι ειδοποιήσεων ενεργοποιούνται αυτόματα.

Μπορείτε να προσθέσετε όσους προορισμούς επιθυμείτε, να συνδυάσετε webhooks με email, Slack και Telegram και να ορίσετε ένα διαφορετικό σύνολο κατηγοριών για τον καθένα.

Προτιμάτε να μας καλέσετε;

Τα webhooks σας ενημερώνουν όταν έχει συμβεί κάτι. Το API είναι ο τρόπος για να κάνετε κάτι να συμβεί — κάθε λειτουργία που εκτελεί ο πίνακας ελέγχου είναι διαθέσιμη σε εσάς.

Περιηγηθείτε στην τεκμηρίωση API