Integrazioni

RadioPanel si collega ad altri servizi della radio. Quasi tutto si configura dal pannello; dove serve anche il file di configurazione del server (.env), è indicato il nome della variabile, utile solo a chi gestisce in proprio un’installazione del pannello.

AzuraCast

AzuraCast è il server dei flussi audio. Con il collegamento il pannello mostra il brano in onda e lo stato dello streaming e, con la chiave API, registrazioni delle dirette, ascolti e account DJ.

Si configura per ogni radio in Gestisci Radio:

Scrivi Indirizzo del server e Stazione (ID o nome breve).
Per le funzioni riservate aggiungi la Chiave API, creata in AzuraCast da Il mio account → Chiavi API da un utente con i permessi sulla stazione. Con la chiave il server deve essere in https://.
Se vuoi, attiva Collega il palinsesto ad AzuraCast e Consenti la diretta solo negli orari del palinsesto.
Salva: il pannello prova subito il collegamento e mostra l’esito.

Cosa cambia con il collegamento attivo:

compaiono le pagine In onda e, con la chiave, Ascolti e il riascolto delle dirette registrate;
palinsesto pubblico, orologio di regia e API del sito mostrano il brano in onda;
con il palinsesto collegato, gli account DJ con lo stesso nome utente di una persona della radio ricevono come orari i suoi turni (anche le variazioni di un giorno), e la spia ON AIR dell’orologio si accende quando è in diretta una persona della radio.

Le chiamate ad AzuraCast partono solo dal server del pannello: la chiave non arriva mai al browser ed è salvata cifrata.

MB Studio

Per le radio in cui il brano in onda lo conosce la regia MB Studio e non l’AutoDJ di AzuraCast. MB Studio carica via FTP due file che sa esportare:

File	Contenuto
`onair.txt`	Il brano o l’oggetto in onda adesso, nella forma `ARTISTA - TITOLO` (anche con l’anno).
`lastsongs.html`	Le ultime canzoni trasmesse: una tabella con l’ora (`HH:MM`) e `ARTISTA - TITOLO (ANNO)`. È accettato anche il nome `ultimecanzoni.html`.

Le maiuscole nei nomi dei file non contano (OnAir.txt va bene).

Chiedi allo staff di RadioPanel un account FTP per la radio: punta alla cartella con il nome del Codice emittente della radio (sul server del pannello, con HestiaCP, un account FTP aggiuntivo con percorso private/mbstudio/<codice>).
In MB Studio imposta l’invio via FTP di onair.txt e lastsongs.html verso quell’account.
In Gestisci Radio scegli Fonte del brano in onda: MB Studio (file inviati via FTP). AzuraCast va collegato comunque: stato della radio e ascoltatori restano i suoi.

Dopo il salvataggio la pagina della radio mostra quali file il pannello trova e quando è arrivato l’ultimo onair.txt. Per chi gestisce il server: la cartella base dei file si imposta con MBSTUDIO_DIR.

I messaggi WhatsApp degli ascoltatori arrivano nella pagina Richieste, e la direzione può leggere le chat e rispondere dal Centro Messaggi (Gestione Radio). Il collegamento passa da un server OpenWA gestito dallo staff di RadioPanel.

L’Editore o il Direttore della radio apre Centro Messaggi, inserisce il numero WhatsApp della radio e genera il codice di collegamento.
Sul telefono della radio, in WhatsApp: Dispositivi collegati → Collega con il numero di telefono, poi inserisce il codice. In alternativa inquadra il codice QR.

Il pannello prepara da solo la connessione e la ricezione delle richieste. Dalla stessa pagina il numero si riconnette o si scollega in qualsiasi momento.

Arrivano solo messaggi di testo e vocali; immagini, video e documenti vengono scartati.
I vocali si salvano al massimo 10 all’ora per numero e 300 al giorno per radio (oltre, la richiesta arriva senza audio); gli audio più vecchi di 30 giorni vengono cancellati, la richiesta resta.
Un numero WhatsApp può appartenere a una sola radio, e i messaggi vengono accettati solo dalla sessione collegata a quel numero.

Per chi gestisce il server: OPENWA_API_URL, OPENWA_API_KEY, OPENWA_ADMIN_API_KEY (facoltativa), OPENWA_WEBHOOK_SECRET e APP_URL (indirizzo pubblico del pannello).

SMS

Gli SMS arrivano nella pagina Richieste tramite l’app SMS Gateway installata sul telefono Android della radio, che inoltra ogni SMS ricevuto (evento sms:received) al pannello. Ogni radio ha una sua chiave di firma: un messaggio intercettato non può essere reinviato a un’altra emittente. La configurazione la fa lo staff di RadioPanel; sul server la chiave si imposta con SMS_WEBHOOK_SECRET_<CODICE> (es. SMS_WEBHOOK_SECRET_RADIOESEMPIO).

Notifiche del browser

Le notifiche del pannello arrivano come notifiche del computer o del telefono anche con il pannello chiuso, purché il browser sia aperto. Ogni persona le attiva in Modifica Profilo → Dispositivi e avvisi; l’app desktop le riceve anche con la finestra chiusa. Come funzionano per chi le usa: Muoversi nel pannello.

Per chi gestisce il server:

il pannello deve essere in https://, con le estensioni OpenSSL e cURL di PHP;
le chiavi VAPID vengono create da sole al primo uso e salvate nel database; in alternativa si impostano con VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY e VAPID_SUBJECT.

Le notifiche si inviano solo ai servizi push dei browser.

Nextcloud

Se la radio usa Nextcloud, il pannello si può aprire da Nextcloud già connesso, senza password, con l’app Siti esterni (External sites) di Nextcloud.

In Nextcloud aggiungi un sito esterno con questo indirizzo, sostituendo il codice della radio:
```
https://pannello.example.it/autologin.php?codename=radioesempio&jwt={jwt}
```
Nextcloud sostituisce {jwt} con un token firmato per l’utente connesso.
Lo staff di RadioPanel configura sul server la chiave pubblica di Nextcloud (AUTOLOGIN_NEXTCLOUD_PUBKEY) e il suo indirizzo (AUTOLOGIN_NEXTCLOUD_URL).

Il pannello apre l’account con lo username uguale al nome utente di Nextcloud, sulla radio indicata. Il token vale pochi minuti: un link rimasto nella cronologia non apre più nulla.

Ricostruzione automatica del sito

Con il deploy hook del sito (ad esempio Cloudflare Pages) il pannello ricostruisce il sito della radio da solo quando cambiano programmi, palinsesto o profili pubblici. Si imposta in Palinsesto → Impostazioni: Aggiornare il sito da solo.