Skip to main content
POST
Bu endpoint, bir yapay zeka asistanıyla yeni bir konuşma oturumu oluşturur. Bunu web widget’ınız veya uygulamanız aracılığıyla metin tabanlı bir sohbet oturumu başlatmak için kullanın.

İstek Gövdesi

string
gerekli
Konuşmayı başlatacağınız asistanın UUID’si. Sistemde mevcut ve geçerli bir asistan UUID’si olmalıdır.
string
varsayılan:"widget"
Konuşma türü. Olası değerler:
  • widget - Web widget konuşması (varsayılan, ücretli)
  • test - Test konuşması (ücretsiz, geliştirme için)
object
Asistana aktarılacak özel değişkenler. Bu değişkenler, asistanın sistem istemi ve ilk mesajında {{variable_name}} sözdizimi kullanılarak kullanılabilir.Yaygın kullanım alanları:
  • Formlardan müşteri bilgilerini önceden doldurma
  • Uygulamanızdan bağlam aktarma
  • Oturum bazında asistan davranışını özelleştirme

Yanıt Alanları

boolean
İsteğin başarılı olup olmadığını belirtir
string
Oluşturulan konuşmanın benzersiz UUID tanımlayıcısı. Bu kimliği sonraki mesaj istekleri için kullanın.
array
İlk konuşma geçmişi. Asistanın yapılandırılmış bir ilk mesajı varsa, burada yer alır.

Hata Yanıtları

boolean
Bir hata oluştuğunda false olur
string
Neyin yanlış gittiğini açıklayan hata mesajı. Olası değerler:
  • Assistant not found - Sağlanan assistant_id mevcut değil
  • Insufficient balance. Please top up your account. - Asistan sahibinin hesap bakiyesi çok düşük

Fiyatlandırma

  • Widget konuşmaları: Kullanıcı mesajı başına 0,01 $
  • Test konuşmaları: Ücretsiz (geliştirme ve test için)

Sonraki Adımlar

Bir konuşma oluşturduktan sonra, asistanla mesaj alışverişi yapmak için Mesaj Gönder endpoint’ini kullanın.