Skip to main content
POST
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

integer
gerekli
Yanıt oluşturmak için kullanılacak asistanın kimliği. Hesabınıza ait olmalıdır.
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.
string
gerekli
Yanıtlanacak müşteri mesajı.
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ı

boolean
İsteğin başarılı olup olmadığını gösterir
string
Konuşmanın UUID’si. Konuşmayı daha sonra takip etmek veya referans vermek için kullanın.
string
İstekte sağlanan müşteri tanımlayıcısı
string
Müşterinin mesajına yapay zeka tarafından oluşturulan yanıt
array
Asistanın mesajı işlerken yaptığı fonksiyon çağrıları dizisi. Hiçbir fonksiyon çağrılmadıysa boş dizi.
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ı

boolean
Bir hata oluştuğunda false olacaktır
string
Neyin yanlış gittiğini açıklayan hata mesajı
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

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