Tabella dei contenuti
Compilazione delle schede
Le schede servizio contengono la descrizione dello specifico servizio offerto dall’ente e i dati di contatto a disposizione dell’utenza per approfondire il contenuto del servizio o inoltrare specifiche domande. La scheda servizio può essere compilata per ciascun servizio all’interno del back-office, nei campi associati a ciascun servizio-chiave API.
Di seguito vengono elencati i campi obbligatori per la compilazione della scheda servizio, e alcune regole per la compilazione:
- service_name:
il nome del servizio, che indica agli utenti a quale ambito fanno riferimento le comunicazioni che riceve in app (es. tributi). Il nome del servizio viene mostrato come mittente del messaggio (insieme al nome dell’ente). - organization_name:
il nome dell’ente che offre il servizio. Deve riportare il nome completo della pubblica amministrazione aderente, ad esempio “Comune di Varese” (non “Varese”). - organization_fiscal_code:
il codice fiscale dell’ente che eroga il servizio. - privacy_url:
l’indirizzo web ove è pubblicata l’informativa privacy del servizio. - description:
la descrizione testuale in formato markdown che indica l’oggetto del servizio e chiarisce nel dettaglio cosa l’utenza può aspettarsi di ricevere tramite app IO (vedi tab 3 del template). - contatti:
almeno uno o più canali di contatto diretto a cui un utente può chiedere assistenza, a scelta tra: phone, mail, pec, support_url - service_logo e/o organization_logo:
l’immagine in formato png 300x300 pixel (fondo bianco o trasparente) del logo del servizio e del logo dell’ente. Il logo dell’ente è obbligatorio, mentre il logo del servizio è di default uguale al logo dell’ente, ma può essere aggiunto come logo indipendente nei casi in cui il servizio abbia un logo diverso da quello dell’ente. - service_scope:
l’area geografica di riferimento di un servizio può essere locale (local) o nazionale (national). Tutti gli enti che servono un territorio delimitato (regione, comune, distretto,...) - non corrispondente all’intera nazione - devono impostare i propri servizi con lo scope “local”. - authorized_cidrs:
uno o più indirizzi IP separati da ; da cui provengono le chiamate al back-end di IO, per le relative chiavi API/servizio (ad esempio 192.168.10.11/32;172.16.30.24/32). Questo è un blocco di sicurezza che inibisce le chiamate provenienti da altri indirizzi IP, che cercano di operare per quei servizi.
In aggiunta ai campi obbligatori, sono disponibili alcuni campi aggiuntivi facoltativi:
- tos_url:
l’indirizzo web a cui l’utenza può rivolgersi per consultare i termini e condizioni del servizio (se pubblicati); - address:
l’indirizzo fisico dell’ufficio di riferimento per il servizio, utile se un utente ha necessità di chiedere maggiori informazioni recandosi presso uno sportello o inviando delle comunicazioni in formato analogico; - app_ios e app_android:
il link all’eventuale app che l’ente mette a disposizione su Apple Store e Google Play per offrire la stessa funzione o lo stesso servizio offerto tramite App IO - web_url:
l’indirizzo web a cui l’ente mette a disposizione il medesimo servizio o maggiori informazioni relative al servizio.
Hai bisogno di aiuto?
Scrivi un’email in cui descrivi il tuo problema o dubbio all’indirizzo onboarding@io.italia.it
Dicci cosa ne pensi
Per segnalare problemi o dare feedback, lascia un commento nello spazio Github dell'app IO