telkit
Kom i gang

Bruksområde

Ett API for SMS, e-post, brev, samtaler og transkripsjon

Du skal sende en kode, en kvittering eller et brev fra systemet ditt, og helst slippe fem leverandøravtaler for å få det til. telkit er ett REST-API med én nøkkel og én saldo i kroner.

Kom i gangAlle bruksområder

Sist gjennomgått 14. oktober 2026

Problemet

Hver kanal har sin leverandør, sitt API, sin faktura og sin måte å melde status på. Når produktet trenger SMS, e-post og brev, blir integrasjonen et prosjekt i seg selv.

Hos telkit er alle kanalene vanlige JSON-kall under /v1, med de samme feilkodene, den samme Idempotency-Key og de samme signerte webhookene. Det API-et gjør, ser du også i dashbordet, med prisen på hver melding.

Det du får

Fem tjenester og verktøyene rundt dem.
  • SMSSend til norske mobilnumre fra et navn, et svarnummer eller et eget nummer. Planlegg, avbryt, og se prisen før du sender.
  • E-postSend fra ditt eget verifiserte domene, og ta imot e-post som kommer inn. Statusene er sendt, levert, avvist, klaget og feilet.
  • BrevSend en PDF, en mal eller ren tekst til en adresse. Digipost når mottakeren har det, ellers papir. Se begge prisene før du sender.
  • SamtalerRing ut og få en tekst lest opp med norsk stemme, eller ta imot samtaler på et norsk nummer og la systemet ditt bestemme hva som skjer.
  • TranskripsjonSend en fil eller en lenke og få tekst med tidskoder og talere, som JSON, SRT, VTT eller ren tekst.
  • Webhooks og hendelsesloggHver leveranse er signert med HMAC, og med Ed25519 hvis du slår det på. Det som feilet, prøves igjen, og du kan sende det på nytt fra API-et.

Eksempler på flyten

Fra første forsøk til drift.

Fra testnøkkel til produksjon

  1. Registrer bedriften med organisasjonsnummeret og lag en testnøkkel i dashbordet.
  2. Bygg hele flyten mot API-et. Med testnøkkelen blir ingenting sendt, og ingenting koster noe.
  3. Lag en live-nøkkel, fyll på saldoen, og bytt nøkkel.

Status tilbake til systemet

  1. Registrer et endepunkt for sms.status, email.status og letter.status. Hemmeligheten vises én gang.
  2. Sjekk signaturen før du leser innholdet, og lagre statusen ved meldingen.
  3. Var endepunktet nede, sender telkit leveransene på nytt. Gav telkit opp, henter du dem fra listen over feilede leveranser.

Én nøkkel per tjeneste

  1. Innloggingstjenesten får en nøkkel som bare gjelder én profil og bare har sms:send.
  2. Rapporteringen får en nøkkel med usage:read for hele bedriften.
  3. Lekker en nøkkel, trekker du den tilbake uten å røre de andre.

Slik ser forespørselen ut

En e-post, et webhook-endepunkt og forbruket for en måned. Alle kall bruker den samme nøkkelen i Authorization.
POST /v1/emailbash
curl https://api.telkit.no/v1/email \  -H "Authorization: Bearer $TELKIT_API_KEY" \  -H "Idempotency-Key: ordre-10482-bekreftelse" \  -H "Content-Type: application/json" \  -d '{    "profile": "nettbutikken",    "to": "kari@eksempel.no",    "subject": "Takk for bestillingen",    "text": "Vi har mottatt ordre 10482 og sender pakken i morgen."  }'
Uten senderId går e-posten fra profilens standardavsender på det verifiserte domenet.
POST /v1/webhook-endpointsbash
curl https://api.telkit.no/v1/webhook-endpoints \  -H "Authorization: Bearer $TELKIT_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "url": "https://eksempel.no/telkit/hendelser",    "events": [      "sms.status",      "email.status",      "letter.status"    ],    "description": "Produksjon"  }'
Svaret har hemmeligheten (whsec_…) som signerer leveransene. Den vises bare én gang.
GET /v1/usagebash
curl "https://api.telkit.no/v1/usage?from=2026-10-01&to=2026-10-31&groupBy=service" \  -H "Authorization: Bearer $TELKIT_API_KEY"
Forbruket per tjeneste i perioden, i øre uten mva. Med profile=… får du én profil.

Hva du må passe på

Fire ting som sparer deg for feilsøking senere.
  • Gi hver sending en Idempotency-Key. API-et krever den på alt som sender noe, og samme nøkkel to ganger sender én gang.
  • Sjekk signaturen på webhooken før du stoler på innholdet, og bruk id-en (evt_…) til å se bort fra dubletter.
  • En nøkkel kan gjelde hele bedriften eller én profil, og ha alle tilganger eller bare noen. Gi hver tjeneste det den trenger.
  • Prisen står i øre uten mva. i svarene (priceOre). Vis den i kroner med mva. hvis brukerne dine ser den.

Hva det koster

Du fyller på en saldo i kroner, og hver sending trekkes fra den. Her er de vanligste prisene.
SMS sendt, per enhet
0,75 kr
E-post sendt
0,01 kr
Brev levert i Digipost
5 kr
Brev på papir i Norge
19 kr
Utgående samtale, per minutt
0,60 kr
Transkripsjon, per lydminutt
0,06 kr

Prisene er uten mva.

Se hele prislisten

Spørsmål fra utviklere

Hvordan autentiserer jeg?

Med en API-nøkkel i Authorization-headeren: Bearer og nøkkelen. Nøkkelen vises én gang når du lager den. Vi lagrer bare en hash av den.

Kan jeg teste uten å betale?

Ja. En testnøkkel sender ingenting og koster ingenting. Du kan bygge hele flyten før du fyller på saldoen.

Hva skjer hvis jeg sender samme forespørsel to ganger?

Med samme Idempotency-Key blir den sendt én gang, og du får det samme svaret tilbake.

Hvor er API-dokumentasjonen?

Under API-dokumentasjon i menyen. Den lages fra OpenAPI-beskrivelsen av API-et, så den viser det API-et faktisk tar imot.

Får jeg vite når saldoen blir lav?

Ja. Hendelsen balance.low går til bedriftens webhook-endepunkter.

Les mer om tjenestene

Andre bruksområder

Lag den første nøkkelen

Registrer bedriften med organisasjonsnummeret, lag en testnøkkel og send det første kallet.

Kom i gangSe prisene