📜Come inviare un Messaggio
Facendo riferimento al procedimento indicato nella Guida Tecnica per l'integrazione ai servizi, dove puoi trovare tutte le informazioni preliminari e di dettaglio, qui ti forniamo un esempio pratico di invio di un Messaggio.
Assicurati che il cittadino possa ricevere il tuo messaggio
Aggiungi l'header
Ocp-Apim-Subscription-Key
e valorizzalo con la chiave (primaria o secondaria) del tuo Servizio IO: puoi recuperarla accedendo all'Area Riservata e cercando la scheda del tuo Servizio nella pagina "Servizi"Componi la request per l'API di invio, della quale ti forniamo qui un esempio:
il campo
subject
è il titolo del messaggio e comparirà in testa allo stesso:il campo
markdown
è il corpo del messaggio e, come suggerito dal nome, supporta lo standard Markdown per la formattazione del testo e l'inserimento di intestazioni, liste puntate/numerate, tabelle, link e immagini; per sapere come comunicare al meglio con la tua utenza su IO consulta la sezione dedicata nel Manuale dei Serviziil campo
fiscal_code
è il codice fiscale del Cittadino destinatario del messaggiose richiesto, aggiungi anche il campo
due_date
per indicare la data di scadenza; poni attenzione al formato richiesto dalle specifiche tecniche e alle considerazioni sui fusi orari riportate nella Guida Tecnica! Nell'esempio, la data di scadenza è impostata in modo che il Cittadino possa pagare entro il termine della giornata del 31 marzo 2023 (a marzo non è in vigore l'ora legale e dunque in Italia il fuso è UTC+1)
Se hai sottoscritto l'Accordo Premium, puoi abilitare il tuo messaggio a usufruire delle caratteristiche avanzate offerte dal programma aggiungendo alla request il campo "
feature_level_type
"="ADVANCED"
: potrai, ad esempio, sapere se il messaggio è stato letto oppure potrai allegarvi documenti PDF.
Per conoscere tutti i vantaggi del programma Premium fai riferimento alla risposta specifica sull'argomento.
Invoca l'API di invio richiamando in
POST
l'endpointhttps://api.io.pagopa.it/api/v1/messages
Prendi nota dell'identificativo del Messaggio che IO ti comunica in risposta: ti servirà per conoscere il suo stato di processamento e, se sei cliente Premium, usufruire delle caratteristiche a valore aggiunto offerte dal Programma
Se l'API ti ritorna un errore 429 significa che hai raggiunto il limite di invocazioni nell'unità di tempo assegnato al tuo account: semplicemente, riprova e la richiesta sarà accettata.
Se vuoi ottenere maggiore capacità nell'utilizzo delle API di integrazione con IO, consulta le funzionalità offerte dal Programma Premium.
Ecco cosa vedrà il Cittadino aprendo App IO quando riceverà il tuo messaggio:
Last updated