Ana içeriğe atla
POST
/
user
/
ai
/
generate-reply
curl -X POST "https://app.whattalk.ai/api/user/ai/generate-reply" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": 123,
    "customer_identifier": "+14155551234",
    "message": "Hi, I would like to schedule an appointment",
    "variables": {
      "customer_name": "John Smith",
      "source": "whatsapp"
    }
  }'

{
  "success": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_identifier": "+14155551234",
  "reply": "Hi John! I'd be happy to help you schedule an appointment. What day and time work best for you?",
  "function_calls": [],
  "ai_disabled": false
}
Bu uç nokta, yapılandırılmış asistanınızı kullanarak belirli bir mesaj için yapay zeka yanıtı oluşturur. Müşteri tanımlayıcısına göre otomatik olarak konuşma oluşturur veya mevcut konuşmayı yeniden kullanır, bu da onu harici platformlara, CRM’lere veya özel sohbet arayüzlerine yapay zeka yanıtları entegre etmek için ideal kılar.
Hız Sınırlı — Bu uç nokta, kötüye kullanımı önlemek için API belirteci başına dakikada 5 istek ile sınırlandırılmıştır.

​
İstek Gövdesi

​
assistant_id
integer
gerekli
Yanıt oluşturmak için kullanılacak asistanın kimliği. Hesabınıza ait olmalıdır.
​
customer_identifier
string
gerekli
Müşteri için benzersiz bir tanımlayıcı. Bu, birden fazla mesaj arasında konuşma bağlamını korumak için kullanılır.Örnekler: telefon numarası, e-posta adresi, CRM iletişim kimliği, Facebook kullanıcı kimliği.Maksimum uzunluk: 255 karakter.
​
message
string
gerekli
Yanıtlanacak müşteri mesajı.
​
variables
object
Asistana iletilecek isteğe bağlı bağlam değişkenleri. Bunlar mevcut konuşma değişkenleriyle birleştirilir.Müşteri verilerini, oturum bağlamını veya diğer meta verileri iletmek için kullanışlıdır.

​
Yanıt Alanları

​
success
boolean
İsteğin başarılı olup olmadığını gösterir
​
conversation_id
string
Konuşmanın UUID’si. Konuşmayı daha sonra takip etmek veya referans vermek için kullanın.
​
customer_identifier
string
İstekte sağlanan müşteri tanımlayıcısı
​
reply
string
Müşterinin mesajına yapay zeka tarafından oluşturulan yanıt
​
function_calls
array
Asistanın mesajı işlerken yaptığı fonksiyon çağrıları dizisi. Hiçbir fonksiyon çağrılmadıysa boş dizi.
​
ai_disabled
boolean
Bu konuşma için yapay zeka yanıtlarının devre dışı bırakılıp bırakılmadığını gösterir (ör. manuel devralma nedeniyle)

​
Hata Yanıtları

​
success
boolean
Bir hata oluştuğunda false olacaktır
​
error
string
Neyin yanlış gittiğini açıklayan hata mesajı
​
error_code
string
Makine tarafından okunabilir hata kodu. Olası değerler:
  • ASSISTANT_NOT_FOUND - Asistan kimliği geçersiz veya hesabınıza ait değil
  • INSUFFICIENT_BALANCE - Hesap bakiyeniz mesajı işlemek için çok düşük
curl -X POST "https://app.whattalk.ai/api/user/ai/generate-reply" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": 123,
    "customer_identifier": "+14155551234",
    "message": "Hi, I would like to schedule an appointment",
    "variables": {
      "customer_name": "John Smith",
      "source": "whatsapp"
    }
  }'

{
  "success": true,
  "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "customer_identifier": "+14155551234",
  "reply": "Hi John! I'd be happy to help you schedule an appointment. What day and time work best for you?",
  "function_calls": [],
  "ai_disabled": false
}

​
Kullanım Alanları

​
Çok Kanallı Yapay Zeka Yanıtları

Bu uç noktayı herhangi bir mesajlaşma platformuna yapay zeka yanıtları eklemek için kullanın:
  1. WhatsApp, Facebook, SMS veya başka bir kanaldan mesaj alın
  2. Mesaj ve müşteri tanımlayıcısı ile bu uç noktayı çağırın
  3. Yapay zeka yanıtını orijinal kanal üzerinden geri gönderin

​
CRM Entegrasyonu

Yapay zeka yanıtlarını CRM’inize veya yardım masanıza entegre edin:
  1. CRM iletişim kimliğini customer_identifier olarak kullanın
  2. Kişiselleştirilmiş yanıtlar için müşteri verilerini variables olarak iletin
  3. Konuşma, aynı tanımlayıcı kullanılarak oturumlar arasında devam eder

​
Özel Sohbet Arayüzleri

WhatTalk asistanınız tarafından desteklenen kendi sohbet arayüzünüzü oluşturun:
  1. Her kullanıcı oturumu için benzersiz bir tanımlayıcı oluşturun
  2. Mesajları bu uç nokta üzerinden gönderin
  3. Yapay zeka yanıtlarını arayüzünüzde görüntüleyin

​
Konuşma Kalıcılığı

Konuşmalar, assistant_id ve customer_identifier kombinasyonuna göre otomatik olarak kalıcı hale getirilir:
  • Aynı tanımlayıcı: Mesajlar mevcut konuşmaya eklenir ve tam bağlam korunur
  • Yeni tanımlayıcı: Müşteri için yeni bir konuşma oluşturulur
  • Değişken birleştirme: Değişkenler sağlandığında, mevcut konuşma değişkenleriyle birleştirilir

​
En İyi Uygulamalar

  1. Tutarlı tanımlayıcılar kullanın: Müşteri tanımlayıcıları için her zaman aynı formatı kullanın (ör. telefon numaraları için her zaman E.164)
  2. İlgili bağlamı iletin: Yapay zekanın yanıtları kişiselleştirmesine yardımcı olan müşteri verilerini sağlamak için variables alanını kullanın
  3. Hız sınırlarını yönetin: Hız sınırlı istekler için üstel geri çekilme ile yeniden deneme mantığı uygulayın
  4. Konuşma kimliklerini saklayın: Daha sonra referans veya hata ayıklama için döndürülen conversation_id değerini kaydedin
  5. Maliyetleri izleyin: Özellikle yüksek hacimli entegrasyonlar için maliyetleri yönetmek amacıyla kullanımı takip edin