A booked4.us felületén elérhető Webhook integráció segítségével lekérheted az egyes foglalási műveletekhez tartozó adatokat, így összekapcsolhatod időpontfoglalódat más általad használt rendszerekkel.
Ebben a blogbejegyzésben összegyűjtöttük a Webhook integrációval kapcsolatos legfontosabb tudnivalókat és beállítási lehetőségeket.
Új funkciónkat az admin nézet Beállítások / Webhook integráció menüpontjában találod. Itt tekintheted át és szerkesztheted az integrációhoz szükséges végpontokat.
Új végpont hozzáadásával az általad megadott URL-re elküldjük a megfelelő foglalások adatait.
A felugró ablakban megadhatod a foglaláshoz tartozó művelet típusát (1), a végpont tetszőleges linkjét (2), valamint aktiválhatod vagy inaktiválhatod az adatok küldését (3). A Mentés (4) gombra kattintva tudod rögzíteni a végpontot, vagy elmenteni a módosításokat.
Például ha az új foglaláshoz adsz meg végpontot, mindig elküldjük a megfelelő adatokat számodra, amikor új foglalást adnak le időpontfoglalódban.
A felvett végpontokat bármikor szerkesztheted a ceruza ikonra kattintva, vagy véglegesen törölheted őket.
Itt láthatod azt a struktúrát, amelyben elküldjük számodra a foglalási adatokat. Minden változót kommenttel láttunk el annak érdekében, hogy egyértelműen látható legyen, mely foglalási adat tartozik hozzá.
“Reservations”: [
{
“ReservationDetails”: {
“Id”: 0, // A foglalás egyedi azonosítója
“EventState”: “string”, // A foglalás állapota (lehetséges értékei: “reserved” – foglalt, “notconfirmed” – nem visszaigazolt, “deleted” – törölt)
“UserName”: “string”, // Azon felhasználó teljes neve, akinek a foglalást rögzítik
“UserEmail”: “string”, // Azon felhasználó e-mail címe, akinek a foglalást rögzítik
“UserTel”: “string”, // Azon felhasználó telefonszáma, akinek a foglalást rögzítik
“PersonCount”: 0, // A foglaláshoz tartozó személyek száma
“ClientKey”: “string”, // A foglalási folyamat egyedi azonosítója
“ArriveTime”: “string”, // A foglalás tervezett érkezési ideje
“StartTime”: “string”, // A foglalt időpont kezdete (dátummal és idővel megadva)
“EndTime”: “string”, // A foglalt időpont vége (dátummal és idővel megadva)
“Title”: “string” // A szolgáltatás neve, amelyhez a foglalás beérkezett
},
“ServiceDetails”: {
“Id”: 0, // A szolgáltatás egyedi azonosítója
“Name”: “string”, // A szolgáltatás neve
“Duration”: “string”, // A szolgáltatás időtartama
“Description”: “string”, // A szolgáltatás leírása
“Background”: “string”, // A szolgáltatás háttérszíne
“Price”: “string”, // A szolgáltatás ára
“Currency”: “string”, // A szolgáltatás árához tartozó pénznem
“CurrencyText”: “string”, // A szolgáltatás árához tartozó pénznem 3 betűs kódja, pl. HUF
“Note”: “string”, // A szolgáltatáshoz csatolt megjegyzés
“DurationToUser”: 0 // A szolgáltatás felhasználók számára megjelenő időtartama
},
“QuestionDetails”: [ // A foglaláshoz tartozó egyedi kérdések és az azokra adott válaszok
{
“Type”: “string”, // A kérdés típusa (lehetséges értékei: “List”, “FreeText”, “YesNo”, “Date”)
“Value”: “string”, // A kérdésre adott válasz
“Id”: 0, // A kérdés egyedi azonosítója
“Name”: “string” // A kérdés felhasználók számára látható szövege
}
],
“ScheduleDetails”: {
“Id”: 0, // Az órarendi időpont egyedi azonosítója
“Note”: “string” // Az órarendi időponthoz tartozó megjegyzés
},
“ModifyLink”: “string”, // A foglalás ügyfél oldali módosító linkje
“AdminModifyLink”: “string” // A foglalás admin oldali módosító linkje
}
],
“CompanyId”: “string”, // Az időpontfoglaló egyedi azonosítója
“EventType”: “string”, // A bekövetkezett foglalási művelet típusa (Lehetséges értékei: Create – Új foglalás, Update – Módosítás, Delete – Törlés)
“ReservationsLink”: “string”, //A foglalási folyamatban leadott összes foglalást listázó oldal linkje.
Regisztrált felhasználónál az összes eddigi foglalást listázó oldal linkje.
“User”: { // Az a felhasználó, akinek a foglalást rögzítik
“Id”: 0, // Egyedi azonosító
“UserName”: “string”, // Felhasználónév
“FullName”: “string”, // Teljes név
“Email”: “string”, // E-mail cím
“TelNumber”: “string”, // Telefonszám
“NewResEmailNeed”: true // Annak az indikátora, hogy a felhasználó szeretne-e visszaigazoló e-mailt kapni a foglalásról
},
“CreatorUser”: { // Az a felhasználó, aki a foglalást rögzíti
“Id”: 0, // Egyedi azonosító
“UserName”: “string”, // Felhasználónév
“FullName”: “string”, // Teljes név
“Email”: “string”, // E-mail cím
“TelNumber”: “string”, // Telefonszám
“NewResEmailNeed”: true // Annak az indikátora, hogy a felhasználó szeretne-e visszaigazoló e-mailt kapni a foglalásról
},
“Location”: { // A naptár adatai, amiben a foglalást rögzítik
“PhoneNumber”: “string”, // A kapcsolattartó telefonszáma
“MinTimeModify”: 0, // Foglalás legkésőbbi módosítása
“Id”: 0, // A naptár egyedi azonosítója
“Name”: “string” // A naptár neve
},
“Lang”: “string”, // A foglalás során éppen használt nyelvi azonosító. Pl. hu-HU
“IsAdmin”: true // Annak az indikátora, hogy a foglalást admin oldalról adták-e le
}
Ha bármilyen kérdésed van a funkcióval kapcsolatban, keresd ügyfélszolgálatunkat a kapcsolat@booked4.us e-mail címen vagy +36 1 510 0212 telefonszámon.