Domande frequenti

Il dispositivo risulta offline nel pannello

Sintomi: icona rossa, "Ultimo heartbeat" datato.

Controlli:

1. È alimentato e lo schermo è acceso?
2. Ha connessione a internet? Provi ad aprire un sito qualsiasi dal browser dell'agente, oppure esegua un ping da un altro dispositivo della stessa rete.
3. L'URL del server nell'agente è corretto? (https://rds.digitalsignagerds.com)
4. L'ID del dispositivo nell'agente coincide con l'RDSXXXX del pannello?
5. Controlli i log dell'agente: Azioni → Logs. Errori tipici:
   • 401 Unauthorized — ID o URL scritti male.
   • Connection refused / timeout — problema di rete locale (firewall, DNS, ecc.).

Linux: journalctl -u kiosk-browser -f via SSH per vedere il dettaglio.

La playlist non si aggiorna

Sintomi: ha modificato la playlist ma il dispositivo continua a riprodurre quella precedente.

Controlli:

1. Ha salvato le modifiche? Finché non preme Salva, le modifiche restano locali nel suo browser.
2. Attenda l'heartbeat successivo (≤1 min). L'agente controlla l'elenco, scarica i nuovi file e li riproduce al giro di loop successivo.
3. La playlist è programmata (con data)? Se la data non è ancora arrivata, il dispositivo non la riprodurrà.
4. Il dispositivo è online? (Vedere il punto precedente.)

Ho dimenticato la password del menu admin

• Dal pannello — torni su Modifica kiosk e prema Cambia la password del menu di amministrazione. La modifica viene applicata all'heartbeat successivo (≤1 min). Nel frattempo il dispositivo accetterà la vecchia password.
• Se non ha accesso nemmeno al pannello — contatti il suo amministratore o l'assistenza.

Come aggiorno l'agente?

Android: l'aggiornamento avviene di norma da remoto, dal server. Se ha bisogno di forzarlo, disinstalli l'app e reinstalli l'APK più recente.

Linux — riesegua l'installer one-liner (rileva che esiste già un checkout, esegue git fetch + reset --hard origin/main su /opt/promobrowser e reinstalla dipendenze e servizio in modo idempotente):

curl -fsSL https://rds.digitalsignagerds.com/install.sh | sudo bash
sudo systemctl restart kiosk-browser

L'addebito automatico non è andato a buon fine

Stripe riprova automaticamente tre volte nei giorni successivi. Riceverà delle email con un link per aggiornare il metodo di pagamento.

Per aggiungere o aggiornare la carta: Profilo → Metodi di pagamento.

Se dopo i tentativi continua a fallire, il suo piano passa allo stato past_due e viene contattata Promotienda.

Posso usare hardware Android / Linux mio?

Sì. Sono le opzioni B e C del Quickstart. Le serve:

• Hardware compatibile (Android 5.0+ oppure Debian 12+/Ubuntu 22.04+).
• Creare il dispositivo nel pannello per ottenere un ID RDSXXXX.
• Installare l'agente corrispondente.

Perde la comodità del plug & play e la licenza gratuita di 1 anno (che si applica solo agli acquisti a catalogo), ma guadagna in flessibilità.

Posso spostare un dispositivo su un'altra azienda?

Solo i superutenti possono spostare un dispositivo tra aziende. Contatti l'assistenza.

Quanto tempo serve perché arrivi un dispositivo del catalogo?

Dipende dal paese e dalla disponibilità. Promotienda le invia un'email quando l'ordine passa a spedito; il tempo di consegna viene indicato al momento dell'acquisto. Spedizioni solo all'interno dell'Unione Europea.

Come faccio a sapere quale versione ha il mio agente?

• Pannello — colonna Versione nell'elenco dei dispositivi.
• Android — Impostazioni → versione.
• Linux — Settings → Server tab → App version.

I miei video sono da giorni "In attesa di verifica"

La verifica la fa lei su uno dei suoi dispositivi, non Promotienda. Il sistema non contrassegna nulla in automatico — deve:

1. Andare su Video e premere Verifica sulla riga del video.
2. Scegliere un dispositivo di prova — il sistema gli invia il video in una Playlist di verifica.
3. Recarsi fisicamente allo schermo e confermare che si veda correttamente.
4. Tornare al pannello e premere Convalida per contrassegnarlo come verificato.

Dettaglio del flusso completo.

Consiglio: tenga un dispositivo dedicato alla verifica, accessibile internamente. Verifichi lì tutti i contenuti prima di aggiungerli alle playlist di produzione — eviterà schermi neri causati da file che il suo hardware specifico non è in grado di riprodurre.

Come cancello tutti i file in cache sul dispositivo?

Linux — Settings → Browser tab → Remove Local Videos.

Android — Impostazioni Admin → opzione di pulizia della cache, oppure disinstalli e reinstalli l'app.