Կենդանի տվյալներ՝ պատվեր, առաքում, ամրագրում

Բոտը գտնում է հաճախորդի պատվերը, առաքման վիճակը կամ ամրագրումը՝ հղման համարով կամ կոնտակտով։

Կենդանի տվյալներ բաժինը (Ամրագրումներ էջում) թույլ է տալիս բոտին պատասխանել «որտե՞ղ է իմ պատվերը», «ե՞րբ կհասնի առաքումը», «իմ ամրագրումը հաստատվա՞ծ է» հարցերին՝ ձեր իրական տվյալների հիման վրա։

Ի՞նչ կարող է փնտրել բոտը

Միացրեք միայն ձեզ պետք եղածը՝

Պատվերներ — պատվերի կարգավիճակ, պարունակություն, գումար։
Առաքում — առաքման կարգավիճակ և սպասվող ժամ։
Ամրագրումներ — հյուրանոցի կամ ռեստորանի ամրագրման տվյալներ։

Որտեղի՞ց են գալիս տվյալները

Ընտրեք ձեզ հարմար եղանակը (կարող եք համատեղել)՝

Համաժամեցում ձեր համակարգից (API) — ձեր համակարգը (POS, խանութ, առաքման ծրագիր, հյուրանոցի PMS) տվյալներն ուղարկում է HighChat։ Սեղմեք «Ստեղծել API բանալի», պատճենեք բանալին (ցուցադրվում է միայն մեկ անգամ) և օգտագործեք ստորև բերված հասցեն։
Կենդանի կապ ձեր սերվերին (webhook) — փոխարենը HighChat-ը հարցումն ուղարկում է ձեր սերվերին և պատասխանն ստանում իրական ժամանակում՝ առանց տվյալները պահելու։ Մուտքագրեք https:// հասցեն և, ըստ ցանկության, գաղտնի բանալի ստորագրման համար։
Ձեռքով — եթե համակարգ չունեք, ավելացրեք գրառումները ձեռքով՝ տեսակ, հղման համար, կարգավիճակ, կոնտակտ։

Գաղտնիություն

Զրույցը բաց է բոլորի համար, ուստի բոտը տվյալները հայտնում է զգուշությամբ՝

միայն ճշգրիտ հղման համարով կամ հաճախորդի սեփական կոնտակտով, ոչ երբեք միայն անունով.
եթե գրառման մեջ կոնտակտ կա պահված, և հաճախորդը տվել է միայն համարը, բոտը նախ խնդրում է հաստատել այն հեռախոսահամարը կամ էլ․ փոստը, որի տակ գրանցված է գրառումը — և միայն դրանից հետո ցույց է տալիս մանրամասները.
բոտը երբեք չի կարդում հետ պահված հեռախոսահամարը։

Այսպես՝ եթե ուզում եք, որ պարզ համարով էլ կարելի լինի ստուգել կարգավիճակը (օրինակ՝ առաքման հետևում), համաժամեցրեք գրառումը առանց կոնտակտի։ Եթե կոնտակտ եք ավելացնում, բոտը կպահանջի ինքնության հաստատում։

Համաժամեցման API

Ուղարկեք գրառումները՝

curl https://app.highchat.am/v1/records/sync \
  -H "Authorization: Bearer hc_xxx" \
  -H "Content-Type: application/json" \
  -d '{"records":[
    {"kind":"order","code":"A100","status":"Պատրաստ է","customer_contact":"+37491234567","summary":"2 պիցցա","details":{"total":"5400 դր"}},
    {"kind":"delivery","code":"D7","status":"Ճանապարհին է","eta":"մոտ 25 րոպե","external_url":"https://..."}
  ]}'

kind — order, delivery կամ reservation (պարտադիր)։
code — ձեր կողմից տրված հղման համարը (պարտադիր, համաժամեցման բանալին)։
status, customer_name, customer_contact, summary, eta, external_url — ըստ ցանկության։
details — ցանկացած լրացուցիչ դաշտ (օր.՝ {"room":"Լյուքս 204","total":"5400 դր"})։
Կրկնակի ուղարկելը նույն code-ով թարմացնում է գրառումը։ Ջնջելու համար ավելացրեք "delete": true։

Պատասխանը՝ {"ok":true,"upserted":N,"deleted":N,"skipped":N}։ Բանալին ստուգելու համար՝ GET /v1/records/ping։

Կարևոր. Համաժամեցումն օգտագործում է REST API բանալին (hc_…), ոչ թե վիջեթի բանալին — վիջեթի բանալին երևում է կայքի կոդում և անվտանգ չէ գրառումների համար։

Webhook-ի ձևաչափ

Եթե ընտրում եք կենդանի կապը, HighChat-ը ձեր հասցեին ուղարկում է POST՝

{ "kind": "order", "code": "A100", "contact": "+37491234567", "name": null }

Եթե սահմանել եք գաղտնի բանալի, հարցումը պարունակում է X-HighChat-Signature: sha256=<HMAC> վերնագիր (մարմնի HMAC-SHA256)։ Վերադարձրեք գրառումը (կամ {"records":[…]})՝ նույն դաշտերով, ինչ վերևում։