FAQ tecniche
Risposte a domande tecniche su widget, integrazione, email e altro.
Widget
Cosa sono i widget?
I widget sono componenti incorporabili per il tuo sito web:
- Programma dei corsi
- Pacchetti di crediti
- Panoramica degli istruttori
- Area di login
Come incorporo i widget?
- Aprire il Widget Builder
- Configurare i widget
- Copiare il codice di incorporamento
- Inserire nel sito web
<div id="bookicorn-widget"></div>
<script src="https://app.bookicorn.net/widget/[your-code].js"></script>
I widget funzionano con qualsiasi costruttore di siti web?
Si', i widget funzionano con:
- WordPress
- Wix
- Squarespace
- Webflow
- HTML personalizzato
- E tutti gli altri che consentono HTML/JavaScript
Perche' il mio widget non si carica?
Controlla:
- Codice di incorporamento copiato correttamente?
- JavaScript consentito sulla tua pagina?
- Nessuna Content Security Policy che lo blocca?
- Controlla la console del browser per errori
Posso personalizzare il design del widget?
Si', nel Widget Builder:
- Colori (colore primario)
- Larghezza e spaziatura
- Raggio dei bordi
- Sfondo
- Modalita' scura/chiara
Perche' il widget appare diverso sulla mia pagina?
Possibili cause:
- Il tuo CSS influenza il contenitore
- Larghezza diversa rispetto all'anteprima
- L'elemento genitore ha degli stili
Soluzione: creare un contenitore con larghezza fissa.
Quali email invia Bookicorn?
| Categoria | |
|---|---|
| Prenotazioni | Conferma, promemoria, cancellazione |
| Crediti | Conferma d'acquisto, avviso di scadenza |
| Account | Registrazione, reset della password |
| Sistema | Cancellazione del corso, lista d'attesa |
Le email non vengono ricevute
Controlla:
- Cartella spam del destinatario
- Indirizzo email corretto?
- Stato di invio in Clienti → Storico email
Posso personalizzare i modelli email?
Si', in Impostazioni → Modelli email:
- Modificare l'oggetto
- Modificare il contenuto
- Utilizzare variabili (es.
{vorname},{kurs},{datum})
Posso utilizzare il mio server email?
No. Tutte le email vengono inviate tramite i server di Bookicorn. Questo garantisce la consegnabilita' e la coerenza.
Le email vengono contrassegnate come spam?
Non dovrebbe accadere. Bookicorn utilizza:
- Autenticazione SPF/DKIM
- Gestione della reputazione
- Invio conforme all'opt-in
In caso di problemi: chiedere ai clienti di contrassegnare l'email come "non spam".
Account e sicurezza
Quanto sono sicuri i dati?
- Trasmissione crittografata (HTTPS/TLS)
- Archiviazione crittografata
- Conforme al GDPR
- Server nell'UE
- Backup regolari
Dove vengono archiviati i dati?
Nell'UE (Germania). Utilizziamo:
- Supabase (database)
- Vercel (hosting)
- Stripe (pagamenti)
Tutti i fornitori sono conformi al GDPR.
Posso esportare i dati?
Si':
- Impostazioni → Privacy
- "Esporta dati"
- Download come JSON/CSV
Come elimino il mio account?
- Impostazioni → Privacy
- "Elimina account"
- Conferma via email
- Tutti i dati vengono eliminati
Attenzione: Non e' possibile annullare l'operazione.
Cosa succede se perdo la password?
- Pagina di login → "Password dimenticata"
- Inserire l'indirizzo email
- Ricevere il link di reset
- Impostare una nuova password
Bookicorn supporta l'autenticazione a due fattori?
Non attualmente. Prevista per le versioni future.
Pagamenti e Stripe
Perche' Stripe?
Stripe e':
- Sicuro e conforme PCI
- Accettato in tutto il mondo
- Supporta molti metodi di pagamento
- Gestione automatica delle tasse
Ho bisogno di un account Stripe?
Si'. Durante la configurazione iniziale vieni reindirizzato a Stripe:
- Creare un account Stripe
- Completare la verifica
- Collegare con Bookicorn
Quali metodi di pagamento sono supportati?
A seconda della configurazione Stripe:
- Carta di credito (Visa, Mastercard, Amex)
- Addebito diretto SEPA
- PayPal
- Apple Pay
- Google Pay
- Klarna
Quando ricevo i pagamenti?
Stripe effettua automaticamente i pagamenti sul tuo conto bancario:
- Standard: dopo 7 giorni
- Per account consolidati: dopo 2 giorni
Quanto sono le commissioni Stripe?
Commissioni standard Stripe:
- 1,4% + 0,25 EUR (carte UE)
- 2,9% + 0,25 EUR (carte non UE)
Piu' la quota di revenue sharing di Bookicorn.
Le fatture possono essere create automaticamente?
Si'. Per ogni acquisto viene creata automaticamente una fattura:
- I clienti ricevono il PDF via email
- Accessibile nel Dashboard
- Con tutte le informazioni fiscali
Integrazione
Esiste un'API?
Non attualmente disponibile pubblicamente. Per richieste di integrazione: contattare il supporto.
Posso collegare Google Calendar?
Non direttamente. Soluzione alternativa:
- I clienti possono aggiungere le prenotazioni al loro calendario (link ICS nell'email)
Esiste un'integrazione Zapier?
Non attualmente disponibile. Prevista per le versioni future.
Posso collegare Bookicorn al mio CRM?
Non direttamente. I dati possono essere esportati e importati manualmente.
Mobile e app
Esiste un'app mobile?
No, ma:
- Il Dashboard e' completamente responsivo
- Funziona come un'app sullo smartphone
- "Aggiungi alla schermata iniziale" e' possibile
Bookicorn funziona sui tablet?
Si'. L'interfaccia si adatta automaticamente:
- Desktop: vista completa
- Tablet: vista ottimizzata
- Mobile: layout a pila
I clienti possono prenotare dal telefono?
Si'. L'intero processo di prenotazione e' ottimizzato per mobile:
- Widget responsivi
- Pulsanti ottimizzati per il touch
- Checkout mobile
Browser e compatibilita'
Quali browser sono supportati?
- Chrome (consigliato)
- Firefox
- Safari
- Edge
Non supportato: Internet Explorer
Perche' appare diverso nel mio browser?
Possibili cause:
- Versione del browser obsoleta
- Estensioni del browser che bloccano
- Svuotare la cache spesso aiuta
JavaScript deve essere abilitato?
Si'. Bookicorn richiede JavaScript per:
- Funzioni del Dashboard
- Rendering dei widget
- Elementi interattivi
Prestazioni
Perche' la pagina si carica lentamente?
Possibili cause:
- Connessione internet lenta
- Molte schede del browser aperte
- Cache del browser piena
Soluzione:
- Svuotare la cache
- Provare un altro browser
- Ricaricare la pagina
Ci sono finestre di manutenzione?
Raramente. Per manutenzioni pianificate:
- Preavviso via email
- Pagina di stato su status.bookicorn.net
E le interruzioni di sistema?
- Controllare lo stato: status.bookicorn.net
- Contattare il supporto
- I dati non vengono mai persi (backup)
Privacy e GDPR
Bookicorn e' conforme al GDPR?
Si':
- Elaborazione dati nell'UE
- Accordo sul trattamento dei dati (DPA) disponibile
- Processi conformi alla privacy
- Diritto alla cancellazione implementato
Ho bisogno di un DPA?
Si', consigliato. Stai elaborando dati dei clienti. Per ottenere il DPA:
- Impostazioni → Legale
- Scaricare il DPA
- Restituire firmato
Cosa devo menzionare nella mia informativa sulla privacy?
- Bookicorn come responsabile del trattamento dei dati
- Elaborazione dati per le prenotazioni
- Stripe per i pagamenti
- Nota sui cookie (se vengono utilizzati i widget)
Vengono impostati dei cookie?
Si', cookie tecnicamente necessari:
- Gestione della sessione
- Stato di login
- Impostazioni
Nessun cookie di tracciamento senza consenso.
Problemi comuni
Errore "Pagina non trovata"
- Controlla l'URL
- Sei autenticato?
- Hai i permessi necessari?
Il widget mostra "Errore nel caricamento"
- Controlla la console del browser (F12)
- Copia nuovamente il codice di incorporamento
- JavaScript e' consentito sulla pagina?
- Disabilita l'ad blocker
Il pagamento fallisce
Controllo lato cliente:
- Dati della carta corretti?
- Fondi sufficienti?
- 3D Secure confermato?
Controllo lato studio:
- Stripe collegato correttamente?
- Account Stripe verificato?
Il Dashboard non si carica
- Svuotare la cache del browser (Ctrl+Shift+Delete)
- Provare un altro browser
- Disabilitare le estensioni
- Ricaricare la pagina
Contattare il supporto
Quando contattare il supporto?
- Errori tecnici
- Comportamento imprevisto
- Domande sulla configurazione
- Richieste di funzionalita'
Come contatto il supporto?
- Email: hey@bookicorn.net
- Chat: nel Dashboard di amministrazione (pulsante di aiuto)
- Documentazione: manager.bookicorn.net/docs
Cosa devo includere quando segnalo un problema?
- Cosa hai provato a fare?
- Cosa e' successo?
- Cosa ti aspettavi?
- Screenshot se possibile
- Browser e dispositivo