POST/api/public/widget/message

Bir ziyaretçi sohbet mesajını chatbot'a gönderir ve yanıtını döndürür — sohbet widget'ının merkezi uç noktası.

Kimlik Doğrulama ve Güvenlik

Widget gömme jetonu (X-Widget-Token başlığı) + kaynak onay listesi

İdempotent: Hayır

Parametreler

widget_code(body, string, zorunlu)
message(body, string, zorunlu)
visitor_id(body, string, zorunlu)İstemci tarafında oluşturulan, kalıcı ziyaretçi kimliği
session_id(body, string)yeni bir görüşmenin ilk çağrısında null

Örnek İstek

{"widget_code":"...","message":"Merhaba, Zentor App neler yapabilir?","visitor_id":"<UUID veya istemci tarafında oluşturulan kimlik>"}

Örnek Yanıt

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

Hata Kodları

401 WIDGET_TOKEN_MISSINGX-Widget-Token başlığı eksik.
401 WIDGET_TOKEN_INVALIDToken geçersiz veya kaynak (origin), widget'ın izin listesinde değil.
400 VISITOR_ID_REQUIREDvisitor_id eksik.

Canlı Test Kanıtı

Başarı (200, gerçek üretilen chatbot yanıtı) ve birden çok olumsuz durum (eksik/geçersiz token, eksik visitor_id) canlı olarak doğrulandı.

Sohbet Widget'ı