Webhookok, szerver–szerver postbackek és a REST API

Három módja van annak, hogy a TapTime-ot más rendszerekhez kapcsolja, mind egy menüpont alatt. Ezeket csak a cég tulajdonosa kezelheti. A csevegőértesítésekhez, valamint a Zapierhez, a Make-hez, az n8n-hez vagy a Pipedreamhez lásd a saját útmutatóikat – ugyanazokat az eseményeket használják.

Panel Integrációk Webhookok és API

Mit használjon	Mikor
Webhook	A saját rendszerének vagy egy CRM-nek minden foglalásról, rendelésről vagy hűségprogram-változásról tudnia kell, minden részlettel.
Postback	Egy hirdetési hálózat, affiliate partner vagy követőrendszer adott Önnek egy postback URL-t, amelyet minden konverziónál meg kell hívni.
REST API	A rendszere akkor akarja lekérni a foglalásokat, amikor neki tetszik, vagy megerősíteni és lemondani őket.

Küldhető események

Esemény	Mikor
booking.requested	Egy vendég olyan foglalást kért, amely az Ön megerősítésére vár
booking.confirmed	Egy foglalás megerősítést nyert
booking.cancelled	A vendég vagy a hely lemondta
booking.no_show	A vendég nem jelent meg
booking.completed	A látogatás véget ért
order.placed	Egy vendég rendelése beérkezett Önhöz (az oldaláról vagy egy asztal QR-kódjáról)
order.paid	Bármely rendelést kifizettek, a kasszán is
loyalty.member_joined	Egy ügyfél megkapta az első pecsétjét egy programban
loyalty.stamp_added	Pecsét került egy kártyára
loyalty.reward_issued	Egy kártya betelt, és kiadtuk a jutalmát
loyalty.reward_redeemed	Egy jutalmat átadtak

Webhookok

1
Webhook hozzáadása
Illessze be a végpontja https-címét, és válassza ki az eseményeket – foglalások, rendelések, hűségprogram, vagy mindegyik.
2
Teszt küldése
Azonnal kimegy egy mintaesemény, és megjelenik a végpontja által adott válasz.
3
Ellenőrizze az aláírást
Minden kérésnek van TapTime-Signature fejléce: t=<time>,v1=<a „t.body” HMAC-SHA256 értéke az Ön aláíró titkával>. Vesse össze, mielőtt megbízna a kérésben.

A törzs JSON: az esemény azonosítója, típusa és ideje, valamint a teljes foglalás, rendelés vagy hűségkártya a data.booking, a data.order vagy a data.loyalty alatt – a vendéggel, az időponttal, az asztallal, a szolgáltatással vagy a tételekkel, az állapottal és azzal, honnan érkezett (UTM-címkék és kattintásazonosítók).

Válaszoljon bármilyen 2xx állapotkóddal. Minden mást nagyjából egy nap alatt 8-szor próbálunk újra.
Minden eseménynek van azonosítója: ha kétszer kapja meg, hagyja figyelmen kívül a másodikat.
Ha 410 Gone kóddal válaszol, a TapTime abbahagyja az esemény újrapróbálását.
Az átirányításokat nem követjük, a magánhálózati címeket pedig elutasítjuk.

Szerver–szerver postbackek

Illessze be a követőrendszerétől kapott postback URL-t, és kattintson a helyőrzőkre a foglalási adatok beszúrásához, például: https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Az elérhető helyőrzők között van a {click_id}, az {event}, a {booking_id}, a {value}, a {currency}, a {party_size}, az {utm_source}, az {utm_campaign}, a {gclid} és az {fbclid}. A követőrendszer kattintásazonosítója akkor jut el a foglaláshoz, ha a foglalási link tartalmazza a click_id, a clickid vagy a subid paramétert.

REST API

1
API-kulcs létrehozása
Adjon neki nevet, és válassza a csak olvasást, vagy az olvasást és írást, amellyel megerősítés, lemondás és meg nem jelenés jelölése is lehetséges.
2
Másolja ki most
A kulcs csak egyszer jelenik meg. Tárolja a szerverén – soha ne weboldalon vagy alkalmazásban.
3
Hívja meg az API-t
Küldje Authorization: Bearer <key> formában a https://api.tapti.me/v1/company címre.

Kérés	Visszaadja
GET /v1/company	A céget, amelyhez a kulcs tartozik
GET /v1/company/reservations, /appointments	A foglalásokat status, branchId, from, to vagy updatedSince szerint szűrve, oldalanként 100-at
GET /v1/company/reservations/{id}	Egy foglalást
POST /v1/company/reservations/{id}/status	Módosítja az állapotot (írási kulcsokkal)
GET /v1/company/orders, /orders/{id}	A rendeléseket tételeikkel és végösszegeikkel, status, source, fulfilment, from, to vagy paidSince szerint szűrve
GET /v1/company/loyalty/programs, /cards, /rewards	A hűségprogramokat, a tagok kártyáit és a megszerzett jutalmakat
GET /v1/company/events?after={cursor}	Minden foglalási, rendelési és hűségprogram-eseményt sorrendben – kérdezze le rendszeresen a szinkronhoz; csak egyes típusokhoz adja hozzá a type=order,loyalty paramétert
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	Feliratkoztat egy URL-t az eseményekre, illetve leiratkoztatja – ezt használják a Zapier-, Make-, n8n- és Pipedream-alkalmazások

Ha valami nem sikerül

Minden végpont Kézbesítési naplója felsorolja az utolsó 25 kézbesítést az állapotkóddal és a rendszere által adott válasszal. A sikertelen kézbesítéseket a rendszer magától újrapróbálja; az „Újraküldés” egyet azonnal újraküld.

Gyakori kérdések

Mehet egy webhook a Zapierbe vagy a Make-be?

Igen – használja az Integrációk → Automatizálás menüpontot, amely ellenőrzi, hogy a cím a platformhoz tartozik-e, és megmutatja a saját lépéseit. Hozzon létre egy „Catch hook”-ot (Zapier), egy „Custom webhook”-ot (Make), egy Webhook node-ot (n8n) vagy egy HTTP-triggert (Pipedream), illessze be a címét, és nyomja meg a Teszt küldése gombot, hogy az eszköz megismerje a mezőket.

Elvesztettem az aláíró titkomat.

A tulajdonos a végpontnál újra megjelenítheti, vagy lecserélheti. A csere azonnal újat állít ki, a régi pedig megszűnik működni.

Hasznos volt ez a cikk?

Nem kapott választ?

Írjon nekünk, és nevezze meg az oldalt, amelyen járt. Minden üzenetet egy kollégánk olvas el, és azon a nyelven válaszol, amelyen írt.

Írjon nekünk