Records

Kayıtlar, agent'ınızın topladığı ve sakladığı yapılandırılmış verilerdir: potansiyel müşteriler, randevular, siparişler, destek talepleri ya da ürünler, boş randevu saatleri gibi kendi öğeleriniz. Her tür, tanımladığınız alanlara sahip bir tabloda durur. Agent müşterilerin söylediklerini kaydeder, Fonksiyonlar ve otomasyonlar da okuyup yazabilir, ekibiniz de verilerle Records sayfasında çalışır.

Yanıtlardan fazlasını istediğinizde kayıtları kullanın: geri aranacak kişilerin listesi, onaylanacak randevular, takip edilecek siparişler.

Tablo olmadan hiçbir şey değişmez

Tablosu olmayan bir agent kayıt araçları ve konuşmadan doldurma almaz; eskisi gibi davranır.

Nerede bulunur

Bir agent açın ve kenar çubuğunda Records'a tıklayın. Sayfa her tablo için bir sekme ve kayıt sayısını gösterir. Henüz yayındaki sürümde olmayan bir tablo Yayında değil olarak işaretlenir.

Sayfa başlığında şunlar vardır:

Eylem	Ne yapar	Kim
Tablo ayarları	Tablonun tanım düzenleyicisini açar.	Herkes açabilir; editörler değiştirir.
CSV içe aktar	Bir CSV dosyasından satır ekler ya da günceller.	Editör ve üstü
CSV olarak indir	Tablonun kayıtlarını indirir.	Herkes
Copilot	Copilot'u açar.	Herkes

Kayıtlar çalışma alanı verisidir. İzleyiciler okur; editör ve üstü roller kayıt ekler, düzenler, siler ve tabloları değiştirir; bir tabloyu yalnızca yöneticiler ve sahipler silebilir.

Tablo oluşturun

En hızlı yol Copilot'a sormaktır. Agent'ınızın hedefi veri toplamayı içeriyorsa bir tablo önerir, alanları bir kartta gösterir ve siz onaylayınca oluşturur. Sonra bir test konuşması çalıştırır ve bir kaydın kaydedildiğini kontrol eder.

Kendiniz oluşturmak için:

1. Records sayfasında Yeni tablo'ya tıklayın (boş durumun ya da tablonun altında).
2. Bir şablon seçin. "Bir şablonla başlayın; kaydetmeden önce her alanı değiştirebilirsiniz."
3. Alanları Tablo ayarları'nda düzenleyin ve kaydedin.
4. Agent'ı Yayınla'yın. Müşteri konuşmaları o andan itibaren tabloyu kullanır.

Şablon	Alanlar
Potansiyel müşteriler	Ad (başlık, zorunlu), Telefon (eşleştirme), E-posta, İlgi, Bütçe, Kaynak, Durum (New, Contacted, Qualified, Won, Lost)
Randevular	Ad (başlık), Telefon (eşleştirme), Hizmet, Zaman (zorunlu), Notlar, Durum (Requested, Confirmed, Cancelled, Done)
Siparişler	Sipariş numarası (başlık, eşleştirme), Ad, Telefon, Ürünler, Toplam, Durum (New, Paid, Shipped, Delivered, Cancelled, Returned)
Destek talepleri	Konu (başlık, zorunlu), Ad, Telefon, E-posta, Ayrıntılar, Öncelik (Low, Normal, High), Durum (Open, Waiting, Resolved)
Boş tablo	Tek bir ad alanı; ihtiyacınız olan alanları ekleyin.

Şablonların seçenekleri İngilizce gelir; Tablo ayarları'nda Türkçeye çevirebilirsiniz (örneğin Durum için Yeni, Arandı, Nitelikli, Kazanıldı, Kaybedildi).

Şablonlar kişilerin verisini tutar, bu yüzden ajanın Okuma erişimi kapalı başlar (Ajan erişimi bölümüne bakın).

Tablolar taslak ve yayın düzenine uyar

Tablo ayarları, talimatlar gibi agent'ın taslağının parçasıdır. Bir değişiklik yalnızca yayınladığınızda müşterilere ulaşır. Eski bir sürümü geri yüklemek hiçbir kaydı silmez: verileriniz sürümlenmez. Geri yüklenen sürümde olmayan tablolar taslakta kalır.

Tablo ayarları

"Her tablonun ne tuttuğu ve ajanın onu nasıl kullanabileceği. Değişiklikler yayınladığınızda müşterilere ulaşır."

Tablo

Ayar	Ne yapar
Ad	Sekmelerde görünür, İngilizce ve Türkçe.
Anahtar	Araç adlarında (save_<anahtar>, find_<anahtar>), Fonksiyonlarda ve API'de kullanılır. Küçük harf, rakam ve _; harfle başlar, en fazla 58 karakter. Sonradan yeniden adlandırılabilir; veriler korunur.
Açıklama	"Ajan bu tabloya neyin gireceğini buradan anlar."

Alanlar

Her alanın bir Etiket'i, bir Anahtar'ı (küçük harf, rakam ve _, en fazla 64 karakter), bir Tür'ü, bir açıklaması ("Ajanın buraya ne yazması gerektiği") ve Zorunlu seçeneği ("Bu olmadan kayıt kaydedilemez") vardır.

Tür	Nasıl saklanır	Notlar
Metin	Metin	En fazla 1.000 karakter.
Uzun metin	Metin	En fazla 10.000 karakter.
Sayı	Sayı	"42" gibi metinler kabul edilir.
Para	{ "amount": 1500, "currency": "TRY" }	3 harfli para birimi kodu. Yalnızca sayı ya da "1500" girilirse TRY olarak kaydedilir; "1500 EUR" da olur.
Tarih	YYYY-AA-GG
Tarih ve saat	ISO 8601	Örneğin 2026-10-20T14:30:00+03:00; UTC olarak saklanır.
Evet / hayır	true / false	evet/hayır, yes/no, 1/0 da kabul edilir.
Seçim	Seçeneklerden biri	En fazla 100 seçenek, her biri en fazla 80 karakter. Kaydederken büyük-küçük harf önemli değildir.
Etiketler	Seçeneklerden birkaçı	Bir liste ya da virgül veya noktalı virgülle ayrılmış metin.
Telefon	+ ve 7–15 rakam	Boşluk, tire ve parantezler atılır. 00 + olur; 0532… gibi bir cep numarası +90532… olur.
E-posta	Küçük harfli adres
URL	Web adresi	http:// ya da https:// ile başlamalı.
Referans	Bir kayıt id'si	Başka bir tablodaki bir kayda işaret eder (tabloyu seçin).
Dosya	Dosya referansları	"Müşterinin gönderdiği ya da sizin yüklediğiniz fotoğraf veya belgeler." Tek dosya ya da Birden fazla dosya ile en fazla 5.

Türü değiştirmek kayıtlı değerleri korur. Artık uymayan değerler Düzeltilmeli olarak işaretlenir, asla silinmez.

Bir alanı silmek onu tablodan kaldırır. "Değerleri yayınladıktan sonra 30 gün saklanır," sonra temizlenir. Başka bir başlık seçmeden başlık alanı silinemez.

Başlık ve eşleştirme

• Başlık alanı: "Her kaydın adı olarak gösterilir."
• Aynı kayıt sayılır: aynı kaydı tanımlayan en fazla 3 alan. "Aynı telefon ya da e-postayla yapılan kayıt, yenisini oluşturmak yerine o kaydı günceller. Ad seçmeyin: farklı kişilerin adı aynı olabilir." Yalnızca metin, sayı, telefon, e-posta ya da URL alanları seçilebilir.

İki kayıt aynı eşleştirme değerlerine sahip olacaksa kaydetme reddedilir; zaten çakışan bir kayıt Düzeltilmeli gösterir.

Ajan erişimi

Erişim	Ajana verdiği
Okuma	find_<anahtar>: "Ajan bu tabloda arama yapabilir."
Oluşturma	save_<anahtar>: "Ajan kayıt ekleyebilir."
Güncelleme	"Ajan bulduğu ya da daha önce kaydettiği kayıtları değiştirebilir."

Kişilerin verisinde Okuma'yı kapalı tutun

"Yalnızca kendi ürünleriniz (araçlar, ürünler, saatler) için açın, kişilerin verileri için asla: bir müşteri başkalarını sorabilir."

Toplama

Ayar	Ne yapar	Varsayılan
Konuşmadan doldur	"Bir konuşma sessizleştikten 10 dakika sonra küçük bir model bu tabloyu o konuşmadan doldurur."	Kapalı
Kayıtlar onay bekler	"Ajanın kayıtları bir ekip arkadaşı onaylayana kadar bekler." Onaylar sayfasına bakın.	Kapalı
Kayıt reddedilince	Müşteriye söyle ya da Bir şey söyleme.	Müşteriye söyle

Tabloyu silin

Tabloyu sil (yöneticiler) tabloyu taslaktan kaldırır. "Kayıtları, tablosuz bir sürüm yayınlandıktan 30 gün sonra silinir."

Kayıtlar nasıl dolar

Agent, konuşmalarda

Agent, yayındaki her tablo için yanıt anında araçlar alır:

• save_<anahtar> (Oluşturma ya da Güncelleme erişimiyle). Her alan isteğe bağlı bir girdidir; null alanı temizler. Kaydederken:

  1. Aynı kayıt sayılır alanları mevcut bir kayıtla eşleşirse o kayıt güncellenir.
  2. Eşleşmezse ve bu konuşmanın tabloda zaten bir kaydı varsa o güncellenir.
  3. Yoksa yeni bir kayıt oluşur.

  Hatalar alan alan döner ("Use a phone number with 7 to 15 digits, e.g. +905321234567") ve agent bunları düzeltebilir.

• find_<anahtar> (Okuma erişimiyle). eq, in, range ve contains filtreleri, sıralama ve en fazla 20 sonuç. Her sonuç başlığı ve en fazla 8 alanı gösterir.

Kişisel veriler korunur: model [PHONE_1] gibi yer tutucularla çalışır; araç ise gerçek değeri alır ve saklar. Bir konuşmada kaydedilen kayıtlar o konuşmaya ve müşterisine bağlanır.

Kayıtlar onay bekler açıkken kaydetme bir onay isteğine dönüşür ve agent müşteriye ekibin onaylayacağını söyler.

Konuşmadan doldurma

Konuşmadan doldur açıkken küçük bir model, konuşma sessizleştikten 10 dakika sonra konuşmayı okur (kişisel veriler gizli) ve tablonun kayıtlarını oluşturur ya da tamamlar. Bu model:

• yalnızca emin olduğu alanları doldurur, asla tahmin etmez,
• bir kişinin elle değiştirdiği bir alanın üzerine asla yazmaz,
• yeni mesajlardan sonra, konuşma yeniden sessizleşince tekrar çalışır,
• Kayıtlar onay bekler ayarına uyar.

Maliyeti Kullanım sayfasında görünür.

Fonksiyonlar ve otomasyonlar

Fonksiyon kodu tabloları anahtarlarıyla okur ve yazar:

const bulunan = await ctx.records.find('leads', { where: [{ field: 'status', op: 'eq', value: 'Yeni' }], limit: 10 });
await ctx.records.save('leads', { name: 'Ayşe Kaya', phone: '+905321234567', status: 'Arandı' });

Çalışma başına en fazla 50 kaydetme ve 20 arama. Deneme çalışmasında ya da salt okunur bir testte kaydetmeler raporlanır, yazılmaz. Bir Fonksiyondan ya da otomasyondan gelen kayıtlar, geldikleri otomasyon çalışmasına bağlanır. Bir otomasyon görevi, save_ ve find_ araçları İzinli eylemler arasındaysa onları kullanabilir. Automations sayfasına bakın.

Kişiler

Editörler kayıt sayfasında elle kayıt ekler ve değiştirir ya da CSV'den içe aktarır.

Kayıtlara göz atın

Tablo sayfa başına 50 kayıt gösterir, en yeni en üstte.

• Kayıtlarda ara: metin, uzun metin, e-posta, telefon ve URL alanlarında arar.

• Filtre: alan, koşul ve değer satırları ekleyin, sonra Uygula'ya tıklayın. Koşullar türe göre değişir:

  Alan türü	Koşullar
  Metin, uzun metin, telefon, e-posta, URL	eşittir, içerir
  Sayı, para, tarih, tarih ve saat	eşittir, arasında (En az / En çok)
  Seçim, etiketler	eşittir, şunlardan biri
  Evet / hayır, referans	eşittir
  Dosya	filtrelenemez

• Hangi kayıtlar: Tümü, Düzeltilmeli (alanına uymayan değerler), Silinenler (çöp kutusu).

• Test kayıtlarını göster: test konuşmalarının ve taslak çalışmalarının kaydettikleri varsayılan olarak gizlidir ve Test ile işaretlenir.

• Sütunlar: sütunları seçin. Varsayılan olarak başlık ve sonraki beş alan görünür. Varsayılana dön bunu geri getirir. Seçiminiz tarayıcınızda saklanır.

• Sıralama: bir sütun başlığına tıklayın; tersine çevirmek için tekrar tıklayın. Dosya alanları sıralanamaz.

Kayıt sayfası

Açmak için bir kayda tıklayın. Yeni bir kayıt için tablonun altındaki Kayıt ekle'ye tıklayın.

• Alanlar: her etkin alan, editörler tarafından düzenlenebilir. Uymayan değerler Düzeltilmeli: ve nedenini gösterir. Kaydet'e tıklayın.
• Kaynak: kaydın nereden geldiği: Bir konuşmadan (Inbox'ta açar), Bir otomasyondan, CSV dosyasından içe aktarıldı, Bir ekip arkadaşı ekledi ya da Konuşmadan dolduruldu.
• Geçmiş: her alan değişikliği, kimin yaptığı (Ajan, Konuşmadan dolduruldu, Ekip arkadaşı, Otomasyon, CSV içe aktarma) ve ne zaman; ayrıca silme, geri alma ve onay kararları.
• Onay istekleri: bu kayıtla ilgili istekler ve durumları.

Siz açtıktan sonra biri kaydı değiştirdiyse kaydederken "Bu kayıt siz açtıktan sonra değişti. En güncel halini görmek için yenileyin, sonra değişikliğinizi yeniden yapın." görürsünüz.

Sil kaydı Silinenler'e taşır. "Silinenler'e taşınır ve 30 gün içinde geri alınabilir." Silinenler görünümünden açıp Geri al'a tıklayın. 30 gün sonra temizlenir.

Inbox da kayıt kaydetmiş her konuşmada Bu konuşmadan kayıtlar kartını gösterir.

CSV içe aktarın

1. CSV içe aktar'a ve CSV dosyası seçin'e tıklayın. "En fazla 2 MB ve 5.000 satır; ilk satır sütun adlarını içerir."
2. Her Dosyadaki sütun'u bir Alan'a eşleyin ya da Atla deyin. İlk satırlar'ı kontrol edin.
3. İçe aktar'a tıklayın.

Aynı kayıt sayılır değerleri aynı olan satırlar mevcut kaydı günceller. Sonuç "N oluşturuldu, N güncellendi, N başarısız" olarak ve başarısız her satırın hatalarıyla görünür. Dosya sütunları içe aktarılmaz. Boş satırlar atlanır.

CSV olarak indirin

CSV olarak indir, mevcut tablonun tüm canlı kayıtlarını (silinmemiş, test olmayan) <anahtar>.csv olarak indirir. Sütunlar alan anahtarları, ardından id ve createdAt'tir. Etiketler ve birden çok değer ; ile birleştirilir, para 1500 TRY olarak yazılır, dosya alanları dosya adlarını gösterir.

Limitler

Limit	Değer
Agent başına tablo	20
Tablo başına alan	50 etkin (silinenlerle 100)
Tek bir kaydın boyutu	32 KB
Agent başına kayıt	100.000
Eşleştirme alanı	3
Seçim ya da etiketler alanı başına seçenek	100
Dosya alanı başına dosya	5
find_ sonucu	20
Çalışma başına ctx.records	50 kaydetme, 20 arama
Silinen kayıt ve alanların saklanması	30 gün
CSV içe aktarma	2 MB, 5.000 satır

İlgili sayfalar

• Onaylar
• Automations
• Tetikleyiciler: kayıt olayları
• Fonksiyonlar
• Guardrails ve gizlilik
• Inbox