Tři způsoby, jak propojit TapTime s jinými systémy, všechny na jednom místě. Spravovat je může jen vlastník firmy. Upozornění do chatu a Zapier, Make, n8n nebo Pipedream mají vlastní návody — používají stejné události.
Panel Integrace Webhooky a API
| Použijte | Kdy |
|---|---|
| Webhook | Váš vlastní systém nebo CRM se má dozvědět o každé změně rezervace, objednávky nebo věrnostního programu, se všemi podrobnostmi. |
| Postback | Reklamní síť, affiliate partner nebo tracker vám dal postback URL, kterou máte volat při každé konverzi. |
| REST API | Váš systém si chce rezervace stahovat, kdy sám chce, nebo je potvrzovat a rušit. |
Události, které můžete odesílat
| Událost | Kdy |
|---|---|
| booking.requested | Host požádal o rezervaci, která čeká na vaše potvrzení |
| booking.confirmed | Rezervace je potvrzena |
| booking.cancelled | Host nebo podnik rezervaci zrušil |
| booking.no_show | Host nepřišel |
| booking.completed | Návštěva skončila |
| order.placed | Objednávka hosta k vám dorazila (z vaší stránky nebo přes QR kód na stole) |
| order.paid | Jakákoli objednávka byla zaplacena, i na pokladně |
| loyalty.member_joined | Zákazník získal první razítko v programu |
| loyalty.stamp_added | Bylo přidáno razítko |
| loyalty.reward_issued | Karta byla zaplněna a odměna vydána |
| loyalty.reward_redeemed | Odměna byla předána |
Webhooky
-
1
Přidat webhook
Vložte https adresu svého endpointu a zvolte události — rezervace, objednávky, věrnostní program, nebo všechny.
-
2
Odeslat test
Ukázková událost odejde okamžitě a zobrazí se odpověď, kterou váš endpoint vrátil.
-
3
Ověřte podpis
Každý požadavek má hlavičku TapTime-Signature: t=<time>,v1=<HMAC-SHA256 řetězce „t.body“ s vaším podpisovým klíčem>. Než požadavku uvěříte, porovnejte ji.
Tělo je JSON: ID, typ a čas události a celá rezervace, objednávka nebo věrnostní karta v data.booking, data.order nebo data.loyalty — s hostem, časem, stolem, službou nebo položkami, stavem a tím, odkud přišla (UTM značky a identifikátory kliknutí).
- Odpovězte libovolným stavem 2xx. Cokoli jiného se zopakuje 8krát během přibližně jednoho dne.
- Každá událost má ID: pokud ji dostanete dvakrát, druhou ignorujte.
- Odpovězte 410 Gone a TapTime přestane danou událost opakovat.
- Přesměrování se nesledují a adresy v privátních sítích se odmítají.
Postbacky mezi servery
Vložte postback URL, kterou vám dal tracker, a klikáním na zástupné symboly vložte údaje o rezervaci, například https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Mezi dostupné zástupné symboly patří {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} a {fbclid}. Identifikátor kliknutí z trackeru se k rezervaci dostane, když váš odkaz na rezervaci nese click_id, clickid nebo subid.
REST API
-
1
Vytvořit klíč API
Pojmenujte ho a zvolte jen pro čtení, nebo čtení a zápis, který umožní potvrzovat, rušit a označovat nedostavení.
-
2
Zkopírujte ho hned
Klíč se zobrazí jen jednou. Uložte ho na svůj server — nikdy do webové stránky ani aplikace.
-
3
Zavolejte API
Posílejte ho jako Authorization: Bearer <key> na https://api.tapti.me/v1/company.
| Požadavek | Vrací |
|---|---|
| GET /v1/company | Firmu, ke které klíč patří |
| GET /v1/company/reservations, /appointments | Rezervace filtrované podle status, branchId, from, to nebo updatedSince, 100 na stránku |
| GET /v1/company/reservations/{id} | Jednu rezervaci |
| POST /v1/company/reservations/{id}/status | Změnu stavu (klíče se zápisem) |
| GET /v1/company/orders, /orders/{id} | Objednávky s položkami a součty, filtrované podle status, source, fulfilment, from, to nebo paidSince |
| GET /v1/company/loyalty/programs, /cards, /rewards | Věrnostní programy, karty členů a odměny, které získali |
| GET /v1/company/events?after={cursor} | Všechny události rezervací, objednávek a věrnostního programu v pořadí — dotazujte se pravidelně a zůstanete synchronizovaní; přidejte type=order,loyalty jen pro některé |
| POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id} | Přihlášení URL k odběru událostí a jeho zrušení — používají to aplikace Zapier, Make, n8n a Pipedream |
Když něco selže
Protokol doručení u každého endpointu uvádí posledních 25 doručení se stavovým kódem a odpovědí vašeho systému. Neúspěšná doručení se opakují sama; „Odeslat znovu“ jedno zopakuje hned.
Časté dotazy
Může webhook vést do Zapieru nebo Make?
Ano — použijte Integrace → Automatizace, které ověří, že adresa patří dané platformě, a ukáže vlastní postup. Vytvořte „Catch hook“ (Zapier), „Custom webhook“ (Make), uzel Webhook (n8n) nebo HTTP trigger (Pipedream), vložte jeho adresu a stiskněte Odeslat test, aby se nástroj naučil pole.
Ztratil jsem podpisový klíč.
Vlastník si ho může u endpointu znovu zobrazit, nebo ho vyměnit. Výměna okamžitě vystaví nový klíč a starý přestane fungovat.
Děkujeme — pomůže nám to návody zlepšit.
Napište nám a uveďte stránku, na které jste byli. Každou zprávu čte člověk a odpoví v jazyce, kterým jste psali.
Napište nám