Sohbet Widget'ı

Web sitenizdeki yerleştirilmiş sohbet widget'ının kullandığı tüm uç noktalar.

Sohbet widget'ı, sohbet botunuzu web sitenize entegre eder. Bu grup, widget'ın kullandığı tüm uç noktaları açıklar: erişilebilirlik kontrolü, genel widget yapılandırması, mesaj gönderme, konuşma geçmişi, yeni mesajların alınması (örneğin bir çalışan tarafından devralındıktan sonra), değerlendirme, kullanım olayları ve sesli giriş ve çıkış.

`health` ve `config`, widget'ın tarayıcıda başlatılabilmesi için kimlik doğrulama gerektirmeden erişilebilir. Diğer tüm uç noktalar, `widget_code` ve widget'ın `X-Widget-Token` başlığındaki yerleştirme belirtecini (embed token) bekler. Zentor, kurulum sırasında widget'ı oluşturur, onaylanan alan adlarını kaydeder ve size widget kodu ve yerleştirme belirteci içeren yerleştirme kodunu sağlar. Sunucu, onaylanmamış alan adlarından gelen çağrıları 403 `WIDGET_ORIGIN_DENIED` ile reddeder, devre dışı bırakılmış bir widget'ı 404 `WIDGET_DISABLED` ile yanıtlar.

Ayrıca hesabınızın erişim kuralları (IP, ülke ve alan adı kuralları) geçerlidir. `message` idempotent değildir: Her tekrar gönderme, yeni bir mesaj ve yeni bir yanıt oluşturur.

GET/api/public/widget/healthGET/api/public/widget/config/:widget_codePOST/api/public/widget/messageGET/api/public/widget/historyPOST/api/public/widget/pollPOST/api/public/widget/ratingPOST/api/public/widget/trackPOST/api/public/widget/voice-transcribePOST/api/public/widget/voice-speak
← API Referansı