Hızlı başlangıç

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

API ayarlarını açın

Kai’de Ayarlar (Settings) → API bölümüne gidin.

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.

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.

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.

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

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:

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

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:

{
  "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:

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.

Buradan başlayın

Kavramlar

Nasıl yapılır

Hızlı başlangıç

1. Bir API anahtarı oluşturun

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

3. Bir kişi gönderin

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

5. Sonucu Kai’de görün

Sonraki adım

Çok sayıda kişi aktarın

Kişileri dışa aktarın

​1. Bir API anahtarı oluşturun

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

​3. Bir kişi gönderin

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

​5. Sonucu Kai’de görün

​Sonraki adım

Çok sayıda kişi aktarın

Kişileri dışa aktarın

1. Bir API anahtarı oluşturun

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

3. Bir kişi gönderin

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

5. Sonucu Kai’de görün

Sonraki adım