Motta API-hendelser med webhooks
Få beskjed om endringer, kontroller signaturen og unngå å behandle samme hendelse flere ganger.
Oppdatert 15. november 2026
I BilagPilot
- Åpne Innstillinger → Tilkoblinger → MCP-server → Webhooks som byråets eier.
- Legg til systemets offentlige HTTPS-adresse. Velg JSON for en egen integrasjon og velg hvilke hendelser og kunder adressen skal motta. Du kan ha opptil fem mottakeradresser.
- Lagre signeringshemmeligheten i mottakerens sikre konfigurasjon når den vises. Den er en egen hemmelighet og erstatter ikke API-nøkkelen.
- Bruk Send testhendelse og kontroller både mottaket og leveringsloggen. En testhendelse bekrefter adressen; den betyr ikke at et bilag er lastet opp eller sendt.
Kontroller før hendelsen behandles
Kontroller BilagPilot-Signature mot den rå HTTP-teksten før JSON tolkes. Signaturen bruker HMAC-SHA256 over tidsstempelet, et punktum og innholdet. Avvis ugyldig signatur eller tidsstempel eldre enn fem minutter. Bruk samme kontroll selv om innholdet ser forventet ut.
En hendelse inneholder type, tid og relevante ID-er, for eksempel upload.received med uploadId. Den inneholder ikke selve filen eller kundens kontaktinformasjon. Hent nødvendige detaljer gjennom API-et med nøkkelens vanlige tillatelser.
Webhooks sender informasjon én vei. Kommandoer til BilagPilot skal fortsatt gå gjennom API-et og eventuelle godkjenninger.
Tåle gjentakelser og hente inn etterslep
BilagPilot kan levere samme hendelse flere ganger. Lagre hendelsens id og sørg for at samme hendelse ikke utløser handlingen din to ganger. Send på nytt i leveringsloggen bruker samme hendelses-ID.
Mottakeren må svare med en 2xx-status innen ti sekunder. Lagre hendelsen varig, svar raskt og behandle den videre i en egen jobb. Mislykket levering prøves på nytt innenfor et vindu på 24 timer. Langvarige feil kan slå av adressen; kontroller loggen og rett mottakeren før den slås på igjen.
GET /api/v1/changes?since= kan brukes til å hente endringer uten webhooks. Ta vare på svarets cursor og bruk deretter GET /api/v1/changes?cursor= for å fortsette. Endringshistorikken oppbevares i 90 dager. Kunder og hendelser følger tilkoblingens tilgang.
Fant du ikke svaret?
Kontakt support, så hjelper vi deg videre.