Vad är en webhook?
En webhook är ett sätt för Bokadirekt att automatiskt skicka information till ert system när något händer – till exempel när en bokning görs. Istället för att ert system behöver fråga Bokadirekt om det hänt något nytt, skickar vi en så kallad HTTP POST med data i JSON-format till en URL ni själva väljer, så fort en vald händelse inträffar.
Det gör det enkelt att hålla ett eget system, till exempel en kunddatabas eller ett affärssystem, uppdaterat i realtid – utan att ni behöver bygga något som ständigt pollar Bokadirekt för nyheter.
Vilka händelser kan ni få webhooks för?
Ni väljer själva vilka händelser ni vill bli meddelade om:
Bokning skapas
Bokning uppdateras
Bokning tas bort (avbokning)
Kund uteblir (no-show)
Produktlager ändras, till exempel vid en försäljning eller påfyllning
Hur detaljerat kan ni styra webhooken?
Ni väljer själva hur brett eller smalt en webhook ska gälla:
Hela verksamheten – alla platser och all personal
En specifik salong/plats
En enskild anställd
Det gör att ni kan sätta upp flera webhooks med olika syften, till exempel en som bara bevakar en viss salong eller en viss anställd.
Kom igång
Kontakta supporten via chatten för att aktivera funktionen. Sedan hanterar du dina webhooks själv under Inställningar > Övrigt > API-tjänst & webhooks. Klicka på + Lägg till Webhook, fyll i alla fält och spara.
Hemlighet — en kod eller ett lösenord ni själva väljer. Den skickas med varje webhook (i en egen rad i meddelandet, en s.k. "header") så att ert system kan kontrollera att meddelandet verkligen kommer från Bokadirekt och inte från någon annan.
Vad kostar det?
Webhooks kostar 199 kr ex moms/mån. Ingår om ni skaffar vårt API — läs mer om API:et här.
Hur ser en webhook ut?
Vid en bokning, uppdatering eller avbokning innehåller webhooken bland annat: plats (namn och ID), personal (namn och ID), tjänst (namn och ID), pris, start- och sluttid, kunduppgifter (ID, namn, telefon, e-post), om det är en ny kund, samt om bokningen gjordes online eller manuellt av personalen. Beroende på bokningen kan den även innehålla en anteckning och varifrån bokningen kom.
{ "Id": "7B602D92-E4B9-4520-993E-DBC311AB3E02", "LocationId": "272abcd0-69d8-e791-20c2-0009aa51234f", "LocationName": "Frisörsalongen City", "PersonId": "6a123b12-1234-123-abc1-1a12fb041efc", "PersonName": "Frisör Martin", "ServiceId": "123abc12-e8d0-a123-80c3-0003ff530461", "ServiceName": "Luggklippning", "BookingPrice": 299.0, "BookingStartDate": "2025-05-28T15:15:00+00:00", "BookingEndDate": "2025-05-28T15:45:00+00:00", "Customer": { "Id": "1a123fb5-cc4b-4971-8d27-1ab2c3456abc", "MobilePhoneNumber": "+46723456789", "PhoneNumber": "+46723456789", "FirstName": "Jens", "LastName": "Jansson", "EmailAdress": "jens.jansson@bokadirekt.se", "NewCustomer": false }, "EventCreated": "2024-08-27T15:14:57.8562571+00:00", "BookedOnline": true, "Cancelled": false, "NewCustomer": false}Vid en lagerändring, till exempel när en produkt säljs, ser webhooken istället ut så här – med uppgifter om produkten, salongen, lagersaldo före och efter, samt pris och moms:
{ "ProductId": "3a1f2b44-9c21-4b31-8f2a-1a2b3c4d5e6f", "ProductName": "Shampoo 250ml", "LocationId": "272abcd0-69d8-e791-20c2-0009aa51234f", "LocationName": "Frisörsalongen City", "PreviousStock": 10, "CurrentStock": 8, "ChangeAmount": -2, "ChangeType": "Sale", "Price": 299.0, "VatRate": 0.25, "EventCreated": "2025-05-28T15:20:00+00:00"}Teknisk dokumentation
Är du utvecklare och vill se den fullständiga tekniska dokumentationen för webhooks och vårt API, till exempel alla fält och datatyper? Du hittar den här: Bokadirekts API-dokumentation.