Kayıt kimlikleri
Sayısal kimlik (id) ile 15 karakterlik kalıcı kayıt kimliği (rid) arasındaki fark ve hangisinin nerede kullanılacağı.
Her kaydın iki kimliği vardır:
id |
rid |
|
|---|---|---|
| Biçim | Tamsayı (42) |
15 karakter (001aB3xY7…) |
| Kapsam | Kayıt türü içinde benzersiz | Kurulum içinde benzersiz, türü de söyler |
| Kullanım | API yolları ve parametreleri | Dış sistemlerde saklama, arama, Excel eşleştirmesi |
| Değişir mi? | Hayır | Hayır |
API uçları her zaman id alır (/api/v1/customers/42). rid ise başka bir sistemde CRM kaydına referans saklamak, kullanıcıya göstermek ya da Excel'den içe aktarırken eşleştirmek içindir: tek başına kaydın türünü de taşır.
Önekler
rid'in ilk üç karakteri kayıt türünü verir:
| Önek | Tür | Önek | Tür |
|---|---|---|---|
001 |
Firma | 00T |
Görev |
003 |
Kişi | 00Q |
Fuar leadi |
006 |
Fırsat | 0Q0 |
Teklif |
00U |
Ziyaret / görüşme | 801 |
Sipariş |
a0D |
Deneme | 800 |
Sözleşme |
01t |
Ürün | 500 |
Destek talebi |
Kalan 12 karakter büyük-küçük harf duyarlı rastgele harf ve rakamlardır.
rid ile kayıt bulmak
Arama ucuna 15 karakterlik bir rid verirseniz yanıtın record alanı o kaydı çözer:
{
"ok": true,
"record": { "kind": "Customer", "url": "/customers/42", "customer_id": 42 },
"customers": [], "contacts": [], "opps": [], "leads": []
}Web arayüzünde de üst çubuktaki arama ve komut paleti (Ctrl/⌘ + K) rid kabul eder.
Dış kimlikler
Başka bir sistemdeki kimliği CRM'de saklamak isterseniz veri eşitleme kancası external_id alanını kayda bağlar ve sonraki gönderimlerde aynı kaydı günceller. Uygulamaların açtığı dış kayıtlar (Notion sayfası, Asana görevi…) da dış kimlik ve bağlantısıyla kayda yazılır; kayıt sayfasındaki Uygulamalar menüsünden açılır.