Tabella dei contenuti
Inviare un messaggio
Cosa sono i messaggi?
L’invio di messaggi è la prima tipologia di comunicazione messa a disposizione dalle API di IO.
I messaggi sono comunicazioni personali dirette a un cittadino specifico, identificato tramite il suo Codice Fiscale. Questo significa che non è possibile inviare messaggi a più cittadini con una sola chiamata.
Che tipologie di messaggi esistono?
Ci sono due tipologie di messaggi:
- Standard, ovvero i messaggi che possono inviare tutti gli enti che hanno sottoscritto un contratto a regime tradizionale;
- Premium, ovvero i messaggi che possono inviare tutti gli enti che hanno sottoscritto un contratto a regime Premium.
Al momento dell'invio, gli enti che hanno aderito al programma Premium possono indicare, per ciascun messaggio da inviare, se questo sia Premium - e dunque scalato dal carnet, secondo le condizioni sottoscritte - oppure standard.
Come funziona l'invio dei messaggi?
Step 1 - Crea un servizio
Per inviare un messaggio, devi prima creare-un-servizio.
Step 2 - Testa il contenuto del messaggio
Prima di andare in produzione puoi testare il contenuto dei messaggi, che verranno inviati all'indirizzo email del delegato. Leggi la pagina Messaggi di test.
Step 3 - Verifica di poter contattare il destinatario
Ogni volta che invii un messaggio, devi assicurarti che il destinatario esista e che abbia dato il consenso a ricevere comunicazioni per quello specifico servizio.
Per maggiori informazioni scopri le API Get a User Profile using POST e Get Subscriptions Feed.
Step 4 - Invia il messaggio
Per farlo, usa l'API Submit a Message passing the user fiscal_code in the request body.
Puoi anche aggiungere allegati al messaggio, sfruttando una delle funzionalità del programma Premium. Per maggiori informazioni leggi aggiungere-allegati-premium.
Step 5 - Controlla l'esito
Interroga l’API Get Message, utilizzando il Codice Fiscale del destinatario e l’identificativo del messaggio ottenuto nello step precedente.
Gestione degli errori
Tutte le API di IO possono restituire delle risposte di errore, definite nelle specifiche di ciascuna API_._ È necessario implementare lato client dei meccanismi per la corretta gestione di questo tipo di risposte.
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