Altinn / altinn-correspondence

Meldingstjenesten
3 stars 1 forks source link

Opprette templates for varsling #100

Closed RagnarFatland-Avanade closed 1 month ago

RagnarFatland-Avanade commented 5 months ago

Det etableres ett sett faste templates for E-post og SMS varsler som skal sendes via Altinn Notification.

Templates består av en predefinert standardtekst, og støtte for inntil 1 TextToken per tekst-felt og samme standard-makroer som benyttes av Notification, detaljert her: https://github.com/Altinn/altinn-notifications/issues/545 TextTokens kan inneholde makroer.

I tillegg vurder å legge til egne makroer som gir mening for Correspondence:

En Template består av:

Dersom ingen texttokens er angitt benyttes tom streng som replace-verdi. I denne kontekst bør kanskje texttoken-felt være en gitt, navngitt liste ala "EmailSubjectTextToken" istedenfor en nummerert liste som angitt under??

Correspondence tar ansvar for å fylle ut TextTokens før vi sender videre til Notification, mens Notification fyller ut makroene.

Forslag til templates; bør diskuteres ytterligere;

Template 1: TextTokenOnly Denne dekker det mest generiske tilfellet, der avsender sender hele meldingsteksten som TextToken. (Tilsvarer den mest brukte enkelt-template i Altinn 2). EmailSubject: {0} EmailBody: {1} SMSBody: {2} ReminderEmailSubject: {3} ReminderEmailBody: {4} ReminderSMSBody: {5}

Template 2: GenericPersonMessage For varslinger for meldinger til en konkret innbygger/person. EmailSubject: "Du har mottatt en melding i Altinn {0}" EmailBody: "Hei $recipientName$, du har mottatt en ny melding i Altinn fra $SendersName$. {1} Logg deg inn i Altinn Innboks for å se denne meldingen." SMSBody: "Hei $recipientName$, du har mottatt en ny melding i Altinn fra $SendersName$. {2} Logg deg inn i Altinn Innboks for å se denne meldingen." ReminderEmailSubject: "Påminnelse - du har mottatt en melding i Altinn {3}" ReminderEmailBody: "Hei $recipientName$, dette er en påminnelse om at du har mottatt en ny melding i Altinn fra $SendersName$. {4} Logg deg inn i Altinn Innboks for å se denne meldingen." ReminderSMSBody: "Hei $recipientName$, dette er en påminnelse om at du har mottatt en ny melding i Altinn fra $SendersName$. {5} Logg deg inn i Altinn Innboks for å se denne meldingen."

Template 3: GenericOrgMessage For varslinger for meldinger til en organisasjon. Lik template 2.

TODO

RagnarFatland-Avanade commented 3 months ago

Se også https://digdir.slack.com/archives/C033JFF2NNN/p1721134297017779 som gjelder avklaring rundt å opprette varsel på vegne av andre.

@CWO79 og @leogasnier har dere gode innspill på språkbruk i template?

Andreass2 commented 2 months ago

Templates lager i databasen for å raskt/enkelt kunne gjøre endringer uten å gjøre en ny release. Vi legger inn 1 rad per språk med samme grunnlag som over.

Andreass2 commented 1 month ago

I templatene våre, ønsker vi at TE skal velge avsendingstidspunkter selv eller skal vi sette at varsel sendes ved publisering, og revarsel i forhold til lovverk(1 uke etter om jeg husker riktig)? @leogasnier

leogasnier commented 1 month ago

vet om scenarier v. masseutsendelser (typisk) hvor det kan være hensiktsmessig å sette divergerende varslingstidspunkt ift publisering (feks. når publisering skjer kl 00:00). Mener vi i Altinn 2 har definert varslingsvindu fra kl 07:00-20:00ish men usikker på om varsling i A3 har noe slikt. Kunne en tilnærming være at vi feks. setter defaultverdi ut fra publiseringstidspunkt + en time eller noe slikt, men tillater at tjenesteeier selv setter varslingstidspunkt senere. Altså en mekanisme hvor vi ikke begrenser de som har et aktivt forhold til dette samtidig som alle andre ikke trenger å forholde seg til det? @RagnarFatland-Avanade - hva tenker du gitt erfaringer fra A2? @Andreass2 - TODO: sjekk om varsling har definert noe tidsvindu for utsending, da det muligvis tar ned behovet noe.

Andreass2 commented 1 month ago

Det ser ut til at epost ikke har noe spesifikt utsendingsvindu, men sms har ett utsendingsvindu fra kl 09 til kl 17

Andreass2 commented 1 month ago

Det kan være litt vanskelig å håndtere den divergerende varslingslogikken på publiseringstidspunkt. Men jeg vil tro at 1 time etter publiseringstidspunkt skal være nok til å unngå varsling før publisering.

Alternativt kunne man opprettet varsling på publiseringstidspunkt, men da vil det igjen være vanskeligere å gi tidlig tilbakemelding om at det ikke eksisterer kontaktinformasjon om mottaker eller om mottaker er reservert for varsling.

Andreass2 commented 1 month ago

Foreslår at for TE, så har template 2 og 3 samme verdi, slik at en masseutsendelse kan sendes til både bedrifter og privatpersoner i samme meldingsbestilling.

I systemet vårt(og selvfølgelig dokumentasjon) justeres teksten basert på om mottaker er bedrift eller privatperson