Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Beskrivning

Funktion som hanterar utgående kommunikation via e-post eller sms.

Version 1 enklast möjliga variant på kommunikation - kommande versioner kan komma att innehålla:

  • Mallhantering

  • Kivra

  • Skicka fysiska brev

Dessutom sparas, för identifierade mottagare, kommunikationshistorik.

Livscykelstatus

Under utveckling

Lösningsbeskrivning

Gliffy
imageAttachmentIdatt29425686
macroId5403c848-f47c-4944-9cae-039096781462
baseUrlhttps://sundsvall.atlassian.net/wiki
namemessagingAPI
diagramAttachmentIdatt30179333
containerId30081025
timestamp1611746257838

Hantering av personuppgifter

Vilka personuppgifter hanteras och varför?

API specifikation

För att skicka meddelanden görs ett POST-anrop till /messages. Mottagarna anges i form av en lista med personId i requestbodyn, som messaging använder för att slå upp respektive mottagares återkopplingsinställningar från feedbacksettings. Anroparen kan skicka med både ett längre och ett kortare meddelande som används beroende på om mottagaren vill ha epost eller SMS skickat till sig.

POST /messages

Code Block
languagejson
{
  "sender" : "Sundsvalls Kommun",
  "recipients" : [
    "15aee472-46ab-4f03-9605-68bd64ebc73f"
  ],
  "message" : "Ett längre meddelande som kan skickas via mail ... och innehålla ditt och datt ...",
  "shortMessage" : "Ett kortare meddelande som kan skickas via SMS"
}

Nedanstående förslag är i nuläget inte implementerade:

POST /sms

Code Block
languagejson
{
  "sender" : "Sundsvalls Kommun"
  "mobileNumber" : "0701234567",
  "personId" : "435rfret45", //optional
  "message" : "Text. bla bla"
}

POST /email

Code Block
languagejson
{
  "sender" : "noreply@sundsvall.se"
  "emailAddress" : "test@test.se",
  "personId" : "435rfret45", //optional
  "message" : "Text. bla bla"
}

GET /{personId}/conversationHistory

Code Block
languagejson
[ {
  "sender" : "Sundsvalls Kommun"
  "messageType" : "sms",
  "message" : "Text. bla bla"
} ]

API-ägare

<Kontaktuppgifter till den verksamhet som äger APIets livscykel>

Teknisk ägare

https://sundsvall.atlassian.net/wiki/spaces/API

För tekniska frågor: Lamin Saidy <laminlamin.saidy@sundsvall.se>se

Länkar

<Länkar till dev-portal;

  • Test

  • Sandbox

  • Produktion>

FAQ

<FAQ>