API & Integrazioni

14. API & Integrazioni

La sezione API & Integrazioni contiene strumenti per l’integrazione programmatica di 7stamp con i tuoi sistemi esterni — CRM, POS, ERP, analisi, bot di messaggistica.

Chiavi API

La pagina principale della sezione è l’elenco delle chiavi API. Colonne:

• Nome — nome della chiave (di solito corrisponde al nome Staff collegato).
• Login — il login Staff a cui la chiave è legata.
• Chiave API — la chiave stessa (inizia con 7loc_sc_..., nascosta per impostazione predefinita, copiabile con un clic).
• Stato — Attivo.
• 🔄 — rigenera la chiave.
• 🗑️ — elimina la chiave.

Creare una chiave API

Tocca + AGGIUNGI CHIAVE API — si apre il popup Genera Chiave API:

• Scanner — menu a tendina per selezionare il Login Staff a cui la chiave sarà associata (uno Staff può avere una chiave).
• Pulsanti ANNULLA / GENERA.

Dopo GENERA la chiave viene creata e appare nell’elenco. Copiala immediatamente — la chiave completa potrebbe non essere mostrata di nuovo.

Cosa puoi fare tramite API

• Emettere una carta a un cliente tramite email/telefono.
• Aggiungere uno stamp a un cliente specifico.
• Emettere un voucher (da template o personalizzato, con Redeem Code).
• Riscattare un voucher (se lavori tramite il tuo POS).
• Leggere lo stato della carta, il progresso, la cronologia.
• Iscriverti ai Webhook per ricevere eventi in tempo reale.

Webhook

I Webhook inviano gli eventi della carta a un sistema esterno. Supportati (vedi il glossario degli eventi):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (con il risultato).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Esempio di payload 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"
  }
}

Integrazioni POS già pronte

• Poster — integrazione già pronta, si connette in pochi clic.
• Serve — integrazione già pronta.
• Altri registratori di cassa — realizzate su richiesta. Gratuite se tecnicamente fattibili (cioè, il tuo registratore espone un’API aperta o Webhook).

Broadcast via messaggistica tramite 7loc.com

Per i broadcast su WhatsApp, Telegram, Viber, si connette l’integrazione 7loc.com. Una volta attiva, il canale “messaggistica” diventa disponibile nelle Campagne accanto a PUSH ed Email.

Scenari no-code: Zapier e Make

API 7stamp + Webhook funzionano con Zapier e Make (Integromat), permettendoti di costruire scenari senza codice:

• “Quando voucher_redeemed — aggiungi un tag in Mailchimp”.
• “Quando goal_reached — invia una notifica su Slack”.
• “Quando birthday_reached — crea un’attività nel CRM”.

---