Webhooks, postbacks server-me-server dhe REST API

Tri mënyra për ta lidhur TapTime me sisteme të tjera, të gjitha në një vend. Vetëm pronari i kompanisë mund t'i menaxhojë. Për njoftimet në chat dhe për Zapier, Make, n8n ose Pipedream, shihni udhëzuesit e tyre — përdorin të njëjtat ngjarje.

Paneli Integrimet Webhooks dhe API

Përdorni	Kur
Webhook	Sistemi juaj ose një CRM duhet të mësojë për çdo ndryshim rezervimi, porosie ose besnikërie, me të gjitha detajet.
Postback	Një rrjet reklamash, partner afiliat ose gjurmues ju ka dhënë një URL postback për ta thirrur në çdo konvertim.
REST API	Sistemi juaj do t'i marrë rezervimet kur të dojë, ose t'i konfirmojë dhe t'i anulojë.

Ngjarjet që mund të dërgoni

Ngjarja	Kur
booking.requested	Një mysafir kërkoi një rezervim që pret konfirmimin tuaj
booking.confirmed	Një rezervim u konfirmua
booking.cancelled	Anuloi mysafiri ose lokali
booking.no_show	Mysafiri nuk erdhi
booking.completed	Vizita përfundoi
order.placed	Porosia e një mysafiri mbërriti te ju (nga faqja juaj ose nga kodi QR i një tavoline)
order.paid	Çdo porosi u pagua, përfshirë në arkë
loyalty.member_joined	Një klient mori vulën e parë në një program
loyalty.stamp_added	U shtua një vulë
loyalty.reward_issued	Një kartë u përfundua dhe shpërblimi i saj u lëshua
loyalty.reward_redeemed	Një shpërblim u dorëzua

Webhooks

1
Shto webhook
Ngjitni adresën https të endpoint-it tuaj dhe zgjidhni ngjarjet — rezervimet, porositë, besnikërinë ose të gjitha.
2
Dërgo test
Një ngjarje shembull dërgohet menjëherë dhe shfaqet përgjigjja që dha endpoint-i juaj.
3
Verifikoni nënshkrimin
Çdo kërkesë ka kokën TapTime-Signature: t=<time>,v1=<HMAC-SHA256 i „t.body“ me sekretin tuaj të nënshkrimit>. Krahasojeni para se t'i besoni kërkesës.

Trupi është JSON: ID-ja, lloji dhe koha e ngjarjes, si dhe i gjithë rezervimi, porosia ose karta e besnikërisë nën data.booking, data.order ose data.loyalty — me klientin, orën, tavolinën, shërbimin ose artikujt, statusin dhe nga erdhi (etiketat UTM dhe ID-të e klikimeve).

Përgjigjuni me çdo status 2xx. Çdo gjë tjetër riprovohet 8 herë gjatë rreth një dite.
Çdo ngjarje ka një ID: nëse e merrni dy herë, shpërfilleni të dytën.
Përgjigjuni me 410 Gone dhe TapTime ndalon së riprovuari atë ngjarje.
Ridrejtimet nuk ndiqen dhe adresat në rrjete private refuzohen.

Postbacks server-me-server

Ngjitni URL-në postback që ju dha gjurmuesi dhe klikoni variablat për të futur të dhënat e rezervimit, për shembull https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. Variablat e disponueshme përfshijnë {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} dhe {fbclid}. ID-ja e klikimit nga gjurmuesi arrin te rezervimi kur lidhja juaj e rezervimit mbart click_id, clickid ose subid.

REST API

1
Krijo çelës API
Jepini një emër dhe zgjidhni Vetëm lexim, ose Lexim dhe shkrim për të lejuar konfirmimin, anulimin dhe shënimin e mosardhjeve.
2
Kopjojeni tani
Çelësi shfaqet vetëm një herë. Ruajeni në serverin tuaj — kurrë në një faqe web ose në një aplikacion.
3
Thirrni API-në
Dërgojeni si Authorization: Bearer <key> te https://api.tapti.me/v1/company.

Kërkesa	Kthen
GET /v1/company	Kompania së cilës i përket çelësi
GET /v1/company/reservations, /appointments	Rezervimet, të filtruara sipas status, branchId, from, to ose updatedSince, 100 për faqe
GET /v1/company/reservations/{id}	Një rezervim
POST /v1/company/reservations/{id}/status	Ndryshon statusin (çelësa shkrimi)
GET /v1/company/orders, /orders/{id}	Porositë me artikujt dhe totalet e tyre, të filtruara sipas status, source, fulfilment, from, to ose paidSince
GET /v1/company/loyalty/programs, /cards, /rewards	Programet e besnikërisë, kartat e anëtarëve dhe shpërblimet që kanë fituar
GET /v1/company/events?after={cursor}	Çdo ngjarje rezervimi, porosie dhe besnikërie me radhë — kërkojeni periodikisht për të qëndruar të sinkronizuar; shtoni type=order,loyalty për vetëm disa
POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id}	Abonon një URL te ngjarjet dhe anulon abonimin — këtë përdorin aplikacionet për Zapier, Make, n8n dhe Pipedream

Kur diçka dështon

„Regjistri i dërgesave“ i çdo endpoint-i liston 25 dërgesat e fundit me kodin e statusit dhe përgjigjen që dha sistemi juaj. Dërgesat e dështuara riprovohen vetë; „Dërgo përsëri“ riprovon njërën tani.

Pyetje të shpeshta

A mund të shkojë një webhook te Zapier ose Make?

Po — përdorni Integrimet → Automatizimi, që kontrollon nëse adresa i përket platformës dhe tregon hapat e saj. Krijoni një „Catch hook“ (Zapier), një „Custom webhook“ (Make), një nyje Webhook (n8n) ose një aktivizues HTTP (Pipedream), ngjitni adresën e tij dhe shtypni Dërgo test, që mjeti të mësojë fushat.

E humba sekretin e nënshkrimit.

Pronari mund ta shfaqë përsëri nga endpoint-i ose ta ndryshojë. Ndryshimi lëshon menjëherë një të ri, dhe i vjetri pushon së punuari.

A ishte i dobishëm ky artikull?

Kjo nuk iu përgjigj pyetjes suaj?

Na shkruani dhe përmendni faqen ku ishit. Çdo mesazh e lexon një person dhe përgjigjja vjen në gjuhën në të cilën shkruat.

Na shkruani