Konuşmaları okuma ve atama

Bu rehber, bir kişinin konuşmalarını okur ve bir konuşmayı bir ekip arkadaşına atar. CRM’inizdeki müşteri sayfasında bir “Konuşmalar” paneli göstermek veya işi kendi kurallarınızla yönlendirmek için kullanın. Okuma conversations:read yetkisine ihtiyaç duyar. Atama conversations:write yetkisine ihtiyaç duyar.

Bir kişinin konuşmalarını okuyun

curl "https://kaisupport.com/api/v1/contacts/4f1d6f2a-.../conversations?status=open" \
  -H "Authorization: Bearer $KAI_API_KEY"

{
  "data": [
    {
      "id": "9d2b1c44-...",
      "channel_id": "7c1f4a80-...",
      "status": "human",
      "assigned_member_id": "2c9a0d51-...",
      "assigned_via": "member",
      "last_message_preview": "Yarın 14:00 uygun mu?",
      "last_message_at": "2026-08-11T10:44:12.000Z",
      "created_at": "2026-08-09T08:15:00.000Z"
    }
  ]
}

Liste en yeniden başlar. status=open canlı konuşmaları döndürür. closed ve archived o durumları döndürür. Hepsi için parametreyi atlayın. Bir konuşma beş durumdan birini taşır:

`status`	Anlamı
`open`	Konuşma canlı. Henüz ne Kai ne de bir insan yanıtladı.
`ai`	Konuşmayı Kai yanıtladı.
`human`	Konuşma bir insanda, veya bir insanı bekliyor.
`closed`	Konuşma dinleniyor. Müşteriden yeni bir mesaj onu yeniden açar.
`archived`	Konuşma tarih oldu. Müşteriden yeni bir mesaj yeni bir konuşma başlatır.

open, ai ve human canlı durumlardır. status=open filtresi üçünü de döndürür. assigned_via alanı, geçerli atamayı kimin yaptığını söyler. member Kai’deki bir insandır. api bu API’ye yapılan bir çağrıdır. null Kai’nin kendi yönlendirmesidir.

Gönder düğmeniz çalışmadan önce status=open sorgusunu yapın. Canlı bir konuşma varsa ve bir ekip arkadaşı onu yönetiyorsa, sisteminizden giden bir şablon onların konuşmasını kesebilir.

Bir konuşmayı atayın

curl -X PUT https://kaisupport.com/api/v1/conversations/9d2b1c44-.../assignee \
  -H "Authorization: Bearer $KAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "member": "baran@example.com" }'

Yanıt, assigned_via alanı api olan güncel konuşmadır. Kai atanmış bir konuşmada yanıt vermez. Konuşma, ekip arkadaşının gelen kutusunda görünür ve Kai onları konuşmanın Matrix odasına davet eder.

Bu çağrı, başka bir ekip arkadaşının yönettiği konuşmayı da taşır. Bu akışınız için önemliyse, önce assigned_member_id alanını okuyun.

Bir konuşmayı serbest bırakın

curl -X DELETE https://kaisupport.com/api/v1/conversations/9d2b1c44-.../assignee \
  -H "Authorization: Bearer $KAI_API_KEY"

Konuşma ortak kuyruğa döner. Kai’nin kendi yönlendirmesi onu yeniden almaz: serbest bırakılmış bir konuşma bir insanı bekler.

Atama ve hesap sorumluları

Bu uç nokta tek bir konuşmayı taşır. Kişinin hesap sorumlusunu değiştirmez. Bir müşterinin gelecekteki konuşmalarını tek bir ekip arkadaşına yönlendirmek için hesap sorumlusunu ayarlayın. Bkz. Hesap sorumlularını eşitleme.

Buradan başlayın

Kavramlar

Nasıl yapılır

Konuşmaları okuma ve atama

Bir kişinin konuşmalarını okuyun

Bir konuşmayı atayın

Bir konuşmayı serbest bırakın

Atama ve hesap sorumluları

​Bir kişinin konuşmalarını okuyun

​Bir konuşmayı atayın

​Bir konuşmayı serbest bırakın

​Atama ve hesap sorumluları

Bir kişinin konuşmalarını okuyun

Bir konuşmayı atayın

Bir konuşmayı serbest bırakın

Atama ve hesap sorumluları