Zapier

Το Zapier συνδέεται στο Quire μέσω του ίδιου REST API, πελατών OAuth και webhooks που χρησιμοποιεί κάθε ενσωμάτωση. Δεν υπάρχει ειδικός κώδικας Quire σε καμία πλευρά, επομένως ένα Zap μπορεί να κάνει ό,τι προσφέρει η αναφορά API.

Εκκίνηση Zap όταν συμβαίνει κάτι στο Quire

1. Στο Zapier επιλέξτε ως ενεργοποιητή το Webhooks by Zapier με συμβάν Catch Raw Hook. Επιλέξτε Raw, επειδή η υπογραφή υπολογίζεται πάνω στα ακριβή byte που έστειλε το Quire. Αντιγράψτε τη διεύθυνση που σας δίνει το Zapier.
2. Στο Quire ανοίξτε το /admin/webhooks, επιλέξτε Προσθήκη συνδρομής, επικολλήστε τη διεύθυνση και επιλέξτε συμβάντα, για παράδειγμα course_completion.changed. Το Quire στέλνει πρώτα ένα δοκιμαστικό συμβάν· η συνδρομή ξεκινά όταν το λάβει το Zapier.
3. Προσθέστε ένα βήμα Code by Zapier που επαληθεύει την υπογραφή με το μυστικό της συνδρομής, όπως περιγράφεται στον οδηγό προγραμματιστή. Διακόψτε το Zap όταν η επαλήθευση αποτύχει.
4. Αναλύστε το σώμα και συνεχίστε με τα βήματα που χρειάζεστε.

Εκτέλεση ενεργειών στο Quire από Zap

Χρησιμοποιήστε το Webhooks by Zapier με την ενέργεια Custom Request ή το API Request σε ένα βήμα εφαρμογής:

• URL: https://acme.quirelms.com/api/v1/..., για παράδειγμα /api/v1/enrolments για να εγγράψετε κάποιον.
• Headers: Authorization: Bearer qk_live_... με κλειδί που δημιουργήθηκε στο /admin/integrations/api-keys μόνο για αυτό το Zap, και ένα Idempotency-Key που βασίζεται στο αναγνωριστικό του ενεργοποιητή. Έτσι, αν το Zapier επαναλάβει το Zap, το ίδιο άτομο δεν εγγράφεται δύο φορές.
• Data: JSON, όπως περιγράφεται στην αναφορά API.

Για να ενεργείτε ως συγκεκριμένο άτομο και όχι ως οργανισμός, καταχωρίστε πελάτη OAuth στο /admin/integrations/oauth-clients με τη διεύθυνση ανακατεύθυνσης του Zapier και χρησιμοποιήστε τον σε ιδιωτική ενσωμάτωση Zapier.

Παράδειγμα: εγγραφή πελάτη όταν κλείνει συμφωνία

1. Ενεργοποιητής: το CRM σας σημειώνει «κερδισμένη συμφωνία».
2. Custom request PUT /api/v1/users/ext:{customer id} με το όνομα και το email του ατόμου: δημιουργεί τον χρήστη ή τον ενημερώνει αν υπάρχει ήδη.
3. Custom request POST /api/v1/enrolments με τον χρήστη και το μάθημα, και Idempotency-Key: deal-{deal id}.