POST/api/public/widget/message

Hutuma ujumbe wa chat wa mgeni kwa chatbot na kurudisha jibu lake — endpoint kuu ya Chat-Widget.

Uthibitishaji na ulinzi

Embed token ya widget (header X-Widget-Token) + orodha ya origins zilizoidhinishwa

Idempotent: Hapana

Vigezo

widget_code(body, string, inahitajika)
message(body, string, inahitajika)
visitor_id(body, string, inahitajika)— Kitambulisho cha mgeni kinachozalishwa upande wa mteja (client) na kudumu
session_id(body, string)— null katika ombi la kwanza la mazungumzo mapya

Mfano wa ombi (request)

{"widget_code":"...","message":"Habari, Zentor App inaweza kufanya nini?","visitor_id":"<UUID au ID iliyozalishwa upande wa mteja>"}

Mfano wa jibu (response)

{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}

Misimbo ya hitilafu

401 WIDGET_TOKEN_MISSING — Kichwa cha X-Widget-Token hakipo.
401 WIDGET_TOKEN_INVALID — Tokeni si halali au Origin haimo katika orodha ya kuruhusiwa ya Widget.
400 VISITOR_ID_REQUIRED — visitor_id haipo.

Uthibitisho wa jaribio la moja kwa moja

Mafanikio (200, jibu halisi lililozalishwa na Chatbot) na kesi kadhaa hasi (tokeni inayokosekana/si halali, visitor_id inayokosekana) zimethibitishwa moja kwa moja (live).

← Wijeti ya chat