Webhookok: a foglalások és vendégek eseményei azonnal a saját rendszeredben

Ha valami történik az üzletedben (új foglalás, lemondás, új vendég, kifizetett eladás), azonnal elküldjük egy általad megadott címre. Így a CRM-ed, a hírlevél-rendszered, egy Google-táblázat vagy a saját szervered mindig naprakész, kézi exportálás nélkül.

Mire jó

• Hírlevél és marketing: új vendég érkezett, és a hírlevél-rendszer (ActiveCampaign, Mailchimp, Klaviyo) automatikusan felveszi.
• CRM: foglalás létrejött vagy teljesült, és a CRM-ben frissül a kontakt.
• Kampánymérés: az online foglalás eseménye viszi, melyik hirdetésből jött a vendég (utm_source, utm_campaign, a hirdetés neve).
• Csapat: „nem jelent meg” esemény, és üzenet megy a csapat Slack-csatornájára.
• Bármi, ami webhookot fogad: Zapier, Make, n8n vagy saját szerver.

Beállítás

1. Beállítások → Integrációk és AI → Webhookok → Új végpont.
2. Adj neki nevet, add meg a Cél URL-t (https:// kezdetű; a Zapier, Make vagy n8n „Webhook” lépése adja), és pipáld be az eseményeket.
3. Mentés után egyszer látod az aláíró titkot. Másold ki, ezzel ellenőrzi a fogadó oldal, hogy a kérés tényleg tőlünk jön.
4. Ugyanitt küldj egy próbát: valósághű mintaadatot küldünk a választott eseménnyel, és megmutatjuk, mit válaszolt a rendszered. A Zapier és a Make a próbából megtanulja a mezőket.

Az oldal részei

• Mutatók: aktív végpontok, az elmúlt 30 nap elküldött eseményei, a sikeres arány és a sikertelen kézbesítések.
• Végpontok: mindegyiknél látod, működik-e, mikor ment ki az utolsó esemény, és mit válaszolt a címzett. Ha egy végpont hibázik, sárga sáv jelzi, és egy kattintással megnyitod a hozzá tartozó naplót. A kapcsolóval ideiglenesen kikapcsolhatod.
• Legutóbbi kézbesítések: minden elküldött esemény a címzett válaszával. Egy sorra kattintva látod a teljes elküldött tartalmat, a válaszát és minden próbálkozást. A sikertelen kézbesítést az Újraküldés gombbal újra elküldheted, ha kijavítottad a hibát.
• A ⋯ menüben szerkesztheted a végpontot, lecserélheted az aláíró titkot, vagy törölheted.

Mely események mennek ki?

• Foglalások: létrejött, jóváhagyásra vár, visszaigazolva, elutasítva, módosult (szolgáltatás, munkatárs, ár, megjegyzés), áthelyezve, lemondva, nem jelent meg, befejezve, emlékeztető kiment.
• Vendégek és űrlapok: új vendég, adatai módosultak, törölve, űrlap kitöltve, születésnap, rég nem járt.
• Eladás és fizetés: eladás lezárva, visszatérítés, eladás sztornózva, fizetés beérkezett.
• Bérletek, tagságok, utalványok: bérlet megvásárolva, bérlet hamarosan lejár, tagság elindult, megújult, sikertelen terhelés, lemondva, lejárt, ajándékutalvány megvásárolva és beváltva.
• Várólista és csoportos órák: feliratkozott a várólistára, órára jelentkezett, részt vett az órán.
• Marketing és értékelések: félbehagyott foglalás, értékelés érkezett, újrafoglalási emlékeztető, értékelés-kérés.
• Szálloda: érkezés, távozás és az érkezés előtti emlékeztetők.

Az „Automatizálás kell” jelölésű események (például születésnap, emlékeztető) csak akkor mennek ki, ha a hozzájuk tartozó automatizálás be van kapcsolva.

A félbehagyott foglalás akkor megy ki, ha a vendég megadta az elérhetőségét, de egy órán belül nem fejezte be a foglalást. Foglalási kísérletenként egyszer, a folytatás linkjével. Hírlevél- vagy hirdetési újracélzáshoz ez a legértékesebb esemény.

Az űrlap kitöltve esemény a válaszokat is viszi. Ezek érzékeny (például egészségügyi) adatok lehetnek, ezért csak megbízható rendszerbe küldd.

Mit kap a fogadó oldal?

Minden esemény ugyanabban a borítékban érkezik:

{
  "id": "evt_5d7f8a3b9c2e4d1a8b6c2f3e",
  "event": "appointment.created",
  "apiVersion": "2026-05",
  "occurredAt": "2026-10-02T08:15:23.000Z",
  "tenant": { "id": "...", "slug": "demo-salon", "name": "Demo Salon" },
  "data": {
    "customer": { "id": "...", "firstName": "Anna", "lastName": "Minta", "email": "[email protected]", "phone": "+36..." },
    "appointment": {
      "id": "...",
      "startTime": "2026-10-05T13:00:00.000Z",
      "endTime": "2026-10-05T14:00:00.000Z",
      "status": "CONFIRMED",
      "price": 12000,
      "serviceName": "Gél lakk",
      "staffName": "Balogh Nóra",
      "locationName": null,
      "bookedOnline": true,
      "source": { "utmSource": "facebook", "utmMedium": "paid_social", "utmCampaign": "oszi_akcio", "utmContent": "video_1" }
    }
  }
}

Az id minden próbálkozásnál ugyanaz: erre szűrd a duplikációt.

Hiba esetén

• Egy kérésre 15 másodpercig várunk. Bármilyen 2xx válasz sikeres kézbesítés.
• Hibánál (nem 2xx válasz, időtúllépés, elérhetetlen cím) 1 perc, 5 perc, 30 perc, 2 óra és 6 óra múlva újrapróbáljuk, összesen 6 próbálkozás.
• Átirányítást (3xx) nem követünk: a végleges címet add meg.
• Kikapcsolt végpontra nem küldünk, a már sorban álló próbálkozások is elmaradnak.
• A kézbesítési naplót 30 napig őrizzük.

Korlátok

• Üzletenként legfeljebb 10 végpont.
• Csak https:// kezdetű cím adható meg, belső hálózati címre nem küldünk.

Hogyan tovább

• Fogadó oldal mintakóddal: Webhook fogadó beállítása
• ActiveCampaign példa: /help/webhooks-activecampaign

A Bookinda Business alkalmazásban

A telefonos appban ugyanezt éred el: Menü → Beállítások → Integrációk és AI → Webhookok, vagy Bővítmények → Integrációk → Webhookok.

• Új végpont: a jobb felső plusz gomb. Megadod a nevet, a https:// kezdetű címet, és csoportonként kipipálod az eseményeket. Mentés után egyszer megjelenik az aláíró kulcs (másolható, megosztható), utána rögtön küldhetsz egy tesztet.
• Végpont kártyája: ki-be kapcsoló, az utolsó kézbesítés eredménye, Teszt, Napló, a három pont alatt Szerkesztés, Új aláíró kulcs (csak a tulajdonos) és Törlés.
• Kézbesítési napló: szűrés állapot és végpont szerint, egy sorra koppintva a próbálkozások, a küldött tartalom és a fogadó válasza. Innen újra is küldheted.

A szabályok ugyanazok, mint a weben: legfeljebb 10 végpont, tulajdonos és vezető kezelheti, és a Webhookok bővítmény kell hozzá.