Genel Bakış
Bu sayfa, platformdaki tüm form alanlarını, zorunluluk durumlarını ve validasyon kurallarını içerir.Bu referans, kod analizi ile oluşturulmuştur ve gerçek uygulama davranışını yansıtır.
1. AI Agent Oluşturma Formu
Sayfa:/agents/new
Temel Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon | Varsayılan |
|---|---|---|---|---|---|
name | AI Agent Adı | Text | ✅ Evet | Max 40 karakter | - |
description | Açıklama | Textarea | ❌ Hayır | Max 1000 karakter | - |
agentType | AI Agent Tipi | Select | ✅ Evet | e-commerce, appointment, support | - |
pipelineId | Pipeline Departmanı | Select | ✅ Evet | Sales veya Service | - |
greetingMessage | Karşılama Mesajı | Textarea | ❌ Hayır | Max 250 karakter | - |
firstMessageMode | İlk Mesaj Modu | Select | ✅ Evet | speaks-first, waits, model-generated | - |
systemPrompt | Sistem Talimatı | Textarea | ❌ Hayır | Sınırsız | - |
Yönlendirme Alanları (Koşullu)
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
escalationEnabled | Otomatik Yönlendirme | Toggle | ❌ Hayır | - |
destinationType | Hedef Tipi | Select | ⚠️ Koşullu | number, sip |
destinationNumber | Yönlendirme Numarası | Text | ⚠️ Koşullu | E.164 format, max 16 |
destinationSip | SIP Hedefi | Text | ⚠️ Koşullu | SIP URI format |
escalationMessage | Yönlendirme Mesajı | Textarea | ⚠️ Koşullu | Min 20, max 250 karakter |
escalationConditions | Yönlendirme Koşulları | Multi-checkbox | ⚠️ Koşullu | En az 1 seçili |
Gelişmiş Yönlendirme Alanları
Bu alanlar yönlendirme aktifken opsiyonel olarak ayarlanabilir. Yönlendirme deneyimini özelleştirmek için kullanılır.
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon | Varsayılan |
|---|---|---|---|---|---|
escalationFailedMessage | Başarısız Yönlendirme Mesajı | Textarea | ❌ Hayır | Min 20, max 250 karakter | - |
delayedMessage | Gecikme Mesajı | Textarea | ❌ Hayır | Min 20, max 250 karakter | - |
delayInMs | Gecikme Süresi (ms) | Number | ❌ Hayır | 100-120.000 ms | 5000 |
endTheCallAfterMessageIsSpoken | Mesaj Söylendikten Sonra Çağrıyı Sonlandır | Toggle | ❌ Hayır | - | false |
Gizli/Sabit Değerler
Bu değerler kodda sabit olarak tanımlanmıştır ve kullanıcı tarafından değiştirilemez.
| Alan | Değer | Açıklama |
|---|---|---|
temperature | 0.7 | Yaratıcılık seviyesi |
escalationTimeout | 2 saniye | Yönlendirme öncesi bekleme |
maxEscalationAttempts | 3 | Maksimum yönlendirme denemesi |
Zorunlu Alan Özeti
Her Zaman Zorunlu (4 alan):- AI Agent Adı (max 40 karakter)
- AI Agent Tipi (e-commerce/appointment/support)
- Pipeline Departmanı (sales/support)
- İlk Mesaj Modu
- Hedef (Telefon veya SIP)
- Yönlendirme Mesajı (20-250 karakter)
- En az 1 Yönlendirme Koşulu
2. Müşteri Ekleme Formu
Sayfa:/crm/customers/new
Zorunlu Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon | Karakter Limit |
|---|---|---|---|---|---|
firstName | Ad | Text | ✅ Evet | Sadece harf+boşluk | 100 |
lastName | Soyad | Text | ✅ Evet | Sadece harf+boşluk | 100 |
phone | Telefon | Text | ✅ Evet | E.164 format | 16 |
Opsiyonel Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Validasyon | Karakter Limit |
|---|---|---|---|---|
email | E-posta | Text | Email format | 100 |
company | Şirket | Text | - | 100 |
title | Pozisyon | Text | - | 100 |
address | Adres | Textarea | - | 1000 |
city | Şehir | Text | - | 100 |
country | Ülke | Text | - | 100 |
birthDate | Doğum Tarihi | Date | 1900-bugün arası | - |
gender | Cinsiyet | Select | Erkek/Kadın/Diğer | - |
segment | Segment | Select | API’den yüklenir | - |
tags | Etiketler | Badge Array | Max 5 etiket | - |
customFields | Özel Alanlar | Key-Value | Max 5 alan | - |
notes | Müşteri Notları | Textarea | - | 2000 |
3. Bilgi Bankası Oluşturma Formu
Sayfa:/knowledge/new
Zorunlu Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
name | İsim | Text | ✅ Evet | Min 2, max 50 karakter |
description | Açıklama | Textarea | ✅ Evet | Max 250 karakter |
files | Dosyalar | File Upload | ✅ Evet | En az 1 dosya, max 300KB per dosya |
Desteklenen Dosya Formatları
- DOCX (.docx)
- Text (.txt)
- CSV (.csv)
4. SIP Trunk Oluşturma Formu
Sayfa:/santral
Zorunlu Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
name | Adı | Text | ✅ Evet | Max 100 karakter |
username | Kullanıcı Adı | Text | ✅ Evet | Max 100 karakter |
password | Şifre | Password | ✅ Evet | Max 100 karakter |
Gateway Alanları (Her SIP Trunk için en az 1)
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon | Varsayılan |
|---|---|---|---|---|---|
ip | IP Adresi | Text | ❌ Hayır | IPv4 format | - |
port | Port | Number | ✅ Evet | 1-65535 | 5060 |
outboundProtocol | Protocol | Select | ✅ Evet | udp, tcp, tls, tls/srtp | udp |
netmask | Netmask | Number | ✅ Evet | 0-32 | 32 |
optionsPingEnabled | Options Ping | Checkbox | ❌ Hayır | - | false |
5. Kampanya Oluşturma Formu
Sayfa:/campaigns/new
Zorunlu Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
name | Kampanya Adı | Text | ✅ Evet | - |
callListId | Çağrı Listesi | Select | ✅ Evet | API’den yüklenir |
agentId | AI Agent | Select | ✅ Evet | Aktif agent’lar |
phoneNumberId | Telefon Numarası | Select | ✅ Evet | Aktif numaralar |
Opsiyonel Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Validasyon | Varsayılan |
|---|---|---|---|---|
purpose | Amaç | Textarea | - | - |
startTime | Başlangıç Zamanı | DateTime | Gelecek tarih | Hemen |
concurrentCalls | Eş Zamanlı Çağrılar | Number | Min 1 | 10 |
delayBetweenCalls | Çağrılar Arası Gecikme | Number | 0-300 saniye | 10 |
greetingTemplate | Karşılama Şablonu | Textarea | - | - |
6. Çağrı Listesi Oluşturma Formu
Sayfa:/campaigns/lists
Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
name | Liste Adı | Text | ✅ Evet | Min 1, max 100 karakter |
description | Açıklama | Textarea | ❌ Hayır | Max 250 karakter |
Çağrı listesi oluşturulduktan sonra listeye tek tek veya toplu olarak müşteri ekleyebilirsiniz.
7. Arama Yasağı (DNC) Formu
Sayfa:/campaigns/lists → DNC sekmesi
Alanlar
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
phone | Telefon Numarası | Text | ✅ Evet | E.164 format, max 16 karakter |
reason | Sebep | Select | ✅ Evet | Katalogdan yüklenir (müşteri talebi, yasal zorunluluk, şikayet, vb.) |
description | Açıklama | Textarea | ❌ Hayır | Serbest metin |
isTemporary | Geçici Kayıt | Toggle | ❌ Hayır | false (varsayılan) |
expiresAt | Son Tarih | Date | ⚠️ Koşullu | Geçici kayıt aktifse zorunlu, gelecek tarih |
8. Organizasyon Kurulum Formu
Sayfa:/setup
Bu form yeni kullanıcıların platformu ilk kullanımında organizasyon oluşturmak için doldurması gereken formdur. Tüm alanlar Türkiye’ye özel validasyon kuralları içerir.
Şirket Bilgileri
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
name | Şirket Adı | Text | ✅ Evet | - |
businessName | Ticari Unvan | Text | ✅ Evet | - |
phone | Telefon | Text | ✅ Evet | E.164, +90 oto-eklenir, max 13 karakter (Türkiye GSM) |
email | E-posta | Text | ✅ Evet | Geçerli e-posta formatı |
website | Website | Text | ❌ Hayır | URL format, https:// otomatik eklenir |
Vergi Bilgileri
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
taxNumber | Vergi Numarası | Text | ✅ Evet | 10 haneli, VKN algoritması ile doğrulama, 0 ile başlayamaz |
taxOffice | Vergi Dairesi | Text | ✅ Evet | - |
kepAddress | KEP Adresi | Text | ❌ Hayır | - |
Yetkili Bilgileri
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
authorizedPerson | Yetkili Kişi Adı | Text | ✅ Evet | Hesap bilgilerinden otomatik doldurulur |
authorizedPersonTitle | Yetkili Kişi Ünvanı | Text | ✅ Evet | - |
Adres Bilgileri
| Alan Adı | Türkçe Label | Alan Tipi | Zorunlu | Validasyon |
|---|---|---|---|---|
address | Adres | Text | ✅ Evet | - |
city | İl | Text | ✅ Evet | - |
country | Ülke | Text | ✅ Evet | Varsayılan: “Türkiye” |
postalCode | Posta Kodu | Text | ✅ Evet | 5 haneli, ilk 2 hane il plaka kodu (01-81) |
Özel Validasyon Kuralları
Vergi Numarası (VKN) Doğrulaması
Vergi Numarası (VKN) Doğrulaması
- Tam olarak 10 haneli olmalıdır
- 0 ile başlayamaz
- VKN algoritmasına göre son hane (kontrol hanesi) doğrulanır
- Sadece rakam içerebilir
Posta Kodu Doğrulaması
Posta Kodu Doğrulaması
- Tam olarak 5 haneli olmalıdır
- İlk 2 hane geçerli bir il plaka kodu olmalıdır (01-81)
- Sadece rakam içerebilir
Telefon Numarası Doğrulaması
Telefon Numarası Doğrulaması
+90otomatik olarak eklenir- Türkiye GSM numarası 5 ile başlamalıdır
- Toplam 13 karakter (ülke kodu dahil)
libphonenumber-jsile doğrulanır
Validasyon Kuralları
Telefon Numarası (E.164 Format)
E.164 format: +[ülke kodu][alan kodu][numara]Örnek: +905301234567- Başında
+işareti olmalı - Sadece rakam içermeli
- Maksimum 16 karakter
E-posta Validasyonu
- Geçerli e-posta formatı
@işareti zorunlu- Domain uzantısı zorunlu
SIP URI Format
SIP URI format:
sip:[kullanıcı]@[domain]Örnek: sip:ozan@mysip.comOrtak Hatalar ve Çözümler
Karakter limiti aşıldı
Karakter limiti aşıldı
Her alan için belirtilen maksimum karakter sınırına dikkat edin. Gerçek zamanlı karakter sayacı olan alanlarda limit otomatik gösterilir.
Geçersiz format
Geçersiz format
Telefon numarası, e-posta ve SIP URI alanlarında doğru format kullanıldığından emin olun.
Koşullu alanlar eksik
Koşullu alanlar eksik
Yönlendirme aktif edildiğinde, hedef tip, hedef bilgisi ve mesaj alanlarının doldurulması zorunludur.
Vergi numarası doğrulanamadı
Vergi numarası doğrulanamadı
VKN algoritmasına göre kontrol hanesi doğrulanır. 10 haneli olduğundan ve 0 ile başlamadığından emin olun.
Posta kodu geçersiz
Posta kodu geçersiz
Posta kodu 5 haneli olmalı ve ilk iki hane geçerli bir il plaka kodu (01-81) olmalıdır.