API & Integrations

14. API & Integrations

Η ενότητα API & Integrations περιέχει εργαλεία προγραμματιστικής ενσωμάτωσης του 7stamp με εξωτερικά συστήματα — CRM, POS, ERP, analytics, messenger bots.

API Keys

Η κύρια σελίδα είναι ο κατάλογος κλειδιών API. Στήλες:

• Name — όνομα κλειδιού (συνήθως ταιριάζει με συνδεδεμένο Staff).
• Login — Staff login στο οποίο δένεται το κλειδί.
• API Key — το ίδιο το κλειδί (ξεκινά με 7loc_sc_..., κρυφό εξ ορισμού, αντιγραφή με ένα κλικ).
• Status — Active.
• 🔄 — αναδημιουργία κλειδιού.
• 🗑️ — διαγραφή κλειδιού.

Δημιουργία API key

Πατήστε + ADD API KEY — ανοίγει Generate API Key:

• Scanner — dropdown επιλογής Staff Login στο οποίο δεσμεύεται το κλειδί (ένα Staff = ένα κλειδί).
• Κουμπιά CANCEL / GENERATE.

Μετά το GENERATE το κλειδί εμφανίζεται στη λίστα. Αντιγράψτε το αμέσως — το πλήρες κλειδί μπορεί να μην ξαναεμφανιστεί.

Τι μπορείτε μέσω API

• Εκδόστε κάρτα σε πελάτη με email/τηλέφωνο.
• Προσθέστε Stamp σε συγκεκριμένο πελάτη.
• Εκδώστε voucher (από πρότυπο ή custom, με Redeem Code).
• Εξαργυρώστε voucher (αν δουλεύετε μέσω δικού σας POS).
• Διαβάστε κατάσταση κάρτας, πρόοδο, ιστορικό.
• Εγγραφείτε σε Webhooks για γεγονότα σε πραγματικό χρόνο.

Webhooks

Τα Webhooks στέλνουν γεγονότα κάρτας σε εξωτερικό σύστημα. Υποστηριζόμενα:

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (με αποτέλεσμα).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Παράδειγμα φορτίου Webhook

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Έτοιμες ενσωματώσεις POS

• Poster — έτοιμη ενσωμάτωση, σύνδεση σε λίγα κλικ.
• Serve — έτοιμη ενσωμάτωση.
• Άλλα ταμεία — κατόπιν αιτήματος. Δωρεάν αν είναι τεχνικά εφικτό (δηλαδή αν το ταμείο παρέχει ανοιχτό API ή Webhooks).

Εκπομπές messenger μέσω 7loc.com

Για εκπομπές WhatsApp, Telegram, Viber συνδέεται η ενσωμάτωση 7loc.com. Όταν είναι ενεργή, το κανάλι «messengers» εμφανίζεται στις Campaigns δίπλα στο PUSH και Email.

Σενάρια χωρίς κώδικα: Zapier και Make

Το API 7stamp + Webhooks δουλεύουν με Zapier και Make (Integromat):

• «Όταν voucher_redeemed — πρόσθεσε tag στο Mailchimp».
• «Όταν goal_reached — ειδοποίηση στο Slack».
• «Όταν birthday_reached — δημιούργησε task στο CRM».

---