TapTime-ის სხვა სისტემებთან დაკავშირების სამი გზა, ყველა ერთ განყოფილებაში. მათი მართვა მხოლოდ კომპანიის მფლობელს შეუძლია. ჩატის შეტყობინებებისა და Zapier-ის, Make-ის, n8n-ის ან Pipedream-ისთვის იხილეთ ცალკე სახელმძღვანელოები — ისინი იმავე მოვლენებს იყენებენ.
პანელი ინტეგრაციები ვებჰუკები და API
| რა გამოიყენოთ | როდის |
|---|---|
| ვებჰუკი | თქვენმა სისტემამ ან CRM-მა ყოველი ჯავშნის, შეკვეთისა თუ ლოიალობის ცვლილების შესახებ უნდა გაიგოს, ყველა დეტალით. |
| პოსტბექი | სარეკლამო ქსელმა, აფილიატმა ან ტრეკერმა მოგცათ პოსტბექის URL, რომელიც ყოველ კონვერსიაზე უნდა გამოიძახოთ. |
| REST API | თქვენს სისტემას სურს ჯავშნები მაშინ წამოიღოს, როცა მოესურვება, ან დაადასტუროს და გააუქმოს ისინი. |
მოვლენები, რომელთა გაგზავნაც შეგიძლიათ
| მოვლენა | როდის |
|---|---|
| booking.requested | სტუმარმა მოითხოვა ჯავშანი, რომელიც თქვენს დადასტურებას ელოდება |
| booking.confirmed | ჯავშანი დადასტურდა |
| booking.cancelled | გააუქმა სტუმარმა ან დაწესებულებამ |
| booking.no_show | სტუმარი არ მოვიდა |
| booking.completed | ვიზიტი დასრულდა |
| order.placed | სტუმრის შეკვეთა თქვენამდე მოვიდა (თქვენი გვერდიდან ან მაგიდის QR კოდით) |
| order.paid | ნებისმიერი შეკვეთა გადაიხადეს, სალაროს ჩათვლით |
| loyalty.member_joined | კლიენტმა პროგრამაში პირველი შტამპი მიიღო |
| loyalty.stamp_added | შტამპი დაემატა |
| loyalty.reward_issued | ბარათი შეივსო და ჯილდო გაიცა |
| loyalty.reward_redeemed | ჯილდო გადაეცა |
ვებჰუკები
-
1
ვებჰუკის დამატება
ჩასვით თქვენი ენდპოინტის https მისამართი და აირჩიეთ მოვლენები — ჯავშნები, შეკვეთები, ლოიალობა ან ყველა ერთად.
-
2
ტესტის გაგზავნა
სანიმუშო მოვლენა მაშინვე იგზავნება და ჩანს, რა უპასუხა თქვენმა ენდპოინტმა.
-
3
შეამოწმეთ ხელმოწერა
ყოველ მოთხოვნას აქვს TapTime-Signature ჰედერი: t=<time>,v1=<„t.body“-ის HMAC-SHA256 თქვენი ხელმოწერის გასაღებით>. შეადარეთ, სანამ მოთხოვნას ენდობით.
მოთხოვნის სხეული JSON-ია: მოვლენის id, ტიპი და დრო, და სრული ჯავშანი, შეკვეთა ან ლოიალობის ბარათი — data.booking-ში, data.order-ში ან data.loyalty-ში — სტუმრით, დროით, მაგიდით, სერვისით ან პოზიციებით, სტატუსით და იმით, საიდან მოვიდა (UTM ტეგები და click ID-ები).
- უპასუხეთ ნებისმიერი 2xx სტატუსით. ნებისმიერ სხვა პასუხზე გაგზავნა 8-ჯერ მეორდება დაახლოებით ერთი დღის განმავლობაში.
- ყოველ მოვლენას აქვს id: თუ ის ორჯერ მიიღეთ, მეორე უგულებელყავით.
- უპასუხეთ 410 Gone და TapTime ამ მოვლენის ხელახლა გაგზავნას შეწყვეტს.
- გადამისამართებებს სისტემა არ მიჰყვება, კერძო ქსელების მისამართები კი უარყოფილია.
სერვერიდან სერვერზე პოსტბექები
ჩასვით პოსტბექის URL, რომელიც ტრეკერმა მოგცათ, და დააწკაპუნეთ ცვლადებზე ჯავშნის მონაცემების ჩასასმელად, მაგალითად https://tracker.example/postback?cid={click_id}&payout={value}&status={status}. ხელმისაწვდომ ცვლადებს შორისაა {click_id}, {event}, {booking_id}, {value}, {currency}, {party_size}, {utm_source}, {utm_campaign}, {gclid} და {fbclid}. ტრეკერის click ID ჯავშანს მაშინ აღწევს, როცა თქვენი დაჯავშნის ბმული შეიცავს click_id, clickid ან subid პარამეტრს.
REST API
-
1
API გასაღების შექმნა
დაარქვით სახელი და აირჩიეთ „მხოლოდ წაკითხვა“ ან „წაკითხვა და ჩაწერა“, რათა დაუშვათ დადასტურება, გაუქმება და „არ მოვიდა“-ს მონიშვნა.
-
2
დააკოპირეთ ახლავე
გასაღები მხოლოდ ერთხელ ჩანს. შეინახეთ სერვერზე — არასოდეს ვებგვერდზე ან აპლიკაციაში.
-
3
გამოიძახეთ API
გაგზავნეთ ის როგორც Authorization: Bearer <key> მისამართზე https://api.tapti.me/v1/company.
| მოთხოვნა | აბრუნებს |
|---|---|
| GET /v1/company | კომპანიას, რომელსაც გასაღები ეკუთვნის |
| GET /v1/company/reservations, /appointments | ჯავშნებს, გაფილტრულს status, branchId, from, to ან updatedSince პარამეტრით, 100 თითო გვერდზე |
| GET /v1/company/reservations/{id} | ერთ ჯავშანს |
| POST /v1/company/reservations/{id}/status | ცვლის სტატუსს (ჩაწერის გასაღებები) |
| GET /v1/company/orders, /orders/{id} | შეკვეთებს პოზიციებითა და ჯამებით, გაფილტრულს status, source, fulfilment, from, to ან paidSince პარამეტრით |
| GET /v1/company/loyalty/programs, /cards, /rewards | ლოიალობის პროგრამებს, წევრების ბარათებსა და მათ მიერ მოპოვებულ ჯილდოებს |
| GET /v1/company/events?after={cursor} | ყოველ ჯავშნის, შეკვეთისა და ლოიალობის მოვლენას თანმიმდევრობით — პერიოდულად მიმართეთ, რომ სინქრონში დარჩეთ; მხოლოდ ზოგიერთისთვის დაამატეთ type=order,loyalty |
| POST /v1/company/webhooks, DELETE /v1/company/webhooks/{id} | URL-ის მოვლენებზე გამოწერასა და გამოწერის გაუქმებას — ამას იყენებენ Zapier-ის, Make-ის, n8n-ისა და Pipedream-ის აპები |
როცა რამე ჩავარდება
თითოეული ენდპოინტის „გაგზავნების ჟურნალი“ ბოლო 25 გაგზავნას აჩვენებს სტატუსის კოდითა და თქვენი სისტემის პასუხით. ჩავარდნილი გაგზავნები თავისით მეორდება; „ხელახლა გაგზავნა“ ერთ-ერთს ახლავე გაიმეორებს.
ხშირად დასმული კითხვები
შეიძლება ვებჰუკი Zapier-ში ან Make-ში გაიგზავნოს?
დიახ — გამოიყენეთ ინტეგრაციები → ავტომატიზაცია: ის ამოწმებს, რომ მისამართი პლატფორმას ეკუთვნის, და მის საკუთარ ნაბიჯებს გაჩვენებთ. შექმენით „Catch hook“ (Zapier), „Custom webhook“ (Make), Webhook კვანძი (n8n) ან HTTP ტრიგერი (Pipedream), ჩასვით მისი მისამართი და დააჭირეთ „ტესტის გაგზავნა“, რომ ხელსაწყომ ველები გაიგოს.
ხელმოწერის გასაღები დავკარგე.
მფლობელს შეუძლია ის ენდპოინტიდან ხელახლა ნახოს ან განაახლოს. განახლება მაშინვე ახალ გასაღებს გასცემს, ძველი კი მუშაობას წყვეტს.
გმადლობთ — ასე ვაუმჯობესებთ ამ სახელმძღვანელოებს.
მოგვწერეთ და მიუთითეთ, რომელ გვერდზე იყავით. ყველა შეტყობინებას ადამიანი კითხულობს და პასუხი იმ ენაზე მოდის, რომელზეც დაწერეთ.
მოგვწერეთ