Οδηγός webhook για Zapier και Make

1. Τι χρειάζεστε

Έναν λογαριασμό QR Wait του οποίου είστε ιδιοκτήτης (οι διαχειριστές και οι υπάλληλοι δεν βλέπουν τις ενσωματώσεις), έναν λογαριασμό Zapier ή Make και την οθόνη Ενσωματώσεις της σελίδας διαχείρισης ανοιχτή σε άλλη καρτέλα.

2. Zapier

1. Στο Zapier, δημιουργήστε ένα Zap με Webhooks by Zapier ως trigger και Catch Hook ως συμβάν του. Αντιγράψτε το webhook URL που εμφανίζει το Zapier.
2. Στο QR Wait, στις Ενσωματώσεις, επικολλήστε το στο πεδίο Διεύθυνση endpoint (https), επιλέξτε τα συμβάντα που θέλετε και πατήστε Προσθήκη webhook. Φυλάξτε το μυστικό υπογραφής που εμφανίζεται μόνο μία φορά.
3. Μπείτε μία φορά στην ουρά σας από ένα κινητό ή προσθέστε κάποιον στο πάνελ υπαλλήλου, ώστε να φτάσει ένα πραγματικό συμβάν ticket.joined. Η Αποστολή δοκιμαστικού συμβάντος στέλνει μόνο ένα ping χωρίς πεδία αριθμού: δείχνει ότι η διεύθυνση απαντά.
4. Πίσω στο Zapier, δοκιμάστε το trigger και επιλέξτε αυτό το συμβάν. Προσθέστε μια ενέργεια, για παράδειγμα Google Sheets › Create Spreadsheet Row, και αντιστοιχίστε τα πεδία: type, queue.name, ticket.no, ticket.size, ticket.joined_at.
5. Δημοσιεύστε το Zap. Από εδώ και πέρα κάθε συμβάν προσθέτει μια γραμμή.

3. Make

1. Στο Make, δημιουργήστε ένα σενάριο του οποίου η πρώτη μονάδα είναι Webhooks › Custom webhook. Προσθέστε ένα webhook και αντιγράψτε τη διεύθυνσή του.
2. Επικολλήστε τη στις Ενσωματώσεις του QR Wait όπως παραπάνω και πατήστε Προσθήκη webhook.
3. Το Make περιμένει να μάθει τη δομή των δεδομένων: μπείτε μία φορά στην ουρά σας ή προσθέστε κάποιον στο πάνελ υπαλλήλου.
4. Προσθέστε την επόμενη μονάδα, για παράδειγμα Google Sheets › Add a Row ή ένα μήνυμα στη συνομιλία σας, αντιστοιχίστε τα πεδία και ενεργοποιήστε το σενάριο.

4. Τι φτάνει

Κάθε συμβάν είναι ένα σώμα JSON όπως το παρακάτω. Επιλέξτε στο QR Wait μόνο τα συμβάντα που χρειάζεστε ή φιλτράρετε με βάση το type στο Zapier ή στο Make.

{
  "id": "d_3f9a1c0b7e2d4a61",
  "type": "ticket.joined",
  "created": "2026-10-10T09:12:30.010Z",
  "account": "antalyabb",
  "queue": { "id": "a1b2c3d4e5", "name": "Konyaaltı Beach", "slug": "konyaalti" },
  "ticket": { "no": 42, "size": 2, "source": "qr", "joined_at": "2026-10-10T09:12:30.004Z" }
}

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

Μια αποστολή που αποτυγχάνει επαναλαμβάνεται για περίπου 9 ώρες με το ίδιο id. Ελέγξτε το πριν προσθέσετε μια γραμμή (με ένα βήμα αναζήτησης), αν ένα διπλότυπο θα σας δημιουργούσε πρόβλημα.

5. Και αντίστροφα: προσθήκη ατόμων από το Zapier ή το Make

Για να επιτρέψετε σε ένα άλλο εργαλείο να βάζει άτομα σε μια ουρά (μια φόρμα ιστότοπου, ένα εργαλείο κρατήσεων), δημιουργήστε ένα κλειδί στα Κλειδιά API με πρόσβαση Ανάγνωση και εγγραφή και στείλτε ένα αίτημα από το Webhooks by Zapier › POST ή από το HTTP › Make a request του Make:

POST https://qrwait.app/api/v1/queues/<queue id>/tickets
Authorization: Bearer qrw_…
Content-Type: application/json

{ "size": 2, "note": "Website" }

Η απάντηση είναι ο νέος αριθμός, για παράδειγμα { "no": 43 }. Τα id των ουρών προκύπτουν από το GET /api/v1/queues. Η κλήση της επόμενης ομάδας, η σήμανση κάποιου ως εξυπηρετημένου και όλα τα πεδία περιγράφονται στην τεκμηρίωση API (στα αγγλικά).

6. Ασφαλής χρήση

• Η διεύθυνση που σας δίνει το Zapier ή το Make αρκεί για να στείλει κανείς δεδομένα στο Zap ή στο σενάριό σας: μην την κοινοποιείτε.
• Το Zapier και το Make δεν ελέγχουν από μόνα τους την υπογραφή του QR Wait. Αν η πλευρά που λαμβάνει πρέπει να είναι βέβαιη ότι ένα συμβάν προήλθε από το QR Wait, επαληθεύστε την κεφαλίδα X-QRWait-Signature όπως δείχνει η τεκμηρίωση API, για παράδειγμα σε ένα βήμα κώδικα.
• Δώστε σε ένα κλειδί μόνο την πρόσβαση που χρειάζεται και ανακαλέστε το στην οθόνη Ενσωματώσεις μόλις δεν χρησιμοποιείται πια· η οθόνη δείχνει πότε χρησιμοποιήθηκε τελευταία φορά κάθε κλειδί.