Varslingsmaler¶
Varslingsmaler definerer innhold og kanal for alle varslinger som sendes fra ePortal — både planlagte og hendelsesutløste. Hver mal består av en kanal (e-post, SMS eller in-app), et emne, en tekstkropp med plassholdere, og valgfrie betingelser. Samme mal kan brukes av flere varslingsplaner, slik at endringer i tekst kun gjøres ett sted.
Tilgang¶
| Hvem | Hva trengs |
|---|---|
| Rolle som kan endre | Administrator |
| Modul som kreves | Portalinnstillinger (Settings) — moduleID 99 |
| Effekt på hvem | Alle mottakere av varslinger som bruker malen |
System-leverte standardmaler kan kopieres til tenant-spesifikke versjoner, men ikke endres direkte — dette beskytter mot at oppgradering overskriver lokal tilpasning.
Innstillinger¶
| Innstilling | Betydning | Standard | Konsekvens | Tilgang |
|---|---|---|---|---|
| Aktiv | Bryter som styrer om malen kan brukes | På | Når av: planer som peker på malen feiler ved kjøring | Administrator |
| Navn | Internt visningsnavn på malen | Tom | Brukes i mal-listen og når plan velger mal | Administrator |
| Beskrivelse | Forklaring av når malen brukes | Tom | Hjelper neste administrator å forstå hensikt | Administrator |
| Kanal | E-post, SMS eller in-app | E-post | Bestemmer leveransevei og maksimal lengde | Administrator |
| Språk | Hvilket språk malen er skrevet i | no (norsk) | Brukes til å velge riktig mal for flerspråklige tenants | Administrator |
| Emne | Emnefelt (kun e-post og in-app) | Tom | Vises i innboks; god emne-tekst øker åpningsrate | Administrator |
| Kropp | Selve meldingsteksten med plassholdere | Tom | Det mottakeren faktisk leser | Administrator |
| Plassholdere | Variabler som fylles inn dynamisk ved utsending | n/a | Feil syntaks gir tom tekst eller råtekst-utsending | Administrator |
| Avsender (navn / e-post) | Vises som "Fra" i mottakerens innboks | Tenant-standard | Påvirker spam-vurdering og merkevareopplevelse | Administrator |
| Vedlegg-policy | Om malen kan ha vedlegg (kun e-post) | Ingen vedlegg | Vedlegg øker leveransefare ved spamfilter | Administrator |
Detaljert beskrivelse per innstilling¶
Aktiv¶
Betydning. Bryter som styrer om malen er tilgjengelig for nye planer og om eksisterende planer kan bruke den. Sett til av for å fase ut en mal uten å slette den.
Gyldige verdier. Av eller på.
Standardverdi. På for nye maler du oppretter manuelt; av for kloner av systemmaler inntil du har validert dem.
Når trer endringen i kraft. Umiddelbart. En kjøring som allerede har lest malen i minne bruker den, men neste kjøring leser på nytt.
Påvirker historiske data. Nei. Tidligere sendte varslinger med malen forblir i varslingslogg.
Konsekvens for andre moduler.
- Varslingsplaner — planer som peker på en inaktiv mal logges som feil ved kjøring og sender ikke.
- Hendelsesvarsling — hendelser som utløser denne malen feiler likt.
Avhengigheter. Ingen.
Hvem kan endre. Administrator.
Navn¶
Betydning. Visningsnavn som administratorer ser i mal-listen og i plan-konfigurasjonen.
Gyldige verdier. Fri tekst, 3–80 tegn. Anbefalt: prefix med modul (Time: ukerapport, HMS: avvik over 7 dager).
Standardverdi. Tom — må fylles inn.
Når trer endringen i kraft. Umiddelbart.
Påvirker historiske data. Tidligere logginnslag beholder gammelt navn til ny utsending med oppdatert mal.
Konsekvens for andre moduler. Vises i varslingsplaner og varslingslogg.
Avhengigheter. Ingen.
Hvem kan endre. Administrator.
Beskrivelse¶
Betydning. Internt notat om hvorfor malen finnes og hvilke scenarioer den dekker. Vises kun i admin-grensesnittet, aldri for sluttbruker.
Gyldige verdier. Fri tekst opp til 500 tegn.
Standardverdi. Tom.
Når trer endringen i kraft. Umiddelbart.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Ingen — kun dokumentasjonsverdi.
Avhengigheter. Ingen.
Hvem kan endre. Administrator.
Kanal¶
Betydning. Bestemmer hvilken leveransevei varselet sendes over.
Gyldige verdier.
- E-post — krever konfigurert SMTP eller transaksjons-e-post-leverandør på systemnivå.
- SMS — krever konfigurert SMS-gateway og at mottaker har gyldig mobilnummer.
- In-app — vises i ePortal-innboks ved neste innlogging eller via push.
Standardverdi. E-post.
Når trer endringen i kraft. Umiddelbart for nye utsendinger.
Påvirker historiske data. Nei.
Konsekvens for andre moduler.
- Mottakere — bytte fra e-post til SMS kan ekskludere mottakere uten mobilnummer.
- Kostnad — SMS koster per melding; bryteren påvirker driftskostnad.
- Lengde — SMS har 160-tegns segmenter; lange maler splittes og fordyres.
Avhengigheter. Krever at valgt kanal er konfigurert og aktivert på systemnivå.
Hvem kan endre. Administrator.
Språk¶
Betydning. Hvilket språk malens emne og kropp er skrevet i. ePortal velger riktig mal-versjon basert på mottakers språkpreferanse hvis det finnes flere språkvarianter med samme navn.
Gyldige verdier. no (norsk) eller en (engelsk).
Standardverdi. no.
Når trer endringen i kraft. Umiddelbart.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Mottakere uten matchende språkpreferanse får standardspråk-malen.
Avhengigheter. Ingen.
Hvem kan endre. Administrator.
Emne¶
Betydning. Emnefeltet i e-post og overskriften i in-app-varsel. Brukes ikke for SMS.
Gyldige verdier. Fri tekst, anbefalt under 60 tegn for god visning i innbokser. Støtter samme plassholdere som kroppen.
Standardverdi. Tom — påkrevd for e-post og in-app.
Når trer endringen i kraft. Neste utsending.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Lange emnetekster trunkeres i innboks-visningen og kan ligne spam.
Avhengigheter. Ingen.
Hvem kan endre. Administrator.
Kropp¶
Betydning. Selve meldingsteksten. Støtter ren tekst og enkel HTML for e-post, ren tekst for SMS, og markdown for in-app.
Gyldige verdier. Fri tekst med plassholdere i {krøllparenteser}. Maks lengde varierer per kanal:
- E-post — ingen praktisk grense, men over 100 KB anbefales ikke.
- SMS — 160 tegn per segment; over dette gir multi-segment-utsending.
- In-app — anbefalt under 1000 tegn for god lesbarhet.
Standardverdi. Tom — påkrevd.
Når trer endringen i kraft. Neste utsending.
Påvirker historiske data. Nei. Tidligere sendte varslinger har sin egen kopi i logg.
Konsekvens for andre moduler. HTML i e-post må være enkel — komplekse layouts brytes i Outlook og enkelte webmail-klienter.
Avhengigheter. Plassholderne må stemme overens med konteksten malen brukes i.
Hvem kan endre. Administrator.
Plassholdere¶
Betydning. Variabler som erstattes med konkrete verdier ved utsending. Brukes i både emne og kropp.
Gyldige verdier. Plassholdere skrevet som {navn}. Tilgjengelige plassholdere avhenger av konteksten:
{brukerNavn}— mottakerens fulle navn{brukerFornavn}— mottakerens fornavn{tenant}— tenant-/firmanavn{dato}— dagens dato i lokalt format{antallÅpneTimer},{ukenummer},{prosjektNavn}— kontekstavhengig{lenke}— direktelenke inn i ePortal
Standardverdi. n/a — du legger inn plassholderne selv.
Når trer endringen i kraft. Neste utsending.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Ukjent plassholder (skrivefeil eller utgått) erstattes med tom streng — mottaker ser hull i teksten.
Avhengigheter. Plassholderen må være tilgjengelig i konteksten der malen brukes — {antallÅpneTimer} gir tom streng i en HMS-mal.
Hvem kan endre. Administrator.
Avsender (navn / e-post)¶
Betydning. Hvem varselet vises å komme fra i mottakerens innboks. Påvirker tillit, åpningsrate og spam-vurdering.
Gyldige verdier. Gyldig e-postadresse + visningsnavn. Domenet bør være verifisert i tenantens e-postoppsett (SPF/DKIM).
Standardverdi. Tenantens standard-avsender konfigurert på systemnivå.
Når trer endringen i kraft. Neste utsending.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Bruk av uverifisert domene kan trigge spamfilter — verifiser SPF/DKIM hos e-postleverandøren.
Avhengigheter. E-postleverandøren må tillate sending fra valgt avsender-adresse.
Hvem kan endre. Administrator.
Vedlegg-policy¶
Betydning. Styrer om malen kan ha vedlegg ved utsending (typisk rapport-PDF eller eksport).
Gyldige verdier.
- Ingen vedlegg — sikrest, raskest leveranse.
- Ett vedlegg — typisk PDF-rapport.
- Flere vedlegg — kun ved spesielle bruksområder.
Standardverdi. Ingen vedlegg.
Når trer endringen i kraft. Neste utsending.
Påvirker historiske data. Nei.
Konsekvens for andre moduler. Vedlegg øker e-poststørrelse og kan trigge spamfilter eller maksstørrelse hos mottaker.
Avhengigheter. Krever at konteksten genererer et vedlegg — uten kilde sendes meldingen uten vedlegg.
Hvem kan endre. Administrator.
Slik oppretter eller endrer du en mal¶
- Åpne Innstillinger → Portalinnstillinger → Planlagte varslinger → Maler (
/settings/portal-setting/scheduled-notifications?tab=templates). - Klikk + Ny mal, eller velg eksisterende mal for redigering.
- Fyll inn
Navn,Beskrivelse,KanalogSpråk. - Skriv
Emne(e-post / in-app) ogKropp. - Sett inn plassholdere ved å klikke i plassholder-velgeren — den lister kun plassholdere som er tilgjengelige i forventet kontekst.
- Klikk Send testvarsel for å sende én utsending til deg selv før produksjonsbruk.
- Klikk Lagre.
Vanlige problemer¶
Plassholderen vises som råtekst i mottakerens innboks¶
Plassholderen finnes ikke i konteksten malen ble brukt i, eller du har skrevet {Brukernavn} istedenfor {brukerNavn} (case-sensitiv). Sjekk listen over tilgjengelige plassholdere i editoren.
E-posten havner i spam¶
Sjekk: (1) avsender-domenet har gyldig SPF/DKIM, (2) emne ikke består av kun store bokstaver eller mange utropstegn, (3) ingen lange URL-er uten kontekst, (4) lange vedlegg unngås. Bruk e-postleverandørens deliverability-rapport.
SMS sendes ut i flere segmenter (dyrere)¶
Kroppen er over 160 tegn. Forkort tekst, eller bruk lenke til ePortal i stedet for å gjengi all info i SMS.
Endring i mal påvirker ikke utsending¶
Du har sannsynligvis endret malen mens en kjøring var i gang. Neste kjøring vil bruke ny tekst. Hvis det fortsatt ikke fungerer, sjekk at malen er Aktiv og at planen peker på riktig mal-ID.
Jeg vil rulle tilbake til system-leveransen¶
Slett tenant-versjonen — neste kjøring faller tilbake til system-malen. Du mister lokal tilpasning.
Konsekvensanalyse før endring¶
Før du endrer en mal som er i bruk, vurder:
- [ ] Hvor mange aktive planer bruker malen? Endring slår inn på alle samtidig.
- [ ] Er nye plassholdere tilgjengelige i alle konteksterne malen brukes i? Tom plassholder skaper rare hull i teksten.
- [ ] Endrer du kanalen? Bytte fra e-post til SMS kan ekskludere mottakere uten mobilnummer.
- [ ] Er testvarsel sendt og verifisert i faktisk e-post-/SMS-klient? Visning i editoren er ikke pålitelig.
- [ ] Har du en plan for tilbakeruling? Lagre gammel tekst i
Beskrivelseeller eksternt før endring.
Relaterte sider¶
- Varslingsplaner — kobler mal til tidsplan og mottakere
- Varslingslogg — viser hvilken mal som ble brukt for hver utsending
- Innstillinger for varslinger
- Innstillinger — oversikt
- Administrator-rollen