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 yekuisa
session_id(query, string, zvinodiwa)— ID yesesheni yehurukuro inobva pamhinduro ye-`message`
visitor_id(query, string, zvinodiwa)— ID yemushanyi inogadzirwa newidget uye yakachengetwa mubhurauza

Muenzaniso 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.

Zvinyorwa zvine hukama

← Chat widget