Spring til hovedindhold
Webhooks lader AgencyHandy sende data til dine eksterne systemer i det øjeblik, noget ændres — ingen polling krævet. Når en konfigureret hændelse udløses (f.eks. en ordre opdateres eller en supportticket oprettes), sender AgencyHandy en HTTP POST-anmodning med en JSON-nyttelast til den endpoint-URL, du angiver. Dette gør det nemt at holde eksterne værktøjer som CRM-systemer, faktureringssystemer eller brugerdefinerede dashboards synkroniseret med dit AgencyHandy-workspace i realtid.
Workspaces på Business Pro-planen understøtter op til 30.000 webhook-hændelser pr. faktureringsperiode. Tjek dine planbegrænsninger, inden du opsætter automatiseringer med høj volumen.

​
Understøttede hændelser

Du kan abonnere en webhook på enhver kombination af følgende hændelser:
KategoriHændelser
TjenesteOprettet, Opdateret, Slettet
OrdreOprettet, Opdateret, Slettet
OpgaveOprettet, Tildelt, Fuldført, Opdateret
FakturaStatus ændret
Klient / BrugerNy klient tilføjet, Klient/bruger slettet
TilbudSendt, Modtaget, Accepteret, Afvist
SupportticketOprettet, Tildelt, Status ændret
BetalingModtaget, Fejlet
ServicepakkeOprettet, Opdateret, Slettet

​
Opret en webhook

1

Naviger til Webhook-administration

Gå til Integrationer → Webhooks Management i den venstre sidebjælke.
2

Godkend dit token

Klik på knappen Management for at godkende dit webhook-token. Dette token bruges til at signere udgående nyttelaster, så du kan verificere, at de stammer fra AgencyHandy.
3

Opret en ny webhook

Klik på Create New Webhook for at åbne webhook-konfigurationsformularen.
4

Indtast endpoint-URL'en

I feltet Endpoint URL skal du indtaste URL’en på det eksterne system, der skal modtage webhook-dataene. Dette skal være et offentligt tilgængeligt POST-endpoint.
5

Vælg indholdstypen

Vælg JSON som indholdstype. AgencyHandy sender alle webhook-nyttelaster som application/json.
6

Vælg webhook-hændelser

Vælg alle hændelser, der skal udløse denne webhook. Du kan vælge hændelser fra flere kategorier — f.eks. kan Ordre: Oprettet og Faktura: Status ændret begge pege på det samme endpoint.
7

Aktiver webhook'en

Slå Active-radioknappen til. Når den er aktiv, leverer AgencyHandy nyttelaster for alle valgte hændelser til dit endpoint i realtid.
8

Gem konfigurationen

Gennemgå dine indstillinger, og klik derefter på Save. Webhook’en vises på listen og begynder straks at levere hændelser.

​
Test en webhook

Når du har oprettet en webhook, skal du sende en testnyttelast for at bekræfte, at dit endpoint er tilgængeligt og behandler data korrekt.
1

Åbn webhook'en

Klik på den webhook, du vil teste, fra listen i Webhooks Management.
2

Klik på Test Event

Klik på knappen Test Event på webhook-detailsiden.
3

Vælg en testhændelse

Vælg en eksempelhændelse fra listen over hændelser konfigureret på denne webhook (f.eks. Ordre: Oprettet).
4

Send testnyttelasten

Klik på Send. AgencyHandy sender en eksempelnyttelast til din endpoint-URL.
5

Verificer resultatet

Tjek dit eksterne system for at bekræfte, at testnyttelasten ankom og blev behandlet som forventet. Tilbage i AgencyHandy kan du klikke på webhook’en for at gennemgå dens historik — du kan se den fulde anmodning, det svar dit endpoint returnerede, og gensende enhver tidligere hændelse efter behov.
Brug et værktøj som Webhook.site eller RequestBin som et midlertidigt endpoint under opsætningen for at undersøge den præcise nyttelaststruktur, inden du tilslutter dit rigtige system.

​
Godkend webhook-nyttelaster

Alle udgående webhook-anmodninger fra AgencyHandy inkluderer et signaturobjekt-header, som dit endpoint kan bruge til at verificere, at nyttelasten er ægte og ikke er blevet manipuleret.

​
Signatur-header

x-ah-sig: <signature>
AgencyHandy tilføjer denne header til alle webhook-anmodninger. Udpak værdien fra indgående anmodninger og send den til verifikationsendpointet.

​
Verificer en webhook-signatur

Send følgende anmodning for at bekræfte, at en nyttelast er autentisk: 
POST https://api.agencyhandy.com/api/v1/webhooks/verify-signature
Content-Type: application/json
​
webhookId
string
påkrævet
ID’et på den webhook, der modtog hændelsen. Find det på webhook-detailsiden i AgencyHandy.
​
signature
string
påkrævet
Værdien af x-ah-sig-headeren fra den indgående webhook-anmodning.
​
secret
string
påkrævet
Webhook-hemmeligheden vist på webhook-detailsiden i AgencyHandy.
​
payload
object
påkrævet
Den rå JSON-krop modtaget fra AgencyHandys webhook-anmodning.
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 verifikation mislykkes (HTTP 403).
Success (200)
{
  "verification_status": "SUCCESS"
}
Failure (403)
{
  "type": "PermissionError",
  "status": 403,
  "verification_status": "FAILED"
}
Hold din webhook-hemmelighed fortrolig. Roter den jævnligt og opdater din verifikationslogik umiddelbart efter rotation. Udsæt den aldrig i klientsidet kode eller offentlige repositorier.

​
Vigtige bemærkninger

  • Din endpoint-URL skal være en offentligt tilgængelig HTTPS POST-URL.
  • Hvis dit endpoint midlertidigt er utilgængeligt, kan du tjekke webhook’ens historiepanel i AgencyHandy — du kan gensende enhver tidligere hændelse direkte derfra.
  • Overvåg jævnligt webhook-aktivitet for at opdage fejlslagne leveringer eller uautoriserede adgangsforsøg.
  • Webhooks der fejler gentagne gange kan blive sat på pause af AgencyHandy — gennemgå leveringslogge for at fange problemer tidligt.