Hopp til hovedinnhold
Webhooks lar AgencyHandy sende data til de eksterne systemene dine i det øyeblikket noe endres — ingen polling nødvendig. Når en konfigurert hendelse utløses (for eksempel oppdateres en bestilling eller en sak opprettes), sender AgencyHandy en HTTP POST-forespørsel med en JSON-nyttelast til endepunkt-URL-en du angir. Dette gjør det enkelt å holde eksterne verktøy som CRM-er, faktureringssystemer eller egendefinerte dashboards synkronisert med AgencyHandy-arbeidsområdet ditt i sanntid.
Arbeidsområder på Business Pro-planen støtter opptil 30 000 webhook-hendelser per faktureringsperiode. Sjekk plangrensene dine før du setter opp høyvolumsautomatiseringer.

​
Støttede hendelser

Du kan abonnere på en webhook for en hvilken som helst kombinasjon av følgende hendelser:
KategoriHendelser
TjenesteOpprettet, oppdatert, slettet
BestillingOpprettet, oppdatert, slettet
OppgaveOpprettet, tildelt, fullført, oppdatert
FakturaStatus endret
Klient / BrukerNy klient lagt til, klient/bruker slettet
TilbudSendt, mottatt, akseptert, avvist
SakOpprettet, tildelt, status endret
BetalingMottatt, mislyktes
TjenestepakkeOpprettet, oppdatert, slettet

​
Opprett en webhook

1

Naviger til Webhook-administrasjon

I venstre sidefelt går du til Integrasjoner → Webhook-administrasjon.
2

Autentiser tokenet ditt

Klikk på Administrasjon-knappen for å autentisere webhook-tokenet ditt. Dette tokenet brukes til å signere utgående nyttelaster slik at du kan verifisere at de stammer fra AgencyHandy.
3

Opprett en ny webhook

Klikk Opprett ny webhook for å åpne webhook-konfigurasjonsskjemaet.
4

Skriv inn endepunkt-URL-en

I feltet Endepunkt-URL skriver du inn URL-en til det eksterne systemet som skal motta webhook-dataene. Dette må være et offentlig tilgjengelig POST-endepunkt.
5

Velg innholdstype

Velg JSON som innholdstype. AgencyHandy sender alle webhook-nyttelaster som application/json.
6

Velg webhook-hendelser

Velg alle hendelser som skal utløse denne webhooket. Du kan velge hendelser fra flere kategorier — for eksempel kan Bestilling: Opprettet og Faktura: Status endret begge peke til samme endepunkt.
7

Aktiver webhook

Slå på Aktiv-radioknappen. Når aktiv, leverer AgencyHandy nyttelaster for alle valgte hendelser til endepunktet ditt i sanntid.
8

Lagre konfigurasjonen

Gjennomgå innstillingene dine, og klikk deretter Lagre. Webhooket vises i listen og begynner å levere hendelser umiddelbart.

​
Test en webhook

Etter at du har opprettet en webhook, send en testnyttelast for å bekrefte at endepunktet er nåbart og behandler data korrekt.
1

Åpne webhook

Fra Webhook-administrasjonslisten klikker du på webhooket du vil teste.
2

Klikk Test Hendelse

Klikk Test Hendelse-knappen på webhook-detaljsiden.
3

Velg en testhendelse

Velg en eksempelhendelse fra listen over hendelser konfigurert på denne webhooket (f.eks. Bestilling: Opprettet).
4

Send testnyttelasten

Klikk Send. AgencyHandy publiserer en eksempelnyttelast til endepunkt-URL-en din.
5

Verifiser resultatet

Sjekk det eksterne systemet ditt for å bekrefte at testnyttelasten kom frem og ble behandlet som forventet. Tilbake i AgencyHandy klikker du inn i webhooket for å gjennomgå historikken — du kan se hele forespørselen, svaret endepunktet ditt returnerte, og gjenlevere enhver tidligere hendelse om nødvendig.
Bruk et verktøy som Webhook.site eller RequestBin som et midlertidig endepunkt under oppsett for å inspisere den nøyaktige nyttelastformen før du kobler til det virkelige systemet ditt.

​
Autentiser webhook-nyttelaster

Hver utgående webhook-forespørsel fra AgencyHandy inkluderer en signaturoverskrift som endepunktet ditt kan bruke til å verifisere at nyttelasten er ekte og ikke har blitt manipulert.

​
Signaturoverskrift

x-ah-sig: <signature>
AgencyHandy legger til denne overskriften i alle webhook-forespørsler. Trekk ut verdien fra innkommende forespørsler og send den til verifiseringsendepunktet.

​
Verifiser en webhook-signatur

Send følgende forespørsel for å bekrefte at en nyttelast er autentisk: 
POST https://api.agencyhandy.com/api/v1/webhooks/verify-signature
Content-Type: application/json
​
webhookId
string
påkrevd
ID-en til webhooket som mottok hendelsen. Finn denne på webhook-detaljsiden i AgencyHandy.
​
signature
string
påkrevd
Verdien av x-ah-sig-overskriften fra den innkommende webhook-forespørselen.
​
secret
string
påkrevd
Webhook-hemmeligheten som vises på webhook-detaljsiden i AgencyHandy.
​
payload
object
påkrevd
Den rå JSON-kroppen mottatt fra AgencyHandys webhook-forespørsel.
const url = 'https://api.agencyhandy.com/api/v1/webhooks/verify-signature';

const postData = {
  webhookId: 'your_webhook_id',
  signature: 'your_signature',   // value of x-ah-sig header
  secret: 'your_webhook_secret',
  payload: {},                   // the parsed JSON body from AgencyHandy
};

const response = await fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(postData),
});

const data = await response.json();
console.log(data); // { "verification_status": "SUCCESS" }
Svar
​
verification_status
string
SUCCESS når signaturen er gyldig. FAILED når verifiseringen mislykkes (HTTP 403).
Success (200)
{
  "verification_status": "SUCCESS"
}
Failure (403)
{
  "type": "PermissionError",
  "status": 403,
  "verification_status": "FAILED"
}
Hold webhook-hemmeligheten din konfidensiell. Roter den periodisk og oppdater verifiseringslogikken umiddelbart etter rotering. Eksponer den aldri i klientsidig kode eller offentlige repositorier.

​
Viktige merknader

  • Endepunkt-URL-en din må være en offentlig tilgjengelig HTTPS POST-URL.
  • Hvis endepunktet ditt er midlertidig utilgjengelig, sjekk webhook-historikkpanelet i AgencyHandy — du kan gjenlevere enhver tidligere hendelse direkte derfra.
  • Overvåk webhook-aktivitet jevnlig for å oppdage mislykkede leveranser eller uautoriserte tilgangsforsøk.
  • Webhooks som mislykkes gjentatte ganger kan bli satt på pause av AgencyHandy — gjennomgå leveringslogger for å oppdage problemer tidlig.