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

# Kimlik

> Kai bir yazma işleminin hangi kişiye ait olduğuna nasıl karar verir.

Kai bir yazma işlemini kimliğe göre bir kişiyle eşleştirir. Kimlik, tek bir
kişiye ait tek bir adrestir. Bir kişi birden çok kimlik taşıyabilir.

## Dört tür

| Tür        | Örnek                         | Kim yazar                 |
| ---------- | ----------------------------- | ------------------------- |
| `external` | `DK-1042`                     | siz, `external_id` olarak |
| `email`    | `ayse@example.com`            | siz, `email` olarak       |
| `phone`    | `905321112233`                | siz, `phone` olarak       |
| `channel`  | `whatsapp_cloud:905321112233` | mesajlaşma kanalı         |

`external_id`, `email` ve `phone` kendiliğinden birer kimlik olur. Bunlar için
`identities` dizisine ihtiyacınız yoktur. Bu diziyi bir kanal adresi veya
ikinci bir e-posta adresi için kullanın.

## Normalleştirme

Kai bir kimliği tek bir biçimde saklar ve eşleştirmeyi o biçim üzerinden yapar:

* e-posta adresi küçük harfe çevrilir;
* telefon numarasında yalnızca rakamlar kalır ve `00` öneki düşer;
* `external` ve `channel` değerleri büyük küçük harf yapısını korur, çünkü
  başka bir sisteme aittir.

Aynı numaranın üç yazılışı bu nedenle tek bir kimliktir:

| Gönderdiğiniz        | Kai'nin sakladığı |
| -------------------- | ----------------- |
| `+90 532 111 22 33`  | `905321112233`    |
| `0090 532 111 22 33` | `905321112233`    |
| `905321112233`       | `905321112233`    |

Bir WhatsApp görüşmesi ile CRM'inizden gelen bir kişi bu yüzden aynı kayıtta
buluşur.

## Eşleştirme sırası

Kai istekteki kimlikleri okur ve bunları taşıyan kişileri bulur:

1. hiçbir kişi bunlardan birini taşımıyorsa: Kai bir kişi oluşturur ve istekteki
   her kimliği ona verir;
2. bir kişi bunlardan birini veya birkaçını taşıyorsa: Kai o kişiyi günceller ve
   henüz taşımadığı kimlikleri ekler;
3. iki kişi bunları taşıyorsa: Kai yazma işlemini reddeder.

## Çakışmalar

Üçüncü durum 409 döner ve kimlikleri belirtir:

```json theme={null}
{
  "error": {
    "type": "identity_conflict",
    "message": "Those identifiers already belong to two different contacts. Kai does not merge contacts automatically.",
    "details": [
      { "kind": "email", "value": "ayse@example.com" },
      { "kind": "phone", "value": "905321112233" }
    ]
  }
}
```

Kai iki kişiyi birleştirmez. Birleştirme geri alınamaz ve yanlış bir
birleştirme, bir müşterinin geçmişini başka bir müşterinin önüne koyar.
Çakışmayı Kai'de **Kişiler** ekranından düzeltin veya her kişiye Kai kimliği
üzerinden yazın.

## En az bir kimlik gönderin

`POST /contacts`, hiç kimlik taşımayan bir isteği reddeder. Kimlik olmadan
Kai'nin eşleştirecek bir şeyi olmaz ve iki kez çalışan bir iş, her kişinin
ikinci bir kopyasını oluştururdu.