Skip to main content
POST
Bu endpoint, mevcut bir konuşmaya kullanıcı mesajı gönderir ve asistanın yanıtını döndürür. Asistan, yapılandırılmış yapay zeka modelini ve mevcut araçları kullanarak mesajı işler.

Yol Parametreleri

string
gerekli
Konuşmanın benzersiz UUID tanımlayıcısı

İstek Gövdesi

string
gerekli
Asistana gönderilecek kullanıcı mesajı. Maksimum uzunluk: 2000 karakter.

Yanıt Alanları

boolean
İsteğin başarılı olup olmadığını belirtir
string
Asistanın kullanıcı mesajına verdiği yanıt
array
Mesajı işlerken asistan tarafından yapılan fonksiyon çağrılarının dizisi. Fonksiyon çağrılmadıysa boş dizi döner.

Hata Yanıtları

boolean
Bir hata oluştuğunda false olur
string
Hata mesajı. Olası değerler:
  • Conversation not found - Sağlanan UUID herhangi bir konuşmayla eşleşmiyor
  • Insufficient balance. Please top up your account. - Asistan sahibinin hesap bakiyesi çok düşük
  • Failed to process message: [details] - Mesaj işlenirken bir hata oluştu

Fiyatlandırma

Bir widget konuşmasındaki her kullanıcı mesajı 0,01 $ maliyetindedir. Test konuşmaları ücretsizdir.

Fonksiyon Çağrıları

Asistan, mesaj işleme sırasında aşağıdaki gibi fonksiyonlar çalıştırabilir:
  • Takvim işlemleri: Uygunluk kontrolü, randevu oluşturma
  • Bilgi bankası sorguları: Dokümantasyon veya SSS araması
  • Özel entegrasyonlar: Yapılandırılmış webhook endpoint’lerinizi çağırma
Fonksiyon çağrı sonuçları, kullanıcıya ilgili bilgileri gösterebilmeniz veya gerçekleştirilen eylemleri takip edebilmeniz için yanıta dahil edilir.

En İyi Uygulamalar

  1. Hataları zarif bir şekilde yönetin: Hatalar oluştuğunda kullanıcı dostu mesajlar gösterin
  2. Yükleme durumlarını gösterin: Asistan, özellikle fonksiyon çalıştırırken yanıt vermesi birkaç saniye sürebilir
  3. Konuşma kimliğini saklayın: Kullanıcıların konuşmaları devam ettirmesine izin vermek için konuşma UUID’sini saklayın
  4. Hız sınırlarına uyun: Gerekirse mesajlar arasında uygun gecikmeleri uygulayın