LogoLogo
v1.3
v6.0v5.2v5.1v5.0v4.0v3.0v2.4v2.3v2.2v1.3v1.2
v1.3
v6.0v5.2v5.1v5.0v4.0v3.0v2.4v2.3v2.2v1.3v1.2
  • 🏠Per iniziare
  • 🕗Changelog
  • 🔢Setup iniziale
  • Funzionalità
    • 📦Creare un servizio
      • Dati obbligatori
        • Attributi
        • Service Metadata
      • Controllo di qualità
      • Come visualizzare un servizio in test
    • ✉️Inviare un messaggio
      • Controllo pre-invio
      • Invio messaggio
      • Controllo post-invio
      • Invio messaggi di test
  • 📐API
    • OpenAPI
    • API Messaggi
      • Get a User Profile using POST
      • Submit a Message passing the user fiscal_code in the request body
      • Get Message
      • Get Subscriptions Feed
      • ⚠️Get a User Profile
      • ⚠️Submit a Message passing the user fiscal_code as path parameter
    • API Servizi
      • Create Service
      • Get User Services
      • Get Service
      • Update Service
      • Regenerate Service Key
      • Upload service logo
      • Upload organization logo
    • Errori comuni
    • Specifiche API
  • 🔑Abilitazioni
    • Test con codici fiscali reali
    • Test invio avvisi pagoPA
    • Invio messaggi massivo
    • Subscription feed
    • Gestione dei servizi
  • Risorse Utili
    • ❓Domande frequenti
    • 📘Glossario
Powered by GitBook
On this page
  1. Funzionalità

Inviare un messaggio

PreviousCome visualizzare un servizio in testNextControllo pre-invio

Last updated 2 years ago

L’invio di messaggi è la prima tipologia di comunicazione messa a disposizione dalle API di IO.

I messaggi sono comunicazioni personali dirette ad uno specifico cittadino identificato tramite il suo codice fiscale. Non è possibile inviare messaggi ad un gruppo di cittadini, ogni messaggio deve essere personale e diretto ad ogni cittadino.

Il processo di invio dei messaggi prevede di eseguire tre passaggi:

  1. Controllo pre-invio

  2. Invio messaggio

  3. Controllo post-invio

Nella guida troverai una spiegazione dei controlli da effettuare per ogni passaggio, insieme a un esempio. Per la documentazione completa delle API fai riferimento alla .

Importante

Tutte le API di IO possono restituire delle risposte di errore. È necessario implementare lato client dei meccanismi per la corretta gestione di questo tipo di risposte.

Esempio: tutte le API possono restituire lostatus code 429 che rappresenta un segnale di sovraccarico dell’infrastruttura di IO: in questo caso è necessario implementare un meccanismo di retry e diminuire il rate delle richieste inserendo delle pause.

✉️
documentazione specifica