Sist endret: 29. sep. 2025

Altinn App-integrasjon

Slik kommer du i gang med å sende varsler fra en Altinn App.

1. Opprett og konfigurer din Altinn App

Start med å opprette og konfigurere din Altinn App ved hjelp av Altinn Studio og din foretrukne kodeeditor. Sørg for at appen din bruker versjon 8.1.0 eller høyere av NuGet-pakkene for å aktivere innebygde varsler. For optimal ytelse og sikkerhet, bruk alltid den nyeste stabile versjonen.

For detaljert veiledning om utvikling av Altinn App, se Altinn Studio-dokumentasjonen.

2. Se over retningslinjer for relevante ressurser i Altinn Ressursregister

Koblingen av et varsel til en ressurs, ved å benytte resourceId-attributtet, innebærer at ressursens policy brukes for å identifisere de korrekte mottakerne av varselet. Alle tiltenkte mottakere må ha read-tilgang gjennom ressursens policy.

Om ressurser og hvem som mottar1 varsler:

  • Varsler til privatpersoner (fødselsnummer), eksplisitt e-postadresse eller telefonnummer -> resourceId har ingen effekt
  • Varsler til organisasjonsnummer:
    • Organisasjonens lovpålagte kontaktinformasjon (på virksomhetsnivå) brukes alltid
    • Uten spesifisert resourceId -> kun lovpålagt kontaktinformasjon brukes
    • Med resourceId -> i tillegg til den lovpålagte mottakeren varsles enhver person som oppfyller alle kriteriene under:
      • Personen må ha konfigurert sin “egendefinerte kontaktinformasjon” for mottakerorganisasjonen
      • Personen må ha read-tilgang til ressursen gjennom ressursens policy 2
      • Personen må ikke ha valgt bort varsler for denne tjenesten 3

Om ressurser og policyer

En ressurs kan i dette tilfellet både være en Altinn App eller en ressurs (tjenesteeierressurs).

En ny Altinn-ressurs kan registreres i Altinn Studio eller gjennom et API. Se Altinn Ressursadministrasjon for instruksjoner om hvordan du oppretter en ny ressurs.

Policyen for både Altinn Apps og andre Altinn-ressurser kan administreres i Altinn Studio. Se Altinn Studio-dokumentasjonen for hvordan du gjør dette.

  1. Se Adresseoppslag for flere detaljer om hvordan adresseoppslag fungerer. ↩︎

  2. For Altinn Apps må du også sikre at tilgangssubjektet har read-tilgang for alle relevante oppgaver og hendelser. ↩︎

  3. Brukere velger aktivt inn tjenester, noe som betyr at tjenester som ikke er valgt inn, regnes som valgt bort. Dette innebærer at dersom en bruker har valgt inn en Altinn 2-tjeneste på et tidspunkt, har de i praksis valgt bort alle andre tjenester - inkludert en eventuell re-implementering i Altinn 3. Alle Altinn 2-ressurser (tjenester) overføres over til Altinn 3, men brukeren har derfor ofte (uten å være klar over det) effektivt valgt å ikke motta varsler for den nye Altinn 3-ressursen. ↩︎

3. Forstå retningslinjer og beste praksis for sending av varsler

For å sikre effektiv kommunikasjon er det viktig å strengt definere hva som kvalifiserer som et varsel og unngå å overvelde brukere med for mange meldinger.

Gjør deg kjent med våre retningslinjer for å forstå hva varsler bør og ikke bør inneholde, for å fremme digital sikkerhet og forhindre varslingstretthet.

4. Sett opp appen din for å sende varsler

Følg instruksjonene i Altinn App-referansedokumentasjonen for å konfigurere appen din for sending av varsler.