Trīs veidi, kā savienot TapTime ar citām sistēmām, visi vienā sadaļā. Tos var pārvaldīt tikai uzņēmuma īpašnieks. Par paziņojumiem tērzēšanā un Zapier, Make, n8n vai Pipedream skatiet atsevišķās pamācības — tās izmanto tos pašus notikumus.
Panelis Integrācijas Webhook un API
| Izmantojiet | Kad |
|---|---|
| Webhook | Jūsu sistēmai vai CRM jāuzzina par katru rezervāciju, pasūtījumu vai lojalitātes izmaiņu ar visām detaļām. |
| Postback | Reklāmas tīkls, partneru programma vai izsekošanas rīks Jums iedeva postback URL, kas jāizsauc pie katras konversijas. |
| REST API | Jūsu sistēma vēlas iegūt rezervācijas, kad tai ērti, vai tās apstiprināt un atcelt. |
Notikumi, ko varat sūtīt
| Notikums | Kad |
|---|---|
| booking.requested | Viesis pieprasīja rezervāciju, kas gaida Jūsu apstiprinājumu |
| booking.confirmed | Rezervācija ir apstiprināta |
| booking.cancelled | Viesis vai iestāde atcēla rezervāciju |
| booking.no_show | Viesis neieradās |
| booking.completed | Apmeklējums ir beidzies |
| order.placed | Viesa pasūtījums sasniedza Jūs (no Jūsu lapas vai galdiņa QR koda) |
| order.paid | Jebkurš pasūtījums tika apmaksāts, arī kasē |
| loyalty.member_joined | Klients saņēma savu pirmo zīmogu programmā |
| loyalty.stamp_added | Tika pievienots zīmogs |
| loyalty.reward_issued | Karte tika aizpildīta un tās balva piešķirta |
| loyalty.reward_redeemed | Balva tika izsniegta |
Webhook
-
1
Pievienot webhook
Ielīmējiet sava galapunkta https adresi un izvēlieties notikumus — rezervācijas, pasūtījumus, lojalitāti vai visus.
-
2
Sūtīt testu
Parauga notikums tiek nosūtīts uzreiz, un tiek parādīta Jūsu galapunkta atbilde.
-
3
Pārbaudiet parakstu
Katram pieprasījumam ir galvene TapTime-Signature: t=<time>,v1=<HMAC-SHA256 no „t.body” ar Jūsu paraksta noslēpumu>. Salīdziniet to, pirms uzticaties pieprasījumam.
Pamatteksts ir JSON: notikuma identifikators, veids un laiks, kā arī visa rezervācija, pasūtījums vai lojalitātes karte laukā data.booking, data.order vai data.loyalty — ar viesi, laiku, galdiņu, pakalpojumu vai precēm, statusu un avotu (UTM tagi un klikšķu identifikatori).
- Atbildiet ar jebkuru 2xx statusu. Jebkas cits tiek atkārtots 8 reizes aptuveni dienas laikā.
- Katram notikumam ir identifikators: ja saņemat to divreiz, ignorējiet otro.
- Atbildiet ar 410 Gone, un TapTime pārtrauc šī notikuma atkārtošanu.
- Pāradresācijām netiek sekots, un adreses privātajos tīklos tiek noraidītas.
Servera postback
Ielīmējiet postback URL, ko Jums iedeva izsekošanas rīks, un noklikšķiniet uz vietturiem, lai ievietotu rezervācijas datus, piemēram, https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Pieejamie vietturi ir, piemēram, {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} un {fbclid}. Izsekošanas rīka klikšķa identifikators nonāk rezervācijā, ja Jūsu rezervācijas saitē ir click_id, clickid vai subid.
REST API
-
1
Izveidot API atslēgu
Piešķiriet tai nosaukumu un izvēlieties tikai lasīšanu vai lasīšanu un rakstīšanu, lai atļautu apstiprināt, atcelt un atzīmēt neierašanos.
-
2
Nokopējiet to tagad
Atslēga tiek parādīta vienreiz. Glabājiet to savā serverī — nekad tīmekļa lapā vai lietotnē.
-
3
Izsauciet API
Sūtiet to kā Authorization: Bearer <key> uz https://api.tapti.me/v1/company.
| Pieprasījums | Atgriež |
|---|---|
| GET /v1/company | Uzņēmumu, kuram pieder atslēga |
| GET /v1/company/reservations, /appointments | Rezervācijas, filtrētas pēc status, branchId, from, to vai updatedSince, 100 vienā lapā |
| GET /v1/company/reservations/{id} | Vienu rezervāciju |
| POST /v1/company/reservations/{id}/status | Statusa maiņa (rakstīšanas atslēgām) |
| GET /v1/company/orders, /orders/{id} | Pasūtījumus ar precēm un summām, filtrētus pēc status, source, fulfilment, from, to vai paidSince |
| GET /v1/company/loyalty/programs, /cards, /rewards | Lojalitātes programmas, dalībnieku kartes un viņu nopelnītās balvas |
| GET /v1/company/events?after={cursor} | Katru rezervācijas, pasūtījuma un lojalitātes notikumu secībā — vaicājiet to regulāri, lai uzturētu sinhronizāciju; pievienojiet type=order,loyalty, lai saņemtu tikai dažus |
| POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id} | Pierakstīt URL notikumiem un atrakstīt to — to izmanto Zapier, Make, n8n un Pipedream lietotnes |
Ja kaut kas neizdodas
Katra galapunkta piegāžu žurnāls parāda tā pēdējās 25 piegādes ar statusa kodu un Jūsu sistēmas atbildi. Neizdevušās piegādes tiek atkārtotas automātiski; „Sūtīt vēlreiz” atkārto vienu tūlīt.
Biežāk uzdotie jautājumi
Vai webhook var sūtīt uz Zapier vai Make?
Jā — izmantojiet „Integrācijas → Automatizācija”, kas pārbauda, vai adrese pieder platformai, un parāda savus soļus. Izveidojiet „Catch hook” (Zapier), „Custom webhook” (Make), Webhook mezglu (n8n) vai HTTP trigeri (Pipedream), ielīmējiet tā adresi un nospiediet „Sūtīt testu”, lai rīks uzzinātu laukus.
Esmu pazaudējis paraksta noslēpumu.
Īpašnieks var to atkal parādīt galapunktā vai nomainīt. Nomaiņa uzreiz izsniedz jaunu, un vecais pārstāj darboties.
Paldies — tas mums palīdz uzlabot šīs rokasgrāmatas.
Rakstiet mums un norādiet lapu, kurā bijāt. Katru ziņojumu izlasa cilvēks un atbild tajā valodā, kurā rakstījāt.
Rakstiet mums