> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaisupport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Konuşmaları okuma ve atama

> Bir kişinin konuşmalarını kendi sisteminizde gösterin ve bir konuşmayı bir ekip arkadaşına yönlendirin.

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

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

```json theme={null}
{
  "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.

<Note>
  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.
</Note>

## Bir konuşmayı atayın

```bash theme={null}
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.

<Warning>
  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.
</Warning>

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

```bash theme={null}
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](/tr/guides/assignments).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.