GET/api/public/widget/history
Inorodha nhoroondo yemashoko ariko yehurukuro yewidget, semuenzaniso mushure mekureloadwa kwepeji.
Tumirai `widget_code`, `session_id` ne-`visitor_id` sema-parameter emubvunzo. Mhinduro ine mukati mechinyorwa `data` rondedzero `messages` ine `role` (`user` kana `assistant`), `text` ne`created_at` muurongwa wehurukuro. Chikumbiro chinoverenga chete uye chine idempotency. Heda `X-Widget-Token` ine tokheni yekuisa ne`widget_code` zvinodikanwa. Kana tokheni isipo, seva inopindura ne401 `WIDGET_TOKEN_MISSING`, kana isisiri yechokwadi ne401 `WIDGET_TOKEN_INVALID`; zvikumbiro zvinobva pamadomeni asina kuvhurwa zvinowana 403 `WIDGET_ORIGIN_DENIED`, widget yakavharwa 404 `WIDGET_DISABLED`. Kana `session_id` kana `visitor_id` isipo, seva inopindura ne400 `PARAMS_REQUIRED`. Kana sesheni isingazivikanwi, tangai hurukuro itsva.
Pfupiso
Kudana: GET /api/public/widget/history. Endpoint iyi ndeyeboka re“Chat widget” reAPI yeZentor App. Inoda widget embed token inoshanda. Kudana uku idempotent: kudana kakawanda neruzivo rumwe chete kunodzosa mhedzisiro imwe chete. Maparameter anodiwa: widget_code (query), session_id (query), visitor_id (query). Zviitiko zvezvikanganiso zvakanyorwa: 400 PARAMS_REQUIRED. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.
Kusimbiswa nekuchengetedza
Widget embed token (header X-Widget-Token) + rondedzero yeOrigin dzakabvumidzwa
Idempotent: Hongu
Maparameter
widget_code(query, string, zvinodiwa)— Kodhi yewidget inobva mukodhi yenyu yekuisasession_id(query, string, zvinodiwa)— ID yesesheni yehurukuro inobva pamhinduro ye-`message`visitor_id(query, string, zvinodiwa)— ID yemushanyi inogadzirwa newidget uye yakachengetwa mubhurauzaMuenzaniso wemhinduro
{"ok":true,"data":{"messages":[{"role":"user","text":"Mhoro...","created_at":"..."},{"role":"assistant","text":"...","created_at":"..."}]}}Makodhi ekukanganisa
400 PARAMS_REQUIRED — `session_id` kana `visitor_id` isipo.Mafambiro akaongororwa
Sesheni iripo inopa 200 nenhoroondo yemashoko; ma-parameter asipo anopa 400 `PARAMS_REQUIRED`.
Chat widget
GET /api/public/widget/healthKuongorora kuwanikwa kwakareruka kwesevhisi yewidget.GET /api/public/widget/config/:widget_codeInopa kugadzirwa kweveruzhinji kwewidget (zita rinoratidzwa, mashoko ekugamuchira, dhizaini, mutauro, basa revhoiza) rekutanga mubhurauza.POST /api/public/widget/messageInotumira meseji yemushanyi kuchatbot uye inopa mhinduro yayo – endpoint yepakati yewidget yehurukuro.POST /api/public/widget/pollInotora mameseji akagamuchirwa mushure menguva yakati – semuenzaniso mhinduro yemushandi akatora hurukuro.POST /api/public/widget/ratingInochengetedza kuongorora kwemushanyi pamusoro pehurukuro (kunobatsira kana hakubatsiri).POST /api/public/widget/trackInonyora chiitiko chekushandiswa chisingazivikanwi chewidget (semuenzaniso „widget yavhurwa“) kuongororo yedashboard.POST /api/public/widget/voice-transcribeInoshandura rekodhi yezwi remushanyi kuita zvinyorwa (kuisa nezwi), kana basa rezwi rewidget rakavhurwa.POST /api/public/widget/voice-speakInoshandura zvinyorwa kuita mutauro unotaurwa (kubuda kwezwi muwidget), kana basa rezwi rakavhurwa.