Aan de slag met Notificaties

🧑‍💼 Voor beleidsmakers

Met de Notificaties-bouwsteen kunnen Vlaamse en lokale overheidsdiensten hun doelgroepen proactief informeren, zonder dat burgers of organisaties zelf voortdurend moeten controleren of er iets gewijzigd is. Zo verhoogt Notificaties de transparantie van uw dienstverlening en de bereikbaarheid van uw boodschappen.

Notificaties ondersteunt via de gekende contactvoorkeuren:

• passieve notificaties die worden getoond via het bel‑icoon in digitale loketten en in de Brievenbus van Mijn Burgerprofiel

• actieve notificaties of e‑mailnotificaties (en, waar ondersteund, pushberichten) naar de bestemmeling

• notificatiebundels om één gestructureerd verzoek om een bericht via één of meerdere kanalen naar één of meerdere bestemmelingen te sturen

Typische scenario’s

• Welkomstberichten en belangrijke service‑meldingen

• Algemene nieuwsberichten of campagnecommunicatie

• Meldingen over wijzigingen in een lopend dossier, gekoppeld aan Dossierstatusinformatie (DOSIS)

• Vrije notificaties over andere relevante gebeurtenissen (bijv. afspraakherinneringen, wijzigingen in openingsuren, …)

🧠 Voor analisten

Notificaties is een bouwsteen die via een gestandaardiseerde REST‑API notificaties/notificatiebundels ontvangt en distribueert. Elke notificatie/notificatiebundel bevat:

• metadata zoals:

  • ID van de notificatiebundel

  • Transactie-ID om meerdere notificaties voor dezelfde bestemmeling te groeperen

  • Product-ID (IPDC) voor koppeling met uw dienstverlening

  • gekozen kanalen (passief / e‑mail)

  • categorie (bijv. vrije notificatie, vervaldagbericht)

  • verzenddatum (optioneel, voor uitgestelde verzending)

  • vervaldatum (voor passieve notificaties in Mijn Burgerprofiel)

• informatie over bestemmelingen (burger, organisatie of contactadressen)

• de eigenlijke boodschap (titel, body, optionele links, …), eventueel meertalig

Zo kunt u in uw eigen log‑ en analysetools onder meer monitoren:

• hoeveel notificaties u uitstuurt per product/dienst

• via welke kanalen u communiceert

• hoe vaak u specifieke categorieën gebruikt (welkomst, vervaldag, vrije notificatie, …)

• in welke taal u communiceert met uw doelgroepen

Wanneer u Notificaties combineert met DOSIS:

• kunt u opvolgen voor welke IPDC‑producten u dossierstatusupdates + notificaties aanbiedt

• krijgt u een vollediger beeld van het digitale traject dat burgers of organisaties doorlopen (aanvraag → statusopvolging → meldingen)

👩‍💻 /👨‍💻 Voor ontwikkelaars

De Notificaties‑bouwsteen is volledig API‑gebaseerd en wordt beveiligd via ACM/IDM (OAuth 2.0). Via de ACM-beveiligde REST-API’s kunnen ook notificaties over dossierupdates worden verstuurd, afgestemd op de gekende contactvoorkeuren van de gebruiker - zoals e-mail of via Mijn Burgerprofiel. Zo integreert u proactieve communicatie in uw applicaties.

Test

• Configuratie en beheer: https://tni.notificatie.dev-vlaanderen.be/Notificaties

• API’s:

  • basis-endpoint: https://notificaties.api.tni-vlaanderen.be/

  • endpoint om notificatiebundels te versturen: https://notificaties.api.tni-vlaanderen.be/api/v2/notificaties

• Front-end:

  • Mijn Burgerprofiel: https://burgerprofiel.tni-vlaanderen.be/
    
    

  • e-loket ondernemers: https://test.e-loketondernemers.be/
    Gebruikersnaam en wachtwoord krijgt u van Vlaio.
    Zodra u bent aangemeld in de testomgeving van het e-loket ondernemers, kunt u uw claims zien via https://cms.test.e-loketondernemers.be/jwt
    
    

  • Verenigingsloket:

Productie

• Configuratie: https://prod.notificaties.vlaanderen.be/Notificaties

• API’s:

  • basis-endpoint: https://notificaties.api.vlaanderen.be/

  • endpoint om notificatiebundels te versturen: https://notificaties.api.vlaanderen.be/api/v2/notificaties
    📌 Op het productie‑endpoint geldt “rate limiting” van 1800 calls/minuut
    
    

• Front-end: cf. de digitale hoofdloketten Mijn Burgerprofiel, https://www.e-loketondernemers.be/nl en het Verenigingsloket

📌 Welke kanalen en IPDC‑producten effectief notificaties tonen, hangt af van uw configuratie per product en per loket.

📌 Een ticket aanmaken in de Servicedesk kan alleen voor wie al een aansluiting op Notificaties heeft.

Configuratie

Beheer Notificaties (afzenders, categorieën, koppeling met IPDC‑producten, kanalen, …) via:

• TNI: https://tni.notificatie.dev-vlaanderen.be/Notificaties

• Productie: https://prod.notificaties.vlaanderen.be/Notificaties

Hiervoor zijn aanmelden en specifieke toegang vereist

Gebruikersrechten toekennen en beheren

Geef gebruikers de nodige rechten en beheer de rechten tot uw digitale toepassingen met het Gebruikersbeheer van Digitaal Vlaanderen. Het gebruikersrecht is Notificaties Gebruiker. Binnen dat gebruikersrecht is de context Notificaties Import nodig.

Om te controleren of u de juiste gebruikersrechten en context heeft, zie Toegangsrechten opzetten voor Notificaties | Hoedanigheid controleren (whoami)Preview .