Temel Kavramlar (Sözlük)
Bu dokümantasyonda “kadansa kaydet”, “sabit çekirdek”, “ısı 🔥” gibi ifadelerle sık karşılaşacaksın. Her biri Purvisor AI’da somut, spesifik bir anlama gelir — genel bir pazarlama tabiri değil. Bu sayfa, o terimlerin tümünü tek yerde, kısaca tanımlar; derinlemesine bilgi gereken her terimin yanında kendi sayfasına bağlantı var. Diğer sayfalarda bir terime rastlayıp “bu neydi?” dediğinde geri dönülecek yer burası.
Yeni başlıyorsan bu sayfayı baştan sona okumana gerek yok — Purvisor Nedir? veya 5 Dakikada Kurulum ile başla, karşına çıkan bir terimi burada ara.
Hızlı bakış
| Terim | Kısaca | Detay |
|---|---|---|
| Asistan | Telefonda konuşan yapay zeka — prompt + ses + model | Asistan Oluşturma |
| Kampanya | Bir kontak listesini tek bir asistanla toplu arayan outbound operasyonu | Kampanya Nedir? |
| Kadans | Bir kişiye uygulanan, zamana yayılı çok kanallı takip akışı | Cadence Nedir? |
| Aksiyon | Asistanın görüşme sırasında/sonrasında tetiklediği somut işlem | Aksiyonlar — Genel Bakış |
| Kontak | Purvisor’ın aradığı/arayabileceği bir kişinin kaydı | Kontak Yönetimi |
| Pipeline Aşaması | Kontağın satış sürecindeki kümülatif, otomatik ilerleyen konumu | Satış Pipeline |
| Lead Skoru & Isı | 0-100 arası otomatik skor ve sıcak/ılık/soğuk etiketi | Satış Pipeline |
| BANT | Bütçe-Yetki-İhtiyaç-Zaman — bir lead’in alım potansiyelini test eden çerçeve | Satış Pipeline |
| Bilgi Tabanı (RAG) | Asistanın dokümanlarından anlamca arama yaparak cevap bulduğu sistem | Bilgi Tabanı Nedir? |
| Sabit Çekirdek | Her aramada prompt’a doğrudan gömülen, aramasız (retrieval’sız) küçük bilgi bloğu | Bilgi Tabanını Asistana Bağlama |
| Kapsam Koruması | Asistanın konuşmasını iş tanımıyla sınırlı tutan arka plan koruması | Prompt Yazma Rehberi |
| Telefon Numarası / SIP Trunk | Asistanın arayıp/arama alabilmesi için gereken bağlı hat | Telefon Numarası (SIP) |
| Dakika | Faturalama birimi; bir arama bitince bakiyeden düşülen miktar | Dakika Nasıl Düşülür? |
| Entegrasyon | Purvisor’ı dış sistemlere (Meta, CRM, Zapier…) bağlayan köprü | Entegrasyonlar — Genel Bakış |
| Webhook | Purvisor’dan dışarıya giden, imzalı gerçek zamanlı olay bildirimi | Webhook’lar |
| API Anahtarı | Public API’ye erişim için tek, pk_live_ önekli kimlik anahtarı | Kimlik Doğrulama |
Temel yapı taşları
Asistan
Bir asistan, telefonda gerçek bir insan gibi konuşan yapay zeka temsilcisidir — bir prompt (görev tanımı ve konuşma tarzı), bir ses ve bir dil modelinden oluşur. Yeni işe aldığın bir satış temsilcisini düşün: prompt onun iş tanımı ve konuşma kuralları, ses ise kelimenin tam anlamıyla onun sesidir. Bir asistan ya dışa arama (outbound) ya da gelen çağrı (inbound) yönünde çalışacak şekilde kurulur, ve bir kampanyanın her zaman tek bir asistanı olur. Detay: Asistan Oluşturma.
Kampanya
Bir kampanya, elindeki kontak listesini tek bir asistanla, sırayla ve otomatik olarak arayan toplu dışa arama operasyonudur. Bir asistan + bir arayan numara + bir kontak listesi bir araya gelir; mesai penceresi, günlük arama limiti ve yeniden deneme kuralına göre kendi kendine çalışır. “500 kişiyi elle çevirmek” yerine “listeyi yükle, Başlat’a bas” — kampanya bu farkın motorudur. Detay: Kampanya Nedir?.
Kadans
Kadans (cadence), tek bir kişiye uygulanan, günlere yayılmış çok adımlı ve çok kanallı bir takip akışıdır: ara → açılmazsa WhatsApp at → iki gün sonra tekrar ara → e-posta gönder. Kampanya genişlik (aynı anda çok kişi, bir kez) sağlarken kadans derinlik (bir kişi, zamana yayılı takip) sağlar — ikisi rakip değil, birbirini tamamlar. Detay: Cadence Nedir?.
Aksiyon
Aksiyon, asistanın sadece konuşmakla kalmayıp bir şey yapmasıdır: randevu oluşturma, SMS/e-posta/WhatsApp gönderme, kendi sistemine webhook atma, konuşmadan yapılandırılmış bilgi çıkarma. Kısaca, asistanın “beyni” prompt’tur, aksiyonlar ise “elleri” — prompt karar verir, aksiyon işi yapar. Bir aksiyon önce tanımlanır, sonra bir asistana bağlanır, sonra prompt’ta ne zaman tetikleneceği yazılır; üçü birden olmadan çalışmaz. Detay: Aksiyonlar — Genel Bakış.
Kontak ve satış süreci
Kontak
Bir kontak, Purvisor’ın aradığı veya arayabileceği bir kişinin kaydıdır: ad, telefon, e-posta gibi temel bilgilerin yanında tüm görüşme geçmişi, pipeline aşaması, lead skoru ve etiketleri de aynı kayıtta tutulur. Kontaklar bir kampanyaya, bir kadansa veya doğrudan tekil bir aramaya bağlı olabilir. Detay: Kontak Yönetimi.
Pipeline Aşaması
Pipeline aşaması, bir kontağın satış sürecindeki kümülatif konumudur — altı değerden biri: Yeni, İletişimde, Değerlendirme, Taahhüt, Kapandı, Kayıp. Bunu sen elle sürüklemezsin; asistanın her aramadan sonra ürettiği analiz (outcome) bu aşamayı otomatik ilerletir, ve aşama normalde sadece ileri gider — tek istisna, her aşamadan doğrudan tetiklenebilen “Kayıp”tır. Detay: Satış Pipeline.
Lead Skoru & Isı
Lead skoru, 0-100 arası bir puandır: BANT doluluğu (maks. 40), pipeline aşaması (maks. 40), duygu trendi (±10) ve başarı oranından (maks. 10) hesaplanır. Bu skor, panelde ve kanbanda gördüğün sıcaklık (heat) rozetine dönüşür: 70 ve üzeri Sıcak 🔥, 40-69 Ilık 🌡, 40’ın altı Soğuk ❄️. Böylece “hangi lead’i önce aramalıyım” sorusunu tek bakışta cevaplarsın. Detay: Satış Pipeline.
BANT
BANT (Bütçe – Yetki – İhtiyaç – Zaman), bir lead’in gerçekten satın alma potansiyeli taşıyıp taşımadığını dört soruyla test eden klasik bir satış çerçevesidir. Purvisor bu dört kutuyu her görüşme sonrası anahtar kelime sezgisiyle otomatik doldurmaya çalışır (örn. “fiyat” geçerse Bütçe dolar) — mükemmel değildir ama elle doldurmaktan çok daha hızlıdır, ve her kutu panelden elle de düzeltilebilir. Detay: Satış Pipeline.
Bilgi ve konuşma kontrolü
Bilgi Tabanı (RAG)
Bilgi Tabanı, asistanının fiyat listeni, SSS’ini veya ürün kataloğunu yükleyip aramalarda oradan doğru cevap çekmesini sağlayan sistemdir (RAG = retrieval-augmented generation). Açık kitap sınavına giren bir öğrenci gibi çalışır: soruyu okur, dokümanından anlamca en yakın parçayı bulur, oradan cevaplar — ezbere (uydurarak) yanıt vermez. Dokümanların Purvisor içinde parçalara bölünüp vektöre çevrilmesi ve arama anında geri çağrılması hep bu sistemin işidir. Detay: Bilgi Tabanı Nedir?.
Sabit Çekirdek (Çekirdek Bilgi)
Sabit çekirdek (panelde “Çekirdek Bilgi”), her aramada asistanın prompt’una doğrudan gömülen, küçük ve sık kullanılan bir bilgi bloğudur — şirket adı, çalışma saatleri, marka tonu gibi. Bilgi Tabanı’ndan (RAG) farkı burada: bir arama/retrieval adımı yoktur, asistan bu bilgiyi her zaman zaten “bilir”; bu yüzden 4.000 karakterle sınırlıdır ve büyük katalog/SSS için uygun değildir. Kısaca: az ve sık kullanılan bilgi çekirdekte, çok ve nadiren gereken bilgi Bilgi Tabanı’nda durur. Detay: Bilgi Tabanını Asistana Bağlama.
Kapsam Koruması
Kapsam koruması (scope guardrail), her asistanın konuşmasını kendi görev tanımıyla sınırlı tutan arka plan mekanizmasıdır: model, iş konusuyla ilgisi olmayan isteklere (fıkra anlatma, alakasız sohbet gibi) yanıt vermekten kaçınacak şekilde yönlendirilir. Bunun amacı basit — bir satış asistanı “bana fıkra anlat” isteğine içtenlikle uyarsa hem görüşme amacından sapar hem de marka izlenimini “iş asistanı değil, genel sohbet botu” seviyesine düşürür. Arka planda çalışsa da, prompt’a da açık bir sınır cümlesi eklemek bu korumayı güçlendirir. Detay: Prompt Yazma Rehberi.
Telefoni ve faturalandırma
Telefon Numarası / SIP Trunk
Asistanının arama yapabilmesi (outbound) veya arama alabilmesi (inbound) için bağlı bir telefon numarası gerekir. Bu numara bir SIP trunk üzerinden gelir — operatörün (Türkiye’de tipik olarak Netgsm, uluslararası için Twilio) sana verdiği hattı, Purvisor’ın gerçek zamanlı ses altyapısı LiveKit’e bağlayan köprü. SIP trunk olmadan test araması, kampanya, otomatik lead araması ve kadansın “arama” adımı çalışmaz. Detay: Telefon Numarası (SIP).
Dakika
Dakika, Purvisor’ın faturalama birimidir. Bir arama bittiğinde bakiyenden ne kadar düşüleceği tam olarak o anda hesaplanır ve saniye cinsinden süre dakikaya yukarı yuvarlanır (61 saniye = 2 dakika). En kritik kural: 30 saniyeden kısa aramalar (meşgul, açılmadı, hemen kapandı) hiç ücretlendirilmez; bakiye de hiçbir zaman negatife düşmez. Detay: Dakika Nasıl Düşülür?.
Entegrasyon ve geliştirici
Entegrasyon
Entegrasyon, lead’lerinin geldiği yeri (Facebook formu, CRM, web sitesi) Purvisor’ın arama yaptığı yere bağlayan köprüdür. Üç yoldan biriyle kurulur: OAuth “Bağla” akışı (Meta, WhatsApp, Gmail, Kommo), manuel API anahtarı (Twilio, Cal.com, NetGSM) veya genel bir lead webhook’u (web formu, Zapier, Make, n8n). Bir kez bağlanır; sonrasında her yeni lead otomatik olarak kontağa dönüşüp kurallarına göre aranır. Detay: Entegrasyonlar — Genel Bakış.
Webhook
Webhook, Purvisor’dan dışarıya (senin sunucuna, Zapier’e, Make’e) giden gerçek zamanlı bir olay bildirimidir — “arama bitti”, “yeni kontak oluştu” gibi bir olay gerçekleştiği anda HTTP POST ile gönderilir; sen sürekli sorgulamak zorunda kalmazsın. Her teslimat HMAC-SHA256 ile imzalanır, böylece bildirimin gerçekten Purvisor’dan geldiğini doğrulayabilirsin. Zapier “Trigger” ve Make “Watch” modüllerinin altında çalışan mekanizma da tam olarak budur. Detay: Webhook’lar.
API Anahtarı
API anahtarı, Purvisor AI Public API’sine erişmek için kullandığın tek kimlik doğrulama değeridir — pk_live_ öneki ve ardından 48 hex karakterden oluşur (toplam 56 karakter). Oturum cookie’si veya OAuth akışı yoktur; bu tek anahtarı bir isteğe X-API-Key başlığıyla eklersin, Zapier/Make/n8n veya kendi sunucun saniyeler içinde arama başlatıp kontak oluşturabilir. Veritabanında düz metin değil, hash’lenmiş olarak saklanır. Detay: Kimlik Doğrulama.