Hoppa till huvudinnehåll
Webhooks låter AgencyHandy skicka data till dina externa system i det ögonblick något förändras — ingen polling krävs. När en konfigurerad händelse inträffar (till exempel uppdateras en beställning eller skapas ett ärende) skickar AgencyHandy en HTTP POST-begäran med en JSON-payload till den endpoint-URL du anger. Detta gör det enkelt att hålla externa verktyg som CRM-system, faktureringssystem eller anpassade dashboards synkroniserade med din AgencyHandy-arbetsyta i realtid.
Arbetsytor med Business Pro-abonnemang stöder upp till 30 000 webhook-händelser per faktureringsperiod. Kontrollera dina abonnemangsbegränsningar innan du konfigurerar automationer med hög volym.

​
Händelser som stöds

Du kan prenumerera en webhook på valfri kombination av följande händelser:
KategoriHändelser
TjänstSkapad, Uppdaterad, Borttagen
BeställningSkapad, Uppdaterad, Borttagen
UppgiftSkapad, Tilldelad, Slutförd, Uppdaterad
FakturaStatus ändrad
Klient / AnvändareNy klient tillagd, Klient/användare borttagen
OffertSkickad, Mottagen, Accepterad, Avvisad
ÄrendeSkapat, Tilldelat, Status ändrad
BetalningMottagen, Misslyckad
TjänstepaketSkapat, Uppdaterat, Borttaget

​
Skapa en webhook

1

Navigera till Webhookhantering

I den vänstra sidopanelen, gå till Integrationer → Webhookhantering.
2

Autentisera din token

Klicka på knappen Hantering för att autentisera din webhook-token. Denna token används för att signera utgående payloads så att du kan verifiera att de härstammar från AgencyHandy.
3

Skapa en ny webhook

Klicka på Skapa ny webhook för att öppna webhook-konfigurationsformuläret.
4

Ange endpoint-URL

I fältet Endpoint-URL, ange URL:en för det externa system som ska ta emot webhook-datan. Detta måste vara en offentligt tillgänglig POST-endpoint.
5

Välj innehållstyp

Välj JSON som innehållstyp. AgencyHandy skickar alla webhook-payloads som application/json.
6

Välj webhook-händelser

Välj varje händelse som ska utlösa denna webhook. Du kan välja händelser från flera kategorier — till exempel kan Beställning: Skapad och Faktura: Status ändrad båda peka mot samma endpoint.
7

Aktivera webhooken

Aktivera Aktiv-radioknappen. När aktiv levererar AgencyHandy payloads för alla valda händelser till din endpoint i realtid.
8

Spara konfigurationen

Granska dina inställningar och klicka sedan på Spara. Webhooken visas i listan och börjar leverera händelser omedelbart.

​
Testa en webhook

Efter att du skapat en webhook, skicka en testpayload för att bekräfta att din endpoint är nåbar och behandlar data korrekt.
1

Öppna webhooken

Från listan i Webhookhantering, klicka på den webhook du vill testa.
2

Klicka på Testhändelse

Klicka på knappen Testhändelse på webhook-detaljsidan.
3

Välj en testhändelse

Välj en exempelhändelse från listan över händelser som är konfigurerade på denna webhook (t.ex. Beställning: Skapad).
4

Skicka testpayloaden

Klicka på Skicka. AgencyHandy postar en exempelpayload till din endpoint-URL.
5

Verifiera resultatet

Kontrollera ditt externa system för att bekräfta att testpayloaden anlände och behandlades som förväntat. Tillbaka i AgencyHandy, klicka in i webhooken för att granska dess historik — du kan se hela begäran, svaret som din endpoint returnerade, och leverera om vilken tidigare händelse som helst vid behov.
Använd ett verktyg som Webhook.site eller RequestBin som temporär endpoint under konfigurationen för att inspektera den exakta payload-strukturen innan du kopplar upp ditt riktiga system.

​
Autentisera webhook-payloads

Varje utgående webhook-begäran från AgencyHandy inkluderar ett signaturhuvud som din endpoint kan använda för att verifiera att payloaden är äkta och inte har manipulerats.

​
Signaturhuvud

x-ah-sig: <signature>
AgencyHandy lägger till detta huvud i varje webhook-begäran. Extrahera värdet från inkommande begäranden och skicka det till verifieringsendpointen.

​
Verifiera en webhook-signatur

Skicka följande begäran för att bekräfta att en payload är autentisk: 
POST https://api.agencyhandy.com/api/v1/webhooks/verify-signature
Content-Type: application/json
​
webhookId
string
obligatorisk
ID:t för den webhook som tog emot händelsen. Hittas på webhook-detaljsidan i AgencyHandy.
​
signature
string
obligatorisk
Värdet på x-ah-sig-huvudet från den inkommande webhook-begäran.
​
secret
string
obligatorisk
Webhook-hemligheten som visas på webhook-detaljsidan i AgencyHandy.
​
payload
object
obligatorisk
Den råa JSON-kroppen mottagen från AgencyHandys webhook-begäran.
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 är giltig. FAILED när verifieringen misslyckas (HTTP 403).
Success (200)
{
  "verification_status": "SUCCESS"
}
Failure (403)
{
  "type": "PermissionError",
  "status": 403,
  "verification_status": "FAILED"
}
Håll din webhook-hemlighet konfidentiell. Rotera den regelbundet och uppdatera din verifieringslogik omedelbart efter rotation. Exponera den aldrig i klientkod eller offentliga arkiv.

​
Viktiga noteringar

  • Din endpoint-URL måste vara en offentligt tillgänglig HTTPS POST-URL.
  • Om din endpoint är tillfälligt otillgänglig, kontrollera webhookens historikpanel i AgencyHandy — du kan leverera om vilken tidigare händelse som helst direkt därifrån.
  • Övervaka webhook-aktiviteten regelbundet för att upptäcka misslyckade leveranser eller obehöriga åtkomstförsök.
  • Webhooks som upprepade gånger misslyckas kan pausas av AgencyHandy — granska leveransloggar för att fånga problem tidigt.