IoT Device Setup

🤖 Spiega con IA

Questa guida copre la configurazione e la gestione delle integrazioni IoT per 4Geeks Perks, abilitando il tracciamento in tempo reale e il riscatto perks automatizzato attraverso dispositivi connessi.

Funzionalità Premium

Le integrazioni IoT sono disponibili esclusivamente sul piano Premium.

Panoramica¶

4Geeks Perks supporta vari dispositivi IoT per creare un’esperienza di riscatto perks fluida e senza contatto:

Distributrici Automatiche: Traccia il consumo di snack e bevande in tempo reale
Stazioni Caffè: Monitora l’utilizzo del caffè e automatizza gli avvisi di riapprovvigionamento
Mercati Self-Service: Retail non sorvegliato 24/7 con checkout automatizzato
Lettori RFID: Abilitano l’autenticazione basata su carta e il pagamento in tutti i punti IoT
Armadietti Intelligenti: Consegna sicura dei pacchi e ritiro dei perks

Dispositivi Supportati¶

Distributrici Automatiche¶

4Geeks Perks si integra con distributrici automatiche intelligenti che supportano:

Lettori di carte RFID
Sistemi di pagamento senza contatto
Tracciamento dell’inventario
Monitoraggio remoto
Dati di vendita in tempo reale

Marchi Compatibili: - Crane Merchandising Systems - Automatic Products International (API) - Seaga Manufacturing - TCN Vending - Soluzioni personalizzate (tramite API)

Stazioni Caffè¶

Sistemi intelligenti per caffè e bevande con:

Autenticazione RFID
Tracciamento dell’utilizzo
Analisi dei consumi
Monitoraggio automatico delle scorte
Metriche di qualità

Sistemi Compatibili: - Macchine professionali Jura - Sistemi caffè Franke - Caffè da distributore Necta - Macchine IoT personalizzate

Mercati Self-Service¶

Spazi retail non sorvegliati con:

Ingresso controllato da RFID
Scaffali intelligenti con sensori di peso
Visione artificiale per il riconoscimento prodotti
Checkout automatizzato
Gestione dell’inventario in tempo reale

Soluzioni Supportate: - Partner tecnologici Amazon Just Walk Out - Micro-mercati standard controllati da RFID - Configurazioni retail intelligenti personalizzate

Lettori RFID¶

Lettori RFID autonomi per il riscatto perks:

Lettori HID Global
Lettori AWID
Lettori multi-tecnologia (RFID + NFC)
Lettori desktop USB per uso amministrativo

Prerequisiti¶

Prima di configurare le integrazioni IoT:

Piano Premium: Assicurati che il tuo account abbia l’accesso Premium
Infrastruttura di Rete:
Connessione internet stabile nelle sedi dei dispositivi
Connettività Wi-Fi o Ethernet
Ampiezza di banda adeguata per la trasmissione dati in tempo reale
Alimentazione Elettrica: Connessione elettrica affidabile per tutti i dispositivi
Spazio Fisico: Posizione appropriata con sicurezza adeguata
Approvazione IT: Coordina con il tuo dipartimento IT per l’accesso alla rete

Configurare l’Integrazione con le Distributrici Automatiche¶

Passo 1: Preparazione del Dispositivo¶

Assicurati che la distributrice automatica abbia:
Modulo controller IoT installato
Connettività di rete configurata
Lettore RFID collegato (se non integrato)
Firmware aggiornato all’ultima versione
Testa la funzionalità base:
Erogazione prodotti
Elaborazione pagamenti
Comunicazione di rete
Lettura carte RFID

Passo 2: Registrare il Dispositivo in 4Geeks Perks¶

Accedi alla Console 4Geeks
Naviga a Perks > Dispositivi IoT > Aggiungi Dispositivo
Seleziona il tipo di dispositivo: Distributore Automatico
Compila i dettagli del dispositivo:
Nome del dispositivo: Nome descrittivo (es. “Edificio A - Distributore Piano 2”)
Posizione: Posizione fisica
Numero di serie: Serie del produttore
Indirizzo MAC: Identificatore di rete
Indirizzo IP: IP corrente (se statico)
Scegli il metodo di integrazione:
API Diretta: Per distributrici intelligenti con API nativa
Middleware: Per macchine che richiedono traduzione del protocollo
Sincronizzazione manuale: Per macchine base con connettività limitata
Clicca Registra

Passo 3: Configurare l’Integrazione¶

Dopo la registrazione, clicca Configura sul dispositivo
Imposta la connessione API:
Endpoint API: URL dell’API della distributrice automatica
Autenticazione: Chiave API o credenziali OAuth
Intervallo di polling: Quanto spesso sincronizzare i dati (consigliato: 5 minuti)
Mappa i prodotti:
Importa il catalogo prodotti dalla distributrice automatica
Assegna categorie perks (snack, bevande, opzioni sane)
Imposta prezzi e regole di sovvenzione
Configura le regole di riscatto:
Metodo di pagamento: Punti portafoglio, carta RFID, o ibrido
Limiti giornalieri: Transazioni massime per dipendente
Dipendenti idonei: Chi può usare questa macchina
Testa la connessione:
Clicca Testa Connessione
Verifica che i dati scorrono correttamente
Esegui una transazione di test
Clicca Salva e Attiva

Passo 4: Configurazione per i Dipendenti¶

Notifica ai dipendenti il nuovo perk della distributrice automatica
Assicurati che tutti i dipendenti abbiano:
Account 4Geeks Perks attivo
Carta RFID attivata
Saldo portafoglio sufficiente
Fornisci le istruzioni per l’utilizzo:
Avvicinati alla distributrice automatica
Tocca la carta RFID sul lettore
Seleziona il prodotto
Conferma il riscatto
Ritira il prodotto

Configurare l’Integrazione con la Stazione Caffè¶

Passo 1: Preparazione della Macchina¶

Assicurati che la macchina per il caffè abbia:
Modulo IoT installato
Connettività di rete
Lettore RFID (integrato o esterno)
Tubi dell’acqua e delle scorte collegati
Configura le impostazioni della macchina:
Tipi di bevande disponibili
Dimensioni delle tazze
Preferenze di temperatura
Programma di manutenzione

Passo 2: Registrare la Stazione Caffè¶

Vai a Perks > Dispositivi IoT > Aggiungi Dispositivo
Seleziona il tipo di dispositivo: Stazione Caffè
Compila i dettagli:
Nome del dispositivo: (es. “Caffè Sala Pausa Principale”)
Posizione: Stanza o area specifica
Modello macchina: Produttore e modello
Numero di serie: Per il tracciamento della garanzia
Scegli il metodo di integrazione:
API Diretta: Per macchine intelligenti
Gateway IoT: Per macchine con connettività base
Clicca Registra

Passo 3: Configurare il Perk Caffè¶

Clicca Configura sul dispositivo registrato
Imposta il catalogo delle bevande:
Espresso, americano, cappuccino, ecc.
Opzioni di tè e cioccolata calda
Bevande fredde (se applicabile)
Definisci i prezzi:
Gratuito per tutti i dipendenti
Sovvenzionato (es. l’azienda paga l‘80%)
Deduzione punti portafoglio
Limiti giornalieri (es. 3 bevande al giorno)
Configura il tracciamento dell’utilizzo:
Traccia i consumi per dipendente
Monitora gli orari di utilizzo di punta
Imposta avvisi di riapprovvigionamento
Abilita le notifiche:
Avvisi di scorte basse
Promemoria di manutenzione
Avvisi di soglia di utilizzo
Testa la configurazione:
Esegui un riscatto di test
Verifica che il tracciamento funzioni
Controlla la consegna delle notifiche
Clicca Salva e Attiva

Configurare il Mercato Self-Service¶

Passo 1: Infrastruttura del Mercato¶

I mercati self-service richiedono una configurazione più estesa:

Configurazione Fisica:
Stanza sicura o area chiusa
Sistema di ingresso controllato da RFID
Scaffali intelligenti o telecamere a visione artificiale
Cassa (opzionale per il funzionamento completamente automatizzato)
Stack Tecnologico:
Sistema di controllo accessi
Sistema di tracciamento dell’inventario
Integrazione di elaborazione pagamenti
Telecamere di sicurezza

Passo 2: Registrare il Mercato¶

Vai a Perks > Dispositivi IoT > Aggiungi Dispositivo
Seleziona il tipo di dispositivo: Mercato Self-Service
Compila i dettagli:
Nome del mercato: (es. “Micro-Mercato Edificio B”)
Posizione: Indirizzo completo e stanza
Orari di apertura: 24/7 o orari specifici
Capacità: Massimo utenti contemporanei
Configura il controllo accessi:
Collega al sistema di cancello RFID
Imposta il metodo di autenticazione dell’ingresso
Definisci le procedure di emergenza
Clicca Registra

Passo 3: Configurare il Catalogo Prodotti¶

Clicca Configura sul mercato
Importa l’inventario dei prodotti:
Carica un CSV con l’elenco dei prodotti
Scansiona i codici a barre per l’importazione automatica
Inserimento manuale per cataloghi piccoli
Categorizza i prodotti:
Snack
Bevande
Pasti
Cura personale
Forniture per ufficio
Imposta prezzi e sovvenzioni:
Prezzo pieno
Tariffa scontata
Solo punti portafoglio
Mix di metodi di pagamento
Configura il tracciamento dell’inventario:
Imposta soglie di riordino
Definisci le informazioni sui fornitori
Abilita gli avvisi di riordino automatico
Testa il sistema:
Entra con la carta RFID
Seleziona i prodotti
Completa il checkout
Verifica l’aggiornamento dell’inventario
Controlla la deduzione dal portafoglio
Clicca Salva e Attiva

Configurazione del Lettore RFID¶

Lettori RFID Autonomi¶

Per le sedi senza dispositivi IoT completi:

Acquista un lettore RFID compatibile
Connetti alla rete:
USB al computer locale
Ethernet alla rete
Configurazione Wi-Fi
Registra in 4Geeks Perks:
Vai a Perks > Dispositivi IoT > Aggiungi Dispositivo
Seleziona Lettore RFID
Inserisci i dettagli del dispositivo
Configura l’endpoint
Testa la lettura della carta:
Tocca la carta RFID del dipendente
Verifica l’identificazione del dipendente
Conferma l’accesso al portafoglio
Distribuisci nella sede

Configurazione del Lettore RFID¶

Imposta la modalità del lettore:
Solo autenticazione: Verifica identità
Pagamento abilitato: Elabora deduzioni dal portafoglio
Tracciamento tempo: Registra orari di ingresso/uscita
Configura la sicurezza:
Impostazioni di crittografia
Avvisi anti-manomissione
Comportamento in modalità offline
Imposta le notifiche:
Stato della connessione
Avvisi di errore
Report di utilizzo

Monitorare i Dispositivi IoT¶

Dashboard Dispositivi¶

Vai a Perks > Dispositivi IoT > Dashboard
Visualizza tutti i dispositivi connessi:
Stato online/offline
Ultima ora di comunicazione
Conteggio transazioni (oggi/mese)
Stato degli errori
Filtra per:
Tipo di dispositivo
Posizione
Stato
Edificio

Dettagli Dispositivo¶

Clicca su qualsiasi dispositivo per vedere: - Stato in tempo reale - Cronologia delle transazioni - Livelli di inventario (se applicabile) - Programma di manutenzione - Registro degli errori - Metriche delle prestazioni

Avvisi e Notifiche¶

Configura avvisi per: - Dispositivo offline: Notifica immediata - Inventario basso: Avvisi basati su soglie - Alto utilizzo: Rilevamento di attività insolite - Manutenzione necessaria: Promemoria programmati - Errore rilevato: Avvisi di malfunzionamento del sistema

Imposta in Perks > Dispositivi IoT > Avvisi

Risoluzione dei Problemi¶

Dispositivo Offline¶

Controlla le connessioni fisiche:
Alimentazione elettrica
Cavo di rete
Stato del router/switch
Verifica la connettività di rete:
Ping dell’IP del dispositivo
Controlla le regole del firewall
Conferma la risoluzione DNS
Riavvia il dispositivo:
Spegni e riaccendi
Attendi 2 minuti
Controlla se torna online
Se è ancora offline:
Controlla i log del dispositivo
Contatta il produttore del dispositivo
Contatta il supporto 4Geeks

Fallimenti delle Transazioni¶

Verifica l’idoneità del dipendente:
Stato dell’account attivo
Saldo portafoglio sufficiente
Perk abilitato per il dipendente
Controlla lo stato del dispositivo:
Online e rispondente
Nessuno stato di errore
Transazioni recenti riuscite
Rivedi i log delle transazioni:
Vai a Perks > Transazioni
Filtra per dispositivo e orario
Identifica i codici di errore
Soluzioni comuni:
Riprova la transazione
Risincronizza i dati del dispositivo
Aggiorna il firmware del dispositivo

Discrepanze nell’Inventario¶

Esegui un conteggio fisico
Confronta con l’inventario del sistema
Identifica le discrepanze
Aggiusta l’inventario nel sistema:
Vai ai dettagli del dispositivo
Clicca Aggiusta Inventario
Inserisci le quantità corrette
Aggiungi una nota di aggiustamento
Indaga la causa principale:
Furto o perdita
Malfunzionamento del sensore
Errori di sincronizzazione

Migliori Pratiche di Sicurezza¶

Sicurezza di Rete¶

Usa una VLAN dedicata per i dispositivi IoT
Implementa regole del firewall che limitano la comunicazione dei dispositivi
Abilita la crittografia WPA3 per i dispositivi Wi-Fi
Aggiorna regolarmente il firmware dei dispositivi
Monitora il traffico di rete per anomalie

Sicurezza dei Dati¶

Tutti i dati trasmessi tramite TLS 1.3
Dati dei dipendenti crittografati a riposo
Audit di sicurezza regolari
Conformità con GDPR e leggi sulla privacy locali
Timeout automatici delle sessioni

Sicurezza Fisica¶

Installa i dispositivi in aree monitorate
Usa sigilli anti-manomissione
Implementa controlli accessi per la manutenzione
Ispezioni fisiche regolari
Documenta tutte le attività di manutenzione

Integrazione API¶

Per soluzioni IoT personalizzate, 4Geeks Perks fornisce API REST:

Autenticazione¶

POST /api/v1/auth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Registrare il Dispositivo¶

POST /api/v1/iot/devices
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_type": "vending_machine",
  "name": "Building A Vending",
  "location": "Floor 2, Break Room",
  "serial_number": "VM-12345",
  "integration_method": "api",
  "api_endpoint": "https://vending-api.example.com"
}

Segnalare una Transazione¶

POST /api/v1/iot/transactions
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_id": "device_uuid",
  "employee_id": "employee_uuid",
  "product_id": "product_uuid",
  "amount": 150,
  "currency": "points",
  "timestamp": "2026-04-24T10:30:00Z"
}

Vedi la documentazione API completa

Manutenzione¶

Attività di Manutenzione Regolare¶

Giornaliera: - Rivedi la dashboard dello stato dei dispositivi - Controlla gli avvisi di errore - Monitora i tassi di successo delle transazioni

Settimanale: - Rivedi i livelli di inventario - Controlla le analisi di utilizzo - Verifica la sincronizzazione dei dati

Mensile: - Ispezione fisica dei dispositivi - Controllo aggiornamenti firmware - Revisione dell’audit di sicurezza - Ottimizzazione delle prestazioni

Trimestrale: - Audit completo del sistema - Revisione della sicurezza di rete - Calibrazione dei dispositivi (se necessario) - Revisione delle prestazioni dei fornitori

Aggiornamenti Firmware¶

Controlla gli aggiornamenti in Perks > Dispositivi IoT > Aggiornamenti
Rivedi le note di rilascio
Programma l’aggiornamento durante gli orari di basso utilizzo
Esegui il backup della configurazione del dispositivo
Applica l’aggiornamento
Testa la funzionalità
Monitora per 24 ore

Supporto¶

Documentazione: Guide di 4Geeks Perks
Supporto Tecnico: iot-support@4geeks.io
Compatibilità Dispositivi: Controlla la lista di compatibilità o contatta le vendite
Integrazione Personalizzata: Servizi professionali disponibili per soluzioni personalizzate

Prossimi Passi¶

Hai ancora domande? Richiedi supporto or explore tutoriali