Вебхуктар, серверден серверге постбэктер және REST API

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 тегтері мен клик 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}. Трекердің клик 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 node (n8n) немесе HTTP trigger (Pipedream) жасап, оның мекенжайын қойыңыз да, құрал өрістерді танып алуы үшін «Сынақ жіберу» түймесін басыңыз.

Қолтаңба кілтін жоғалтып алдым.

Иесі оны эндпоинттен қайта көре алады немесе жаңарта алады. Жаңарту бірден жаңа кілт береді, ал ескісі жұмысын тоқтатады.

Бұл мақала пайдалы болды ма?

Сұрағыңызға жауап бермеді ме?

Бізге жазыңыз да, қай бетте болғаныңызды көрсетіңіз. Әр хатты адам оқиды, жауап сіз жазған тілде келеді.

Бізге жазыңыз