> ## 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.

# Hızlı başlangıç

> Bir API anahtarı oluşturun, bir özellik tanımlayın ve ilk kişinizi gönderin.

Bu işlem yaklaşık beş dakika sürer. Sonunda çalışma alanınızda bir kişi bulunur,
bu kişi bir çalışma alanı özelliği taşır ve hesabın bir ekip arkadaşınıza ait
olur.

## 1. Bir API anahtarı oluşturun

<Steps>
  <Step title="API ayarlarını açın">
    Kai'de **Ayarlar (Settings) → API** bölümüne gidin.
  </Step>

  <Step title="Anahtarı oluşturun">
    **API anahtarı oluştur (Create API key)** seçeneğini seçin. Anahtara, onu
    hangi sistemin kullandığını belirten bir isim verin, örneğin
    `Nightly CRM sync`. `contacts:read`, `contacts:write` ve
    `attributes:write` izinlerini seçin.
  </Step>

  <Step title="Anahtarı kopyalayın">
    Kai anahtarı yalnızca bir kez gösterir. Kai anahtarın sadece bir özetini
    saklar, bu yüzden onu tekrar gösteremez. Anahtarı şimdi gizli bilgi
    deponuza koyun.
  </Step>
</Steps>

<Warning>
  Bir anahtar, çalışma alanındaki her kişiyi okur ve yazar. Bir anahtar sızarsa
  **Ayarlar (Settings) → API** bölümünden onu iptal edin ve yenisini oluşturun.
</Warning>

Aşağıdaki komutlar için anahtarı kabuğunuza tanımlayın:

```bash theme={null}
export KAI_API_KEY="kai_live_..."
```

## 2. Bir çalışma alanı özelliği oluşturun

Kai, çalışma alanının tanımlamadığı bir özellik anahtarını reddeder. Önce
özelliği oluşturun:

```bash theme={null}
curl -X POST https://kaisupport.com/api/v1/attributes \
  -H "Authorization: Bearer $KAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "package",
    "label": "Package",
    "type": "select",
    "options": ["Tam Destek", "Tam Paket"]
  }'
```

## 3. Bir kişi gönderin

```bash theme={null}
curl -X POST https://kaisupport.com/api/v1/contacts \
  -H "Authorization: Bearer $KAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "DK-1042",
    "name": "Ayşe Yılmaz",
    "email": "ayse@example.com",
    "phone": "+90 532 111 22 33",
    "attributes": { "package": "Tam Destek" }
  }'
```

Yanıt, kişiyi ve onun Kai kimliğini içerir:

```json theme={null}
{
  "data": {
    "id": "4f1d6f2a-6a1e-4a0b-9c53-2a9a1f0c77d1",
    "external_id": "DK-1042",
    "name": "Ayşe Yılmaz",
    "email": "ayse@example.com",
    "phone": "+90 532 111 22 33",
    "note": null,
    "attributes": { "package": "Tam Destek" },
    "owner": null,
    "created_at": "2026-08-06T09:14:00.000Z",
    "updated_at": "2026-08-06T09:14:00.000Z"
  }
}
```

Aynı isteği bir kez daha gönderin. Kai kişiyi `external_id` üzerinden eşleştirir
ve günceller, bu yüzden isteği tekrarlamak güvenlidir.

## 4. Hesabı bir ekip arkadaşınıza verin

Sorumluyu üye kimliğiyle veya e-posta adresiyle belirtebilirsiniz:

```bash theme={null}
curl -X PUT https://kaisupport.com/api/v1/contacts/4f1d6f2a-6a1e-4a0b-9c53-2a9a1f0c77d1/owner \
  -H "Authorization: Bearer $KAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "owner": "baran@example.com" }'
```

Bundan sonra bu müşteriden gelen yeni bir görüşme Baran'a gider.

## 5. Sonucu Kai'de görün

Kai'de **Kişiler** ekranını açın ve kişiyi seçin. Profilde temel bilgiler,
`Package` özelliği ve hesap sorumlusu görünür. Bir ekip arkadaşınız aynı
profili Gelen Kutusu'nda görüşmenin yanında görür.

## Sonraki adım

<CardGroup cols={2}>
  <Card title="Çok sayıda kişi aktarın" icon="layer-group" href="/tr/guides/bulk-import">
    Her istekte 1000 kişiye kadar gönderin.
  </Card>

  <Card title="Kişileri dışa aktarın" icon="download" href="/tr/guides/export">
    Her kişiyi veya yalnızca değişenleri okuyun.
  </Card>
</CardGroup>