65. FAQ tecniche

Le domande che ti farai prima o poi. Se la risposta non c’e’, vai a sezione 68 (contatti supporto). Regola d’oro: prima di chiamare, riavvia / aggiorna la pagina / chiudi e riapri il browser. 7 problemi su 10 si risolvono cosi’.

1) Il sito della pizzeria non si apre. Cosa faccio?

Causa probabile: VPS giu’ temporaneamente, oppure problema rete locale (il tuo wi-fi).
Fix immediato: apri il sito da rete dati del telefono (4G/5G, non wi-fi). Se si apre da li’ e non da casa/pizzeria -> e’ la TUA rete, riavvia il router. Se NON si apre nemmeno da 4G -> il server e’ giu’.
Quando contattare supporto: dopo 5 minuti di sito offline da 4G. Includi nel messaggio l’URL della pizzeria e l’ora del problema.

2) Il cliente dice di non aver ricevuto l’email di conferma ordine.

Causa probabile: finita in spam, oppure email digitata male, oppure dominio email del cliente blocca Resend (raro ma succede con alcuni provider aziendali).
Fix immediato: chiedi al cliente di controllare la cartella spam/promozioni. Apri l’ordine in /admin/orders -> verifica che l’email scritta sia corretta. Se serve, manda manualmente conferma via WhatsApp.
Quando contattare supporto: se piu’ clienti consecutivi segnalano la stessa cosa (potrebbe essere un problema con Resend account o blacklist del mittente).

3) Brigata non risponde alla chat.

Causa probabile: chiave API Anthropic scaduta, oppure il piano SaaS ha esaurito le conversazioni del mese (vedi sezione 54), oppure Anthropic ha avuto un disservizio temporaneo (status.anthropic.com).
Fix immediato: apri /admin/dashboard e controlla il widget “Utilizzo conversazioni”. Se sei in soft-limit, contatta il referente per upgrade piano (sezione 55). Se l’usage e’ OK, riprova fra 5 minuti: di solito i blackout Anthropic durano pochi minuti.
Quando contattare supporto: se Brigata e’ muta da piu’ di 15 minuti e l’usage e’ sotto al limite. Nel messaggio includi l’orario, una conversazione di esempio (URL chat) e cosa hai gia’ provato.

4) Stripe rifiuta tutti i pagamenti.

Causa probabile: account Stripe in review (Stripe a volte blocca temporaneamente account nuovi per controlli antifrode), oppure le chiavi API sono scadute / cambiate, oppure il tuo conto bancario collegato e’ stato chiuso.
Fix immediato: apri dashboard.stripe.com e guarda se hai notifiche / banner gialli o rossi nella home. Stripe ti dice esattamente cosa fare (di solito caricare un documento o compilare un form).
Quando contattare supporto: dopo aver risolto le richieste Stripe sul loro pannello. Se i pagamenti continuano a fallire, contatta il referente per verificare le chiavi API caricate sul VPS.

5) Ho perso la password admin. Cosa faccio?

Vedi sezione 47 (Cambiare la propria password). In sintesi: usa “Password dimenticata?” sulla pagina di login -> ti arriva email con link reset. Se non ti arriva l’email entro 5 minuti, controlla spam. Se nemmeno cosi’, un altro admin owner puo’ resettartela dalla pagina Team. Se sei l’unico owner e l’email non arriva, contatta supporto: il referente tecnico ha procedure di emergenza sul DB.

6) Il KDS non mostra l’ordine appena fatto.

Causa probabile: schermo KDS ha perso la connessione real-time (Pusher), oppure browser del KDS in pausa (alcuni browser sospendono i tab in background).
Fix immediato: ricarica la pagina del KDS (F5 o pull-to-refresh su tablet). L’ordine deve apparire entro 1-2 secondi. Se ancora niente, verifica che l’ordine sia in stato confirmed o preparing su /admin/orders (gli ordini in pending non arrivano al KDS finche’ non li confermi).
Quando contattare supporto: se la cosa si ripete piu’ volte al giorno: potrebbe essere un problema Pusher o un bug Block B.

7) Il delivery non funziona per certi CAP.

Causa probabile: quel CAP non e’ nella tua lista zone delivery (sezione 33). Il sistema rifiuta gli ordini per CAP non configurati.
Fix immediato: vai su Impostazioni -> Operatività (/admin/settings/operations) -> Consegna a domicilio -> aggiungi il CAP mancante con il costo di consegna. Salva. Riprova.
Quando contattare supporto: mai. Questo lo gestisci tu in autonomia.

8) Voglio cambiare il numero di telefono visualizzato sul sito.

Causa probabile: il numero della pizzeria sta in restaurants.phone (database).
Fix immediato: vai su Impostazioni -> Brand & Cliente (/admin/settings/brand) -> Anagrafica ristorante -> modifica il campo “Telefono” -> Salva. Si aggiorna ovunque (header, footer, conferme email).
Quando contattare supporto: se non vedi il campo nelle impostazioni o se non si aggiorna dopo il salvataggio.