Ana içeriğe atla
POST
/
conversations
curl -X POST "https://app.whattalk.ai/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "widget",
    "variables": {
      "customer_name": "John Smith",
      "company": "Acme Corp",
      "source": "pricing_page"
    }
  }'

{
  "status": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "history": [
    {
      "role": "assistant",
      "content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
    }
  ]
}
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

​
assistant_id
string
gerekli
Konuşmayı başlatacağınız asistanın UUID’si. Sistemde mevcut ve geçerli bir asistan UUID’si olmalıdır.
​
type
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)
​
variables
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ı

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

​
Hata Yanıtları

​
status
boolean
Bir hata oluştuğunda false olur
​
error
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
curl -X POST "https://app.whattalk.ai/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "widget",
    "variables": {
      "customer_name": "John Smith",
      "company": "Acme Corp",
      "source": "pricing_page"
    }
  }'

{
  "status": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "history": [
    {
      "role": "assistant",
      "content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
    }
  ]
}

​
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.