Guida all'utilizzo

📋 Contenuti della guida

1. Registrazione
2. Accesso
3. Home & Dashboard
4. Gestione eventi
5. Ticket & QR
6. Invio email
7. Scanner
8. Validazione QR
9. Profilo organizzazione
10. Chiavi API

Passo 1

Registrazione account

La prima volta che apri TicketQR devi creare il profilo della tua organizzazione. Tocca "Crea Account" dalla schermata di accesso per aprire la pagina di registrazione.

Inserisci la tua email – sarà usata per accedere e ricevere comunicazioni
Scegli una password sicura e confermala nel campo apposito
Accetta i Termini e Condizioni spuntando la casella
Tocca "Crea Account" per creare il profilo
Verrà inviata una mail al tuo indirizzo con un link per confermare la registrazione
Al primo accesso ti verrà richiesto il nome della tua organizzazione

📧 Riceverai un'email di verifica all'indirizzo inserito. Devi confermare l'email prima di poter accedere all'app.

Schermata di registrazione

Passo 2

Accesso all'app

Dopo aver verificato l'email, accedi con le credenziali create durante la registrazione. La schermata di login è la prima che vedi avviando l'app.

Inserisci la tua email nel primo campo
Inserisci la tua password
Attiva "Resta connesso" per non dover reinserire le credenziali ogni volta
Tocca "Accedi" per entrare nella dashboard

🔐 Se dimentichi la password, tocca "Password dimenticata?" per ricevere il link di reset via email.

Per gli utenti scanner (solo lettura QR): esistono due tipi di account. Gli account scanner possono accedere solo alla funzione di scansione e non vedono le funzioni di gestione.

Schermata di login

Passo 3

Home e Dashboard

Dopo il login atterri nella Home, che mostra una panoramica immediata della tua organizzazione con le statistiche principali e i prossimi eventi.

Eventi attivi – numero di eventi in corso o futuri
Ticket emessi – totale biglietti generati per eventi attivi
Scanner attivi – numero di account scanner operativi

In basso puoi trovare i punti di accesso per raggiungere tutte le sezioni dell'app: I miei eventi, Scanner e Profilo.

Dashboard principale

Passo 4

Gestione eventi

La sezione "I miei eventi" mostra l'elenco completo degli eventi della tua organizzazione, filtrabili per Tutti, In programma e Passati.

Creare e modificare un nuovo evento:

Tocca il pulsante "+" in basso a destra per creare un nuovo evento o tocca un evento per modificarlo
Inserisci il titolo dell'evento (es. "Workshop Fotografia Digitale")
Seleziona la data e ora dell'evento tramite il selettore
Indica il luogo (es. "Sala Formazione, Centro Civico Verona")
Specifica il numero massimo di partecipanti (ticket)
Imposta la durata in ore dell'evento
Tocca "Crea evento" o Salva modifiche per salvare
Se stai modificando un evento troverai anche una sezione relativa alle statistiche e una serie di pulsanti per gestire i ticket generati.

💡 La durata viene usata per calcolare quando l'evento si considera concluso ai fini della validazione QR.

Lista eventi

Creazione evento

Passo 5

Generazione ticket e QR code

Dall'interno di un evento puoi gestire tutti i biglietti. TicketQR supporta la creazione singola o multipla di ticket.

Creare un ticket singolo:

Tocca "Genera 1 ticket" nella videata di gestione dell'evento
Indica se il ticket è nominativo (con nome partecipante) o anonimo
Per i nominativi, inserisci nome ed eventualmente email del partecipante
Il sistema genera automaticamente un QR code univoco

Creazione multipla: tocca il menu azioni e seleziona "Genera N ticket" o "Genera tutti i ticket" per generare un batch in una sola operazione. I ticket generati massivamente saranno tutti anonimi.

Export PDF: ogni ticket può essere esportato come PDF professionale con QR code, dati evento e logo organizzazione. Puoi scaricare tutti i PDF insieme.

✅ Il QR code è univoco e non riutilizzabile: una volta scansionato per l'ingresso, non può essere riusato.

Lista ticket evento

Dettaglio ticket

Passo 6

Invio ticket via email

TicketQR può inviare automaticamente i ticket in PDF a tutti i partecipanti che hanno un indirizzo email associato.

Dalla pagina di gestione dell'evento, tocca il pulsante "Condividi ticket via email"
L'app mostra quanti ticket hanno un'email associata su quelli totali
Conferma l'invio: ogni partecipante riceverà un'email con in allegato il PDF del proprio ticket

Le email vengono inviate con il logo della tua organizzazione (se caricato) e includono tutte le informazioni dell'evento e le istruzioni per l'accesso.

⚠️ Solo i ticket con email associata riceveranno la comunicazione. I ticket anonimi o senza email vengono saltati.

Conferma invio email massivo

Passo 7

Gestione scanner

Gli account scanner sono profili separati con permessi limitati alla sola validazione QR. Sono pensati per i volontari o il personale all'ingresso degli eventi.

Creare un account scanner:

Vai nella sezione "Scanner" dal menu in basso
Tocca "+" in basso a destra
Inserisci il nome (es. "Ingresso Nord")
Scegli uno username univoco per il login
Imposta una password
Lo scanner sarà attivo e pronto all'uso

Puoi modificare e disattivare temporaneamente uno scanner senza eliminarlo, e riattivarlo in qualsiasi momento.

Lista scanner

Creazione scanner

Passo 8

Validazione QR all'ingresso

L'interfaccia scanner è pensata per essere usata direttamente all'ingresso dell'evento. L'operatore inquadra il QR code del biglietto con la fotocamera del dispositivo.

Risultati della scansione:

🟢 Verde – Ingresso registrato: il biglietto è valido, il partecipante entra
🟡 Giallo – Già entrato: il biglietto è stato già scansionato. Mostra l'orario dell'ingresso precedente. È possibile registrare l'uscita.
🔴 Rosso – Accesso negato: ticket non valido, già usato, evento concluso, evento errato o non ancora attivo

Ogni scansione fornisce anche feedback sonoro e aptico per facilitare il lavoro in ambienti rumorosi. In caso di ingresso registrato correttamente, dopo 3 secondi lo scanner torna automaticamente alla modalità di lettura.

💡 Il flash della fotocamera è attivabile con un tocco per scansionare in ambienti bui.

✅ Ingresso OK

❌ Accesso negato

⚠️ Già entrato

Passo 9

Profilo organizzazione

Nella sezione Profilo puoi gestire le informazioni della tua organizzazione che appariranno su tutti i biglietti e nelle comunicazioni email.

Modifica il nome organizzazione che appare sull'app e nei PDF
Carica il logo personalizzato (PNG/JPG, max 2MB) – apparirà su tutti i ticket PDF e le email
Se non hai un logo, i biglietti useranno il logo standard TicketQR
Tocca "Salva modifiche" per applicare le modifiche

🖼️ Il logo viene automaticamente ridimensionato e ottimizzato. I formati supportati sono PNG e JPEG.

Impostazioni profilo

Passo 10

Chiavi API per integrazioni esterne

La sezione Chiavi API (nel profilo) permette di generare credenziali per connettere TicketQR a piattaforme esterne come WooCommerce, sistemi di prenotazione o soluzioni personalizzate.

Vai in Profilo → API Keys
Tocca "Crea chiave API"
Assegna un nome descrittivo (es. "Integrazione WooCommerce")
IMPORTANTE: copia e salva subito la chiave generata – non sarà più visualizzabile
Usa la chiave nell'header X-API-Key delle tue richieste HTTP
Puoi revocare o riattivare le chiavi in qualsiasi momento
Una volta attivata la chiave API dovrai abilitare gli eventi che desideri gestire tramite API esterne

🔑 Non condividere mai le chiavi API pubblicamente. Usale solo in ambienti sicuri lato server e utilizza variabili d'ambiente nel codice.

Per la documentazione completa delle API vedi la pagina API.

Gestione chiavi API

Step 1

Account Registration

The first time you open TicketQR you need to create your organization profile. Tap "Create Account" from the login screen to open the registration page.

Enter your email – it will be used to log in and receive communications
Choose a secure password and confirm it in the appropriate field
Accept the Terms and Conditions by checking the box
Tap "Create Account" to create the profile
An email will be sent to your address with a link to confirm your registration
On first login you will be asked for the name of your organization

📧 You will receive a verification email at the entered address. You must confirm your email before you can access the app.

Registration screen

Step 2

App Login

After verifying your email, log in with the credentials created during registration. The login screen is the first thing you see when you launch the app.

Enter your email in the first field
Enter your password
Enable "Stay connected" to avoid re-entering your credentials every time
Tap "Login" to enter the dashboard

🔐 If you forget your password, tap "Forgot password?" to receive the reset link via email.

For scanner users (QR read-only): there are two types of accounts. Scanner accounts can only access the scanning function and do not see management features.

Step 3

Home & Dashboard

After login you land on the Home, which shows an immediate overview of your organization with the main statistics and upcoming events.

Active events – number of ongoing or upcoming events
Tickets issued – total tickets generated for active events
Active scanners – number of operational scanner accounts

At the bottom you can find the access points to reach all sections of the app: My Events, Scanners and Profile.

Main dashboard

Step 4

Event Management

The "My Events" section shows the complete list of your organization's events, filterable by All, Upcoming and Past.

Creating and editing an event:

Tap the "+" button at the bottom right to create a new event or tap an event to edit it
Enter the title of the event (e.g. "Digital Photography Workshop")
Select the date and time of the event using the picker
Enter the location (e.g. "Training Room, Verona Civic Center")
Specify the maximum number of participants (tickets)
Set the duration in hours of the event
Tap "Create event" or Save changes to save
When editing an event you will also find a statistics section and a series of buttons to manage generated tickets.

💡 The duration is used to calculate when the event is considered finished for QR validation purposes.

Events list

Event creation

Step 5

Ticket and QR Code Generation

From inside an event you can manage all tickets. TicketQR supports single or batch ticket creation.

Creating a single ticket:

Tap "Generate 1 ticket" in the event management screen
Indicate whether the ticket is named (with participant name) or anonymous
For named tickets, enter the participant's name and optionally their email
The system automatically generates a unique QR code

Batch creation: tap the actions menu and select "Generate N tickets" or "Generate all tickets" to generate a batch in a single operation. Bulk-generated tickets will all be anonymous.

PDF Export: each ticket can be exported as a professional PDF with QR code, event data and organization logo. You can download all PDFs together.

✅ The QR code is unique and non-reusable: once scanned for entry, it cannot be used again.

Event ticket list

Ticket detail

Step 6

Sending tickets by email

TicketQR can automatically send PDF tickets to all participants who have an associated email address.

From the event management page, tap the "Share tickets via email" button
The app shows how many tickets have an associated email out of the total
Confirm sending: each participant will receive an email with their ticket PDF attached

Emails are sent with your organization's logo (if uploaded) and include all event information and access instructions.

⚠️ Only tickets with an associated email will receive the communication. Anonymous tickets or those without an email are skipped.

Bulk email sending confirmation

Step 7

Scanner Management

Scanner accounts are separate profiles with permissions limited to QR validation only. They are designed for volunteers or staff at event entrances.

Creating a scanner account:

Go to the "Scanners" section from the bottom menu
Tap "+" at the bottom right
Enter the name (e.g. "North Entrance")
Choose a unique username for login
Set a password
The scanner will be active and ready to use

You can edit and temporarily deactivate a scanner without deleting it, and reactivate it at any time.

Scanner list

Scanner creation

Step 8

QR Validation at Entrance

The scanner interface is designed to be used directly at the event entrance. The operator points the device camera at the ticket QR code.

Scan results:

🟢 Green – Entry registered: the ticket is valid, the participant enters
🟡 Yellow – Already entered: the ticket has already been scanned. Shows the time of the previous entry. Exit can be registered.
🔴 Red – Access denied: invalid ticket, already used, event finished, wrong event or not yet active

Each scan also provides audio and haptic feedback to facilitate work in noisy environments. When entry is successfully registered, after 3 seconds the scanner automatically returns to reading mode.

💡 The camera flash can be activated with a tap to scan in dark environments.

✅ Entry OK

❌ Access denied

⚠️ Already entered

Step 9

Organization Profile

In the Profile section you can manage your organization's information that will appear on all tickets and email communications.

Edit the organization name that appears on the app and in PDFs
Upload a custom logo (PNG/JPG, max 2MB) – it will appear on all PDF tickets and emails
If you don't have a logo, tickets will use the standard TicketQR logo
Tap "Save changes" to apply the changes

🖼️ The logo is automatically resized and optimized. Supported formats are PNG and JPEG.

Profile settings

Step 10

API Keys for external integrations

The API Keys section (in Profile) allows you to generate credentials to connect TicketQR to external platforms like WooCommerce, booking systems or custom solutions.

Go to Profile → API Keys
Tap "Create API key"
Assign a descriptive name (e.g. "WooCommerce Integration")
IMPORTANT: copy and save the generated key immediately – it will not be shown again
Use the key in the X-API-Key header of your HTTP requests
You can revoke or reactivate keys at any time
Once the API key is activated you will need to enable the events you wish to manage via external APIs

🔑 Never share API keys publicly. Use them only in secure server-side environments and use environment variables in your code.

For the complete API documentation see the API page.

API Keys management

Guida all'utilizzo

📋 Contenuti della guida

Registrazione account

Accesso all'app

Home e Dashboard

Gestione eventi

Generazione ticket e QR code

Invio ticket via email

Gestione scanner

Validazione QR all'ingresso

Profilo organizzazione

Chiavi API per integrazioni esterne

User Guide

📋 Guide Contents

Account Registration

App Login

Home & Dashboard

Event Management

Ticket and QR Code Generation

Sending tickets by email

Scanner Management

QR Validation at Entrance

Organization Profile

API Keys for external integrations