DevPortalPagoPA

SoluzioniWebinar
Tabella dei contenuti

📜 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 esempi pratici di invio di un Messaggio.
  1. Componi la request per l'API di invio, della quale ti forniamo qui esempi a seconda dello scenario di utilizzo:
1{
2    "feature_level_type": "STANDARD",
3    "content": {
4        "subject": "Partecipazione Evento",
5        "markdown": "Gentile Mario Rossi,\n\r\n\rabbiamo accettato la tua richiesta di partecipazione all'\''evento e ti inviamo in allegato la ricevuta del pagamento della tua quota e la brochure con tutte le informazioni utili.\n\rA Ti aspettiamo!\n\rL'\''Amministrazione Comunale di Ipazia.",
6        "due_date": "2023-03-30T23:59:59.000Z"
7    },
8    "fiscal_code": "AAAAAA00A00A000A"
9}
10
  • il campo subject è il titolo del messaggio e comparirà nell'elenco dei messaggi e in testa allo stesso aprendone il contenuto:
An image
An image
1{
2    "feature_level_type": "STANDARD",
3    "content": {
4        "subject": "Conferma prenotazione",
5        "markdown": "",
6            "id": "c89069c2-f049-401b-8e6d-d1f5d3ee8f73",
7            "configuration_id": "0e9852ccb8a04128bd637c807b9d80d3",
8            "has_remote_content": true,
9        }
10    },
11    "fiscal_code": "AAAAAA00A00A000A"
12}
13
  • il campo fiscal_code è il codice fiscale del Cittadino destinatario del messaggio
  • se 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)
  1. Assicurati che il cittadino possa ricevere il tuo messaggio
  2. 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"
    An image
  3. Invoca l'API di invio richiamando in POST l'endpoint https://api.io.pagopa.it/api/v1/messages
  4. 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
1{
2    "id": "01GS8744E24EZDG3XD5ECXB9RG"
3}
4
  1. Ecco cosa vedrà il Cittadino aprendo App IO quando riceverà il tuo messaggio:\
    An image

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