Varsling i praksis

Varsling er ett API for alle kanaler. Du sier hvem og hva, Spire velger hvordan.

Den enkleste meldingen

curl -X POST https://api.spireapi.com/v1/meldinger \
  -H "Authorization: Bearer sk_live_…" \
  -d '{ "til": { "mobil": "+4791234567" }, "kanaler": ["sms"], "tekst": "Koden din er 482913. Gyldig i 5 minutter." }'

Svaret er 202 Accepted med en ID. Leveringen skjer asynkront; status kommer som webhook (melding.levert / melding.feilet) eller med GET /v1/meldinger/{id}.

Kanalregler

kanaler er en prioritert liste. Spire prøver første kanal; lykkes den ikke (ingen push-enhet, SMS avvist av operatør, e-post spretter), prøves neste.

"kanaler": ["push", "sms", "epost"]

«Lykkes» betyr levert, ikke bare sendt. For SMS venter vi på leveringsrapport fra operatøren i opptil 60 sekunder før vi går videre. Du kan endre ventetiden med kanal_ventetid_s.

Svaret forteller hvilke kanaler som ble prøvd og hva som skjedde:

"forsok": [
  { "kanal": "push", "status": "ingen_enhet" },
  { "kanal": "sms", "status": "levert", "levert": "2026-11-03T10:02:17Z", "deler": 1 }
]

Maler

Lag maler i dashbordet eller via POST /v1/maler. En mal har tekst per kanal og per språk, med variabler i doble klammer:

SMS (nb):   Hei {{navn}}. Faktura på {{belop}} kr forfaller {{forfall}}. Betal: {{lenke}}
SMS (nn):   Hei {{navn}}. Faktura på {{belop}} kr forfell {{forfall}}. Betal: {{lenke}}
E-post (nb): emne "Faktura forfaller {{forfall}}", HTML-kropp fra editor
Push (nb):  tittel "Faktura forfaller", kropp "{{belop}} kr forfaller {{forfall}}"

Bruk malen med mal og variabler. Mangler en variabel, avvises kallet med ugyldig_parameter før noe sendes. Språk velges med sprak på meldingen eller mottakerens lagrede preferanse.

Maler kan endres i dashbordet uten ny utrulling, og hver mal har versjonshistorikk.

SMS-detaljer

• Avsender: standard er «Spire». Egen avsender (opptil 11 tegn, bokstaver og tall) registreres i dashbordet og godkjennes hos operatørene innen 2 virkedager. Krever Vekst.
• Lengde: 160 tegn per del med GSM-7 (inkluderer æøå), 70 med Unicode (emoji, visse tegn). Svaret viser deler. Vi advarer i dashbordet om maler som ofte blir 3+ deler.
• Lenker: {{lenke}} i maler forkortes automatisk til spr.no/… og klikk registreres som melding.klikket.
• Utland: 190 land, pris per land i dashbordet. Nummeret må være E.164 (+47…).

E-postdetaljer

• Sendes fra varsel@ditt-domene.no når du har satt opp SPF, DKIM og DMARC (veiviser i dashbordet). Før det sendes fra ditt-navn@spire-post.no.
• Adresser som spretter hardt sperres automatisk i 30 dager, og meldingen går til neste kanal.
• Åpning og klikk registreres bare hvis du skrur det på per mal, av hensyn til personvern.
• Dedikert IP på Skala for de som sender over 100 000 i måneden.

Push

Registrer enheter med POST /v1/enheter (APNs-token eller FCM-token knyttet til din bruker-ID). Bruk til.bruker_id i meldingen, så finner Spire enhetene. Push er gratis.

Tidsstyring

Batch

Til mange mottakere med samme mal:

spire.meldinger.batch(
    mal="vannavstengning",
    kanaler=["sms"],
    mottakere=[{"til": {"mobil": m}, "variabler": {"adresse": a}} for m, a in liste],
    hastighet=200,  # per sekund
)

Opptil 10 000 per kall. Status per mottaker kommer som webhooks, og en samlet rapport under GET /v1/batcher/{id}.

Reservasjoner og samtykke

Meldinger med formaal: "marked" sjekkes mot reservasjonslisten din (POST /v1/reservasjoner) og mot mottakere som har svart STOPP på SMS. Reserverte mottakere får ikke meldingen, og du får melding.reservert. Transaksjonelle meldinger (standard) sjekkes ikke, fordi en betalingspåminnelse ikke er markedsføring.

Toveis-SMS

Svar på SMS-er du har sendt kommer som webhooken melding.svar, koblet til den opprinnelige meldingen. Krever egen avsender med kortnummer eller virtuelt nummer, som settes opp i dashbordet.

Testing

Testnumrene +4799990001 til +4799990004 gir forutsigbare utfall i sandkassen. Ingen ekte SMS sendes der. Se sandkassen.