Webhooks i ReAI

Webhooks brukes når et annet system skal få beskjed om at noe har skjedd i ReAI. I stedet for at systemet spør ReAI hele tiden, sender ReAI en hendelse når for eksempel en faktura opprettes, en betaling matches eller et avvik krever oppfølging.

For teknisk bakgrunn kan du lese webhooks i regnskap .

Typiske hendelser

Webhooks passer best for små, tydelige hendelser. Store datauttrekk bør heller gå via API eller rapporteksport.

Sikkerhet og kvalitet

Før webhooks tas i bruk, bør dere avklare:

• Hvilke systemer som får motta hendelser.
• Hvordan mottakende system verifiserer at hendelsen er ekte.
• Hva som skjer hvis mottakeren er nede.
• Hvordan feil logges og prøves på nytt.
• Hvem som eier integrasjonen.

Se også API-sikkerhet i regnskap hvis integrasjonen håndterer sensitive økonomidata.

Start enkelt

Begynn med én hendelse og ett formål. For eksempel: Når en faktura er betalt i ReAI, oppdateres status i CRM. Når den flyten fungerer stabilt, kan dere utvide.

Hvis dere trenger bredere integrasjon, se API-integrasjoner i ReAI .

Gjør mottakeren idempotent

Mottakeren bør lagre en unik hendelses-ID og tåle at samme webhook kommer flere ganger. Bekreft mottak raskt, og behandle tyngre arbeid i en kontrollert kø. Logg tidspunkt, hendelsestype, resultat og antall forsøk uten å lagre mer persondata enn nødvendig.

Test feil rekkefølge, forsinket levering og nedetid. Avstem jevnlig webhook-resultatet mot ReAI gjennom API eller rapport, slik at en tapt hendelse blir oppdaget. Bruk et testmiljø for integrasjoner før endepunkt eller datamodell endres.