☰ Μενού · Κρατήσεις και CRM
Οδηγοί

Κρατήσεις και CRM

Κομμωτήρια, κλινικές, στούντιο και άλλες επιχειρήσεις που δουλεύουν με ραντεβού: επιβραβεύστε την επίσκεψη όταν ο πελάτης ήρθε πραγματικά.

Σε ένα σύστημα κρατήσεων η κρίσιμη στιγμή είναι όταν ένα ραντεβού σημειώνεται ως πραγματοποιημένο, μαζί με το ποσό που πλήρωσε ο πελάτης. Αντιστοιχίστε το στο API ως εξής:

Στο σύστημα κρατήσεωνΚλήση
Νέος πελάτης με τηλέφωνοPOST /v1/members (επιστρέφει το υπάρχον μέλος αν το τηλέφωνο είναι γνωστό)
Το ραντεβού πραγματοποιήθηκε και πληρώθηκεPOST /v1/transactions με το id του ραντεβού ως external_id και το ποσό που πληρώθηκε
Πραγματοποιήθηκε, χωρίς στοιχεία πληρωμήςPOST /v1/visits με το id του ραντεβού ως external_id (προγράμματα σφραγίδων και επισκέψεων)
Η πληρωμή ακυρώθηκε ή επιστράφηκεPOST /v1/transactions/{external_id}/void
Ο πελάτης θέλει να πληρώσει με cashbackΔιαβάστε το cashback.balance και στείλτε την απόδειξη με redeem_amount

Χρησιμοποιήστε ως external_id το id του ραντεβού (όχι του πελάτη): έτσι το ίδιο ραντεβού, αν σημειωθεί δύο φορές ως πραγματοποιημένο, επιβραβεύεται μία φορά.

Altegio

Οι επιχειρήσεις που χρησιμοποιούν Altegio δεν χρειάζονται κώδικα: εγκαταστήστε την εφαρμογή Loyaltyfy από το marketplace του Altegio και συνδέστε τα καταστήματα. Ο τρόπος που λειτουργεί αυτή η σύνδεση είναι καλό πρότυπο για τη δική σας:

  • Ακούει τα webhooks εγγραφών του Altegio. Μια εγγραφή με επιβεβαιωμένη προσέλευση καταχωρίζεται ως απόδειξη, με το id της εγγραφής ως κλειδί idempotency.
  • Αν ο πελάτης δεν έχει ακόμη κάρτα Loyaltyfy, η επίσκεψη μένει σε αναμονή. Όταν ο πελάτης προσθέσει την κάρτα (με το ίδιο τηλέφωνο), οι επισκέψεις σε αναμονή καταχωρίζονται, οπότε τίποτα δεν χάνεται.
  • Κάθε 15 λεπτά ελέγχει επίσης τις πρόσφατες εγγραφές, επειδή τα webhooks μπορεί να χαθούν· τα διπλότυπα αγνοούνται με βάση το id της εγγραφής.
  • Όταν ο ταμίας εξαργυρώνει cashback στο Loyaltyfy, το ποσό μπορεί να καταγραφεί πίσω στην ανοιχτή επίσκεψη του Altegio ως πληρωμή επιβράβευσης, εφόσον το δίκτυο έχει ρυθμίσει τύπο κάρτας επιβράβευσης.

Άλλα συστήματα

Αν το σύστημα κρατήσεων ή το CRM σας στέλνει webhooks, η απλούστερη σύνδεση είναι μια μικρή υπηρεσία που τα λαμβάνει και καλεί τα endpoints του παραπάνω πίνακα. Αν δεν στέλνει, ελέγχετε κάθε λίγα λεπτά το API του για ραντεβού που πραγματοποιήθηκαν και στείλτε τα με τα id τους· οι επαναλήψεις δεν προκαλούν πρόβλημα. Γράψτε στο api@loyaltyfy.io αν θέλετε να φτιάξουμε έτοιμη σύνδεση για την πλατφόρμα σας.

Ερωτήσεις για μια σύνδεση: api@loyaltyfy.io. Απαντάμε μέσα σε μία εργάσιμη ημέρα.