Trys būdai sujungti TapTime su kitomis sistemomis, visi vienoje skiltyje. Juos valdyti gali tik įmonės savininkas. Apie pranešimus pokalbiuose ir Zapier, Make, n8n ar Pipedream skaitykite atskiruose straipsniuose — jie naudoja tuos pačius įvykius.
Valdymo skydelis Integracijos Webhook ir API
| Naudokite | Kada |
|---|---|
| Webhook | Jūsų sistema ar CRM turi sužinoti apie kiekvieną rezervaciją, užsakymą ar lojalumo pakeitimą su visomis detalėmis. |
| Postback | Reklamos tinklas, partnerių programa ar sekimo sistema davė Jums postback URL, kurį reikia iškviesti po kiekvienos konversijos. |
| REST API | Jūsų sistema nori gauti rezervacijas, kai jai patogu, arba jas patvirtinti ir atšaukti. |
Įvykiai, kuriuos galite siųsti
| Įvykis | Kada |
|---|---|
| booking.requested | Svečias pateikė rezervacijos užklausą, kuri laukia Jūsų patvirtinimo |
| booking.confirmed | Rezervacija patvirtinta |
| booking.cancelled | Svečias arba įstaiga atšaukė |
| booking.no_show | Svečias neatvyko |
| booking.completed | Apsilankymas baigtas |
| order.placed | Svečio užsakymas Jus pasiekė (iš Jūsų puslapio arba per staliuko QR kodą) |
| order.paid | Apmokėtas bet kuris užsakymas, įskaitant kasoje |
| loyalty.member_joined | Klientas gavo pirmąjį spaudą programoje |
| loyalty.stamp_added | Pridėtas spaudas |
| loyalty.reward_issued | Kortelė užpildyta ir išduotas jos prizas |
| loyalty.reward_redeemed | Prizas įteiktas |
Webhook
-
1
Pridėti webhook
Įklijuokite savo galinio taško https adresą ir pasirinkite įvykius — rezervacijas, užsakymus, lojalumą arba visus.
-
2
Siųsti bandymą
Pavyzdinis įvykis išsiunčiamas iš karto, ir parodomas Jūsų galinio taško atsakymas.
-
3
Patikrinkite parašą
Kiekviena užklausa turi antraštę TapTime-Signature: t=<time>,v1=<HMAC-SHA256 iš „t.body“ su Jūsų pasirašymo slaptažodžiu>. Prieš pasitikėdami užklausa, palyginkite jį.
Turinys yra JSON: įvykio ID, tipas ir laikas bei visa rezervacija, užsakymas ar lojalumo kortelė lauke data.booking, data.order arba data.loyalty — su svečiu, laiku, staliuku, paslauga ar prekėmis, būsena ir tuo, iš kur ji atėjo (UTM žymos ir paspaudimų ID).
- Atsakykite bet kuria 2xx būsena. Bet kas kita kartojama 8 kartus maždaug per parą.
- Kiekvienas įvykis turi ID: jei gaunate jį du kartus, antrąjį ignoruokite.
- Atsakykite 410 Gone, ir TapTime nustos kartoti tą įvykį.
- Peradresavimai nevykdomi, o privačių tinklų adresai atmetami.
Serverio postback
Įklijuokite postback URL, kurį davė Jūsų sekimo sistema, ir spustelėkite vietos rezervavimo ženklus, kad įterptumėte rezervacijos duomenis, pavyzdžiui, https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Galimi vietos rezervavimo ženklai: {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid}, {fbclid} ir kiti. Sekimo sistemos paspaudimo ID pasiekia rezervaciją, kai Jūsų rezervacijos nuorodoje yra click_id, clickid arba subid.
REST API
-
1
Sukurti API raktą
Suteikite jam pavadinimą ir pasirinkite „tik skaityti“ arba „skaityti ir rašyti“, kad būtų galima patvirtinti, atšaukti ir pažymėti neatvykimus.
-
2
Nukopijuokite jį dabar
Raktas rodomas vieną kartą. Laikykite jį savo serveryje — niekada ne tinklalapyje ar programėlėje.
-
3
Kvieskite API
Siųskite jį kaip Authorization: Bearer <key> adresu https://api.tapti.me/v1/company.
| Užklausa | Grąžina |
|---|---|
| GET /v1/company | Įmonę, kuriai priklauso raktas |
| GET /v1/company/reservations, /appointments | Rezervacijas, filtruojamas pagal status, branchId, from, to arba updatedSince, po 100 puslapyje |
| GET /v1/company/reservations/{id} | Vieną rezervaciją |
| POST /v1/company/reservations/{id}/status | Pakeičia būseną (rašymo raktai) |
| GET /v1/company/orders, /orders/{id} | Užsakymus su prekėmis ir sumomis, filtruojamus pagal status, source, fulfilment, from, to arba paidSince |
| GET /v1/company/loyalty/programs, /cards, /rewards | Lojalumo programas, narių korteles ir jų uždirbtus prizus |
| GET /v1/company/events?after={cursor} | Visus rezervacijų, užsakymų ir lojalumo įvykius iš eilės — užklausinėkite periodiškai, kad duomenys būtų sinchronizuoti; pridėkite type=order,loyalty, jei reikia tik kai kurių |
| POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id} | Užprenumeruoja URL įvykiams ir atšaukia prenumeratą — tai naudoja Zapier, Make, n8n ir Pipedream programėlės |
Kai kas nors nepavyksta
Kiekvieno galinio taško siuntimų žurnale matomi paskutiniai 25 siuntimai su būsenos kodu ir Jūsų sistemos atsakymu. Nepavykę siuntimai kartojami automatiškai; „Siųsti dar kartą“ pakartoja vieną iš karto.
Dažnai užduodami klausimai
Ar webhook gali būti siunčiamas į Zapier ar Make?
Taip — naudokite Integracijos → Automatizavimas: ten patikrinama, ar adresas priklauso platformai, ir parodomi jos žingsniai. Sukurkite „Catch hook“ (Zapier), „Custom webhook“ (Make), Webhook mazgą (n8n) arba HTTP paleidiklį (Pipedream), įklijuokite jo adresą ir paspauskite „Siųsti bandymą“, kad įrankis sužinotų laukus.
Praradau pasirašymo slaptažodį.
Savininkas gali jį vėl parodyti galinio taško nustatymuose arba pakeisti nauju. Pakeitus iš karto išduodamas naujas, o senasis nustoja veikti.
Ačiū — tai padeda mums tobulinti šiuos gidus.
Parašykite mums ir nurodykite puslapį, kuriame buvote. Kiekvieną žinutę skaito žmogus ir atsako ta kalba, kuria rašėte.
Parašykite mums