Meldings-API fra Datamynt AS

Send e-post og SMS fra systemene dine, med ett API-kall.

plinget leverer påminnelser, bekreftelser og varsler til kundene dine, og forteller deg hva som skjedde med hver enkelt melding.

For virksomheter og utviklere som vil sende transaksjonsmeldinger fra egen kode, uten å sette opp e-postserver og SMS-avtaler selv.

Ta kontakt: hei@plinget.no Se et eksempel
Slik fungerer det

Tre steg fra avtale til første melding.

  1. 01

    Få tilgang

    Send en e-post til hei@plinget.no. Vi oppretter kontoen din, slår på SMS og gir deg en API-nøkkel.

  2. 02

    Send en melding

    POST /v1/messages med nøkkelen som Bearer-token. E-post, SMS eller begge, i samme kall.

  3. 03

    Følg med

    Hent status per kanal med GET /v1/messages/{id}, eller få en signert webhook hver gang status endrer seg.

Et eksempel

Rørlegger Hansen AS varsler kunden om morgendagens besøk.

Samme tekst går ut på begge kanaler. E-posten får i tillegg emnelinje, og eventuelt en HTML-del.

KalletPOST /v1/messages
curl https://api.plinget.no/v1/messages \
  -H "Authorization: Bearer pl_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "to": {
      "email": "ola@example.no",
      "phone": "99887766"
    },
    "channels": ["email", "sms"],
    "subject": "Bekreftelse: rørlegger kommer onsdag",
    "text": "Hei Ola! Rørlegger Hansen kommer onsdag 21. oktober kl. 09:00. Passer ikke tiden? Ring 22 33 44 55.",
    "idempotency_key": "besok-2041"
  }'
Åttesifrede numre uten landskode regnes som norske. idempotency_key gjør at samme kall aldri sender to ganger.
Slik lander SMS-en. Avsendernavnet «Hansen» er satt på kontoen, ikke i hvert kall.

Status for meldingen

SMS
  1. queuedMottatt
  2. sentLevert til SMS-leverandøren
  3. deliveredKvittering fra mottakerens operatør
E-post
  1. queuedMottatt
  2. sentLevert til e-postleverandøren
  3. deliveredMottakerens e-postserver tok imot

Hver endring kommer også som signert webhook. Andre sluttstatuser er bounced, failed og suppressed. Tidspunktene over er et eksempel.

Svaret201 Created
{
  "id": "msg_01M5CBXXF3ETRYQQJY6YRM9DXC",
  "idempotency_key": "besok-2041",
  "to": {
    "email": "ola@example.no",
    "phone": "4799887766"
  },
  "subject": "Bekreftelse: rørlegger kommer onsdag",
  "channels": ["email", "sms"],
  "send_at": null,
  "created_at": "2026-10-20T15:30:02Z",
  "deliveries": [
    {
      "id": "dlv_01M5CBXXF3ETRYQQJY6YRM9DXD",
      "channel": "email",
      "provider": "scaleway",
      "status": "sent",
      "attempts": 1,
      "last_error": null,
      "next_attempt_at": null,
      "updated_at": "2026-10-20T15:30:02Z"
    },
    {
      "id": "dlv_01M5CBXXF3K3RM9SKW89PNAGW1",
      "channel": "sms",
      "provider": "gatewayapi",
      "status": "sent",
      "attempts": 1,
      "last_error": null,
      "next_attempt_at": null,
      "updated_at": "2026-10-20T15:30:02Z"
    }
  ]
}
Én leveranse per kanal, hver med sin egen status.
Hva du får

Det en meldingstjeneste må gjøre riktig.

Ikke et nyhetsbrevverktøy. plinget er laget for meldinger som sendes én til én, utløst av noe som skjedde i systemet ditt.

  • Én forespørsel, flere kanaler

    E-post og SMS i samme kall. Utelater du channels, brukes alle kanaler du har oppgitt adresse til.

  • Ingen doble utsendelser

    Samme idempotency_key og samme innhold gir den eksisterende meldingen tilbake, ikke en ny SMS. Samme nøkkel med annet innhold avvises med 409. Et avbrutt utsendelsesforsøk sendes aldri på nytt i blinde.

  • Status per kanal

    Hver kanal har sin egen status: queued, sending, sent, delivered, bounced, failed eller suppressed.

  • Signerte webhooks

    Hver statusendring postes til din https-adresse med HMAC-SHA-256-signatur. Svarer ikke mottaket, prøver vi igjen med økende pauser i opptil 24 timer.

  • Eget avsendernavn på SMS

    Opptil 11 tegn, for eksempel firmanavnet ditt. E-post sendes fra en adresse på plinget.no, med ditt navn som avsendernavn.

  • Nye forsøk ved feil

    Midlertidige feil hos leverandøren prøves på nytt etter 1 minutt, 5 minutter, 15 minutter og 1 time, opptil fem forsøk. Deretter får meldingen status failed.

  • Vern mot døde adresser

    E-post som sprettes for godt, og SMS til nummer som ikke kan nås, setter adressen på kontoens stoppliste. Senere meldinger dit får status suppressed og sendes ikke.

  • Grenser per kunde

    Som standard 60 meldinger i minuttet og 500 SMS per døgn. Over grensen får du 429 med Retry-After. Grensene kan justeres per konto.

  • Planlagt utsendelse

    Sett send_at med klokkeslett og tidssone, så sendes meldingen da.

  • Tydelige feilmeldinger

    Feil kommer som problem-JSON (RFC 7807), med en liste over hvilke felt som er feil.

KommerEget kontrollpanel med selvbetjening. Frem til da setter vi opp kontoen din, nøkler og webhook sammen med deg.

Hvor dataene dine er

EU-leverandører og drift i Belgia.

  • E-postScaleway Transactional EmailFrankrike (Paris)
  • SMSGatewayAPI, EU-plattformenDanmark
  • Tjeneste og databaseGoogle Cloud, Cloud Run og Cloud SQL (Postgres)Belgia (europe-west1)

Meldingstekst, mottaker og status lagres i databasen vår, slik at du kan hente status og vi kan prøve på nytt ved feil. API-nøkler lagres bare som SHA-256-hash, så vi kan ikke lese dem tilbake. Webhook-adresser må være https og peke til offentlige adresser.

Denne siden bruker ingen cookies, ingen sporing og ingen skript fra andre.

Spørsmål

Det folk spør om først.

Hva koster det?

Ta kontakt, vi priser per melding.

Kan jeg bruke mitt eget avsendernavn?

På SMS, ja: opptil 11 tegn, for eksempel firmanavnet ditt. Det settes på kontoen din. E-post sendes foreløpig fra en adresse på plinget.no, med ditt navn som visningsnavn.

Hva skjer hvis en SMS ikke kommer frem?

Du ser det i statusen. Midlertidige feil hos leverandøren prøves på nytt, opptil fem ganger. Rapporterer operatøren at nummeret ikke kan nås, får meldingen status bounced, og nummeret settes på stopplisten din. Gir vi opp av andre grunner, står det failed med årsak. Du kan hente statusen når du vil, eller få den som webhook.

Kan en kunde få samme melding to ganger?

Ikke hvis du sender med en idempotency_key, og det er påkrevd. Gjentar systemet ditt kallet, for eksempel etter et tidsavbrudd, får du den første meldingen tilbake og ingenting sendes på nytt.

Kan jeg sende nyhetsbrev og kampanjer?

Nei. plinget er for transaksjonsmeldinger som sendes til én mottaker om gangen: påminnelser, bekreftelser, varsler og koder.

Kom i gang

Fortell oss hva dere vil sende.

Skriv noen linjer om systemet og meldingene dere trenger, så svarer vi med hvordan det kan settes opp og hva det koster per melding.

Skriv til hei@plinget.no