User guides
User guides in Altinn Notifications
Guidelines on notification content
How does a notification look?
End users can receive notifications via SMS, email, or both. This is determined by the type of address information end users have registered in their Altinn profile, but the service owner also has the option to override this.
The notification should include:
- a description of the task,
- specifically what it concerns,
- who is responsible for/can resolve the task
- if applicable, also inform about the deadline for the task
What should a notification not contain?
Phishing poses an ever-increasing threat to IT security. Government guidelines for avoiding fraud state the following: Be aware of links in SMS messages that ask you to log in with BankID. Your bank or other reputable organizations never send BankID login links via SMS.
Therefore, pay particular attention that notifications sent through Altinn’s notification service MUST NOT contain links or phrasing that resembles a link, e.g. altinn.no or minetat.no. In such cases, “Altinn’s website”, “our website” or similar would be the correct phrasing to use.
Guides for specific order types
Creating a new Maskinporten Client
A Maskinporten Client, also known as a Maskinporten Integration, can generate tokens with a set of scopes on request. The token must then be exchanged for an Altinn token and used to gain access to the API.
The scope altinn:serviceowner/notifications.composedemail.create is required for clients to access the Composed Notifications API.
The scope altinn:serviceowner/notifications.create is required for clients to access the Notifications and Instant Notifications APIs.
All registered service owners have been delegated altinn:serviceowner/notifications.create by Digdir and should be able to find it in their list of scopes in Samarbeidsportalen.
Register your Maskinporten client(s) to authenticate with the Notifications API, assigning them this scope.
Please reference Maskinporten’s own documentation on registering a new integration through their self service API.
For a guide on how to register a new Maskinporten integration in Samarbeidsportalen, please see Altinn Authorization