Sohbet

Kendi uygulamanızda veya müşteri hizmetleri sisteminizde AI ile sohbet edin; akış yanıtları ile görüşmeyi temsilciye aktarma, sonlandırma ve değerlendirme desteklenir.

POST /v1/chat

{
  "message": "有没有 400 美元以内的潜水表？",
  "conversation_id": null,
  "user": {"id": "u_123", "name": "李四", "email": "li@example.com", "ip": "85.214.132.117", "language": null},
  "stream": false
}

conversation_id gönderilmezse yeni bir görüşme oluşturulur; yanıtta bu kimlik döner ve sonraki mesajlarda iletilir.
user bilgisini doğrudan sunucunuz bize iletir (API Key ile çağrı yapan taraf güvenilirdir); bu bilgi yalnızca iletildiğinde siparişler sorgulanabilir.
Varsayılan yanıt dili: user.language (ör. de, zh-CN, pt-BR) gönderilirse o kullanılır; aksi halde user.ip gönderin, konuma göre biz belirleriz; ikisi de gönderilmezse arka uçtaki varsayılan dil kullanılır. Müşteri görüşme sırasında dil değiştirmek isterse müşterinin talebi esas alınır.
stream: false olduğunda {"conversation_id", "message", "status", "products"} döner; message değerinin null olması görüşmenin insan temsilci tarafından yürütüldüğünü ve mesajın temsilciye aktarıldığını gösterir.
stream: true olduğunda SSE döner; olaylar aşağıdaki tabloda listelenmiştir.

Olay `type`	İçerik
`user_message`	Kaydedilen kullanıcı mesajı
`delta`	Yanıtın bir parçası olan `text`, sırayla birleştirilir
`products`	AI'ın bulduğu ürün kartları
`language`	Müşteri yanıt dilini değiştirmek istedi; `language` yeni dil kodudur
`status`	Görüşme durumu değişikliği (ör. insan temsilciye aktarma)
`replace`	Alınan yanıtı tamamen `text` ile değiştirir (hata durumunda yedek metinle değiştirilir)
`queued_for_human`	Görüşme insan temsilci tarafından yürütülüyor, AI yanıtı yok
`done`	Son olarak kaydedilen mesaj ve görüşme durumu
`error`	Hata

Diğer uç noktalar

Yöntem	Yol	Açıklama
GET	`/v1/conversations`	Görüşme listesi, `?status=&end_user_id=`
GET	`/v1/conversations/{id}/messages`	Görüşme ve tüm mesajları
POST	`/v1/conversations/{id}/messages`	Müşteri hizmetleri sisteminiz insan temsilci olarak yanıt verir: `{"content", "agent_name"}`; görüşme hemen insan temsilci durumuna geçer
POST	`/v1/conversations/{id}/status`	Temsilci tarafı işlemi: `{"status": "ai"}` AI'a geri devreder, `{"status": "closed"}` görüşmeyi sonlandırır
POST	`/v1/conversations/{id}/close`	Müşteri görüşmeyi uygulamanızda sonlandırır; zaten sonlandırılmış görüşmeler için de başarı döner
POST	`/v1/conversations/{id}/rating`	Görüşme sonlandıktan sonra müşteri değerlendirmesi: `{"rating": "good" \| "bad", "comment": "可选，最多 500 字"}`; değiştirilebilir

Görüşme durumları: ai (AI yanıtlıyor), pending_human (insan temsilci bekleniyor), human (insan temsilci yürütüyor), closed (sonlandırıldı).

Görüşmede ayrıca şunlar bulunur: closed_by görüşmeyi kimin sonlandırdığı (customer müşteri, agent temsilci, ai müşteri başka sorunu olmadığını belirttikten sonra AI sonlandırdı), rating / rating_comment / rated_at müşteri değerlendirmesi.

Görüşmeyi sonlandırma: Web penceresinin üst kısmında "Görüşmeyi sonlandır" düğmesi vardır (onay istenir); WeChat mini programında müşteri "结束" yazdığında da görüşme sonlanır; "Bot ayarları"nda "AI görüşmeyi otomatik sonlandırsın" açıksa, müşteri başka sorunu olmadığını açıkça belirttiğinde AI vedalaştıktan sonra görüşmeyi sonlandırır. Sonlandırmanın ardından web penceresinde müşteriden memnun / memnun değil şeklinde değerlendirme yapması ve yorum bırakması istenir; WeChat'te müşteriden 1 veya 2 yanıtı vermesi istenir; müşteri bundan sonra mesaj gönderirse bu yeni bir görüşme olur.

İnsan temsilciye aktarma sonrası atama: "Bot ayarları"nda atama yöntemini seçin: en az görüşmesi olan temsilciye atama (varsayılan), sırayla atama veya temsilcinin kendisinin alması. Otomatik atama yalnızca "Çevrimiçi" seçili olan ve arka uç sayfası açık olan temsilcilere yapılır; her temsilcinin eşzamanlı görüşme üst sınırı vardır ("Ekip" sayfasında ayarlanır); atanan temsilci belirlenen süre içinde (varsayılan 2 dakika) yanıt vermezse görüşme başka birine atanır. Görüşmedeki assigned_member_id atanan temsilciyi, assigned_at atama zamanını, handoff_at insan temsilciye aktarma zamanını gösterir. Tüm temsilciler doluysa müşteriler sıraya girer ve web penceresinde önlerinde kaç kişi olduğu gösterilir.

Çalışma saatleri ve mesaj bırakma: "Bot ayarları"nda çalışma saatleri açıldığında, çalışma saatleri dışında müşteri insan temsilciye aktarılmak isterse sıraya alınmaz; web penceresinde mesaj bırakma formu açılır (ad, e-posta veya telefon, soru). WeChat ve açık API görüşmelerinde AI müşteriden mesaj bırakmasını ister; çalışma saatleri içinde çevrimiçi temsilci olmadığında da aynı şekilde davranılır. Mesajlar bir destek kaydı oluşturur; temsilci yanıtladığında, özgün görüşme henüz sonlanmadıysa yanıt görüşmeye gönderilir; müşteri e-posta bıraktıysa mağaza adına e-posta da gönderilir. Yalnızca sisteminize gönderim (aktarma yöntemi olarak "Sistemime gönder") seçiliyse çalışma saatleri dikkate alınmaz.

Bu sayfa yardımcı oldu mu?

Son güncelleme: 31 Ekim 2026