Ana içeriğe atla
POST
/
conversations
/
{uuid}
/
messages
curl -X POST "https://app.whattalk.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}
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

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

​
İstek Gövdesi

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

​
Yanıt Alanları

​
status
boolean
İsteğin başarılı olup olmadığını belirtir
​
message
string
Asistanın kullanıcı mesajına verdiği yanıt
​
function_calls
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ı

​
status
boolean
Bir hata oluştuğunda false olur
​
error
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
curl -X POST "https://app.whattalk.ai/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'

{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}

​
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