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ğisession_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_MISSING — X-Widget-Token başlığı eksik.401 WIDGET_TOKEN_INVALID — Token geçersiz veya kaynak (origin), widget'ın izin listesinde değil.400 VISITOR_ID_REQUIRED — visitor_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ı.