Webhook-administrasjon: Opprett, test og autentiser

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:

Kategori	Hendelser
Tjeneste	Opprettet, oppdatert, slettet
Bestilling	Opprettet, oppdatert, slettet
Oppgave	Opprettet, tildelt, fullført, oppdatert
Faktura	Status endret
Klient / Bruker	Ny klient lagt til, klient/bruker slettet
Tilbud	Sendt, mottatt, akseptert, avvist
Sak	Opprettet, tildelt, status endret
Betaling	Mottatt, mislyktes
Tjenestepakke	Opprettet, oppdatert, slettet

Opprett en webhook

Naviger til Webhook-administrasjon

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

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.

Opprett en ny webhook

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

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.

Velg innholdstype

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

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.

Aktiver webhook

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

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.

Åpne webhook

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

Klikk Test Hendelse

Klikk Test Hendelse-knappen på webhook-detaljsiden.

Velg en testhendelse

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

Send testnyttelasten

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

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

string

påkrevd

ID-en til webhooket som mottok hendelsen. Finn denne på webhook-detaljsiden i AgencyHandy.

string

påkrevd

Verdien av x-ah-sig-overskriften fra den innkommende webhook-forespørselen.

string

påkrevd

Webhook-hemmeligheten som vises på webhook-detaljsiden i AgencyHandy.

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" }

curl -X POST https://api.agencyhandy.com/api/v1/webhooks/verify-signature \
  -H "Content-Type: application/json" \
  -d '{
    "webhookId": "your_webhook_id",
    "signature": "your_signature",
    "secret": "your_webhook_secret",
    "payload": {}
  }'

Svar

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.

Kom i gang

Arbeidsområdeoppsett

CRM

Tjenester og ordre

Tilbud og fakturaer

Team og oppgaver

Skjemaer og filer

Konto og fakturering

Betalinger

Integrasjoner

Webhook-administrasjon: Opprett, test og autentiser

Støttede hendelser

Opprett en webhook

Test en webhook

Autentiser webhook-nyttelaster

Signaturoverskrift

Verifiser en webhook-signatur

Viktige merknader

​Støttede hendelser

​Opprett en webhook

​Test en webhook

​Autentiser webhook-nyttelaster

​Signaturoverskrift

​Verifiser en webhook-signatur

​Viktige merknader

Støttede hendelser

Opprett en webhook

Test en webhook

Autentiser webhook-nyttelaster

Signaturoverskrift

Verifiser en webhook-signatur

Viktige merknader