AvaritCall Dokümantasyonu

1. Platforma Giriş

AvaritCall, işletmelerin yapay zeka destekli sesli telefon asistanları oluşturmasını, yönetmesini ve ölçeklemesini sağlayan bir SaaS platformudur.

• Gelen aramaları otomatik yanıtlar.
• Giden aramaları API ile başlatır.
• Müşteri niyetini lead skoru ile ölçer (0-10).
• Bilgi bankası üzerinden RAG destekli yanıt üretir.
• Konuşma transkriptlerini ve gecikme metriklerini gösterir.

Mimari

Telefon Araması (SIP/FreeSwitch)
        |
        v
  mod_audio_stream (WebSocket)
        |
        v
   AvaritCall Backend
        |
   +----+--------------------------+
   |                               |
   v                               v
VAD (Ses Aktivite Tespiti)     STT (Deepgram)
                                   |
                                   v
                              LLM (Groq/OpenAI/Google/Anthropic)
                                   |
                                   v
                              TTS (ElevenLabs/Cartesia/OpenAI)
                                   |
                                   v
                             Telefon Hoparlörü

Realtime Mod:
Telefon Araması -> VAD -> Realtime API (STT+LLM+TTS) -> Telefon

2. Hızlı Başlangıç

Adım 1: Hesap Oluşturma

1. avaritcall.com adresine gidin.
2. Ücretsiz Dene ile kayıt olun.
3. E-posta onay bağlantısını tamamlayın.

Adım 2: İlk Ajanı Oluşturma

1. Ajanlar menüsüne gidin.
2. Yeni Ajan Oluştur ile profil açın.
3. İsim verin ve sistem promptunuzu tanımlayın.

Sen bir mobilya mağazasının müşteri hizmetleri temsilcisisin.
Adın "Aylin". Sıcak ve yardımsever bir tonla konuşuyorsun.
Müşterilere ürünler, fiyatlar ve teslimat hakkında bilgi veriyorsun.
Randevu almak isteyen müşterileri ilgili departmana yönlendiriyorsun.

Adım 3: Model ve Ses Seçimi

• Hızlı ve ekonomik: Groq llama-3.3-70b + ElevenLabs TR ses.
• Yüksek kaliteli: OpenAI gpt-4.1-mini + ElevenLabs.
• Anlık: OpenAI Realtime gpt-4o-realtime-preview.

Adım 4: Test Araması

1. Ajan editöründen Test Ara butonuna tıklayın.
2. Mikrofon izinlerini onaylayın.
3. Transkripti sol alttaki panelden izleyin.

Adım 5: Sonuçları Görüntüleme

Aramalar sayfasından transkript, lead skoru, maliyet ve gecikme metriklerini arama bazlı takip edin.

3. Ajan Yapılandırması

Bu bölüm, sesli ajan davranışlarını üretim kalitesinde kontrol edebilmeniz için temel ve gelişmiş ayarların tamamını kapsar.

3.1 Genel Ayarlar

3.2 Model Seçimi

LLM Karşılaştırması

Realtime Modlar

• Temperature: 0.0-1.0 (müşteri hizmetleri için 0.7 önerilir).
• Maksimum token: Telefon görüşmelerinde genelde 200-400 arası yeterlidir.

3.3 Ses Seçimi

TTS Sağlayıcıları

Türkçe Sesler (ElevenLabs)

Türkçe Sesler (Cartesia)

Ses hızı eşlemesi: 1.0 normal, 1.1-1.2 hafif hızlı, 0.9 netlik odaklı.

3.4 Konuşma Ayarları (STT)

3.5 Sistem Prompt Rehberi

Sistem prompt ajan kimliğini, görevini, sınırlarını ve çıkış davranışlarını tanımlar.

[KIMLIK]
Sen [şirket adı]'nın [pozisyon] temsilcisisin. Adın [isim].

[GÖREV]
Temel görevin: [ana sorumluluklar]

[DAVRANIŞLAR]
- [İstenilen davranış 1]
- [İstenilen davranış 2]

[SINIRLAR]
- [Konuşmaman gereken konu 1]
- Müşteriyi uygunsuz içerikle yanıtlama

[ÇIKIŞLAR]
- Randevu almak isteyen müşterileri şu şekilde işle: ...
- Şikayet eden müşterileri şuraya yönlendir: ...

İyi Prompt Örnekleri

Sen Dent Klinik'in danışmanı Selin'sin.
Hastaların randevu almasına yardımcı oluyorsun.
Mevcut saatleri sor, adı soyadı ve telefon numarasını al.
Acil diş ağrısı için aynı gün randevu ver, diğerleri için 3 gün sonrasını öner.
Sigorta soru için "0850 XXX XX XX" numarasını yönlendir.

Sen TechStore müşteri hizmetlerisin. Adın Mert.
Sipariş numarası sorarak durumu kontrol ediyorsun.
İade talebi için e-posta adresi al ve 3-5 iş günü bildir.
Teknik sorunlar için destek@techstore.com'a yönlendir.

Değişken Kullanımı

Sistem prompt içinde {{değişken_adı}} formatı desteklenir.

Sen {{şirket_adı}} temsilcisisin.
Çalışma saatlerimiz {{çalışma_saatleri}}.

3.6 Bilgi Bankası

Bilgi bankası RAG (Retrieval Augmented Generation) ile soruya en yakın içerik parçalarını çekerek yanıt üretimini güçlendirir.

Desteklenen Kaynak Türleri

Bilgi Politikası

Bilgi Enjeksiyonu özelliği tek bir belgeyi (yaklaşık 10 sayfaya kadar) doğrudan prompta bağlayarak fiyat listesi/SSS gibi kısa içeriklerde kesinlik sağlar.

3.7 Gelişmiş Özellikler

Arka Plan Sesi

• WAV/MP3 yükleyip ortam sesi tanımlayabilirsiniz.
• Seviye önerisi: 0.05 - 0.15.

Arayan Tanıma (Caller Lookup)

{
  "customer_name": "Ahmet Yılmaz",
  "last_purchase": "2024-01-15",
  "total_orders": 5
}

Bu veri prompt içine {{caller_info}} ile aktarılır ve kişiselleştirilmiş konuşma akışı sağlanır.

Fonksiyonlar (Tools)

• Randevu uygunluğu API kontrolü
• Stok sorgulama
• CRM güncelleme

Fonksiyonlar JSON Schema ile tanımlanır, HTTP API çağrıları desteklenir.

Konuşma Davranışları

4. Arama Analitikleri

Lead Skoru (0-10)

Her aramanın sonunda yapay zeka, konuşma kalitesini ve niyetini skorlar.

Puanlama Faktörleri

• Satın alma niyeti kelimeleri: +40%
• Konuşma süresi ve katılım: +25%
• Soru sorma davranışı: +15%
• Aciliyet kelimeleri: +10%
• Red/ilgisizlik kelimeleri: -30%

Bildirimler

Eşik skorunu aşan aramalarda anlık bildirim için: Ajanlar → Ajan Seç → Özellikler → Bildirimler ve eşik değerini örneğin 7.5 yapın.

Transkript ve Gecikme Metrikleri

Arama detayı ekranında tur bazlı STT/LLM/TTS gecikmeleri ve kullanılan RAG parçaları görüntülenir.

5. SIP Entegrasyonu

AvaritCall FreeSWITCH tabanlıdır ve SIP uyumlu PBX sistemleri ile trunk entegrasyonunu destekler.

DID Yönlendirme

1. Ajanlar menüsünde ajan seçin.
2. SIP sekmesine geçin.
3. Trunk host/port/kullanıcı bilgilerini girin.
4. DID numarasını eşleyip test araması yapın.

SIP Trunk Alanları

Giden Arama (Outbound) Örneği

curl -X POST https://avaritcall.com/api/v1/calls/outbound \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "uuid-of-your-agent",
    "to_number": "+905551234567",
    "caller_id": "+905559876543"
  }'

6. API Referansı

Authentication

Tüm API çağrılarında Authorization: Bearer {api_key} header'ı zorunludur.

API Key oluşturma yolu: Sol Menü → API Anahtarları → Yeni Anahtar

Endpoint Grupları

Ajanlar (Profiller)

GET    /api/v1/profiles
POST   /api/v1/profiles
GET    /api/v1/profiles/{id}
PUT    /api/v1/profiles/{id}
DELETE /api/v1/profiles/{id}

Aramalar

GET    /api/v1/calls
GET    /api/v1/calls/{id}
GET    /api/v1/calls/{id}/turns
POST   /api/v1/calls/outbound
POST   /api/v1/calls/{id}/hangup

Örnek Call Yanıtı

{
  "id": "uuid",
  "direction": "inbound",
  "caller_number": "+905551234567",
  "status": "completed",
  "duration_sec": 45.2,
  "total_cost_usd": 0.0023,
  "lead_score": 7.8,
  "call_label": "hot",
  "caller_name": "Ahmet",
  "avg_latency_ms": 620,
  "turn_count": 6,
  "started_at": "2026-02-19T14:30:00Z"
}

Bildirimler

GET    /api/v1/notifications
GET    /api/v1/notifications/unread-count
PUT    /api/v1/notifications/{id}/read
PUT    /api/v1/notifications/read-all
GET    /api/v1/notifications/settings/{profile_id}
PUT    /api/v1/notifications/settings/{profile_id}

Krediler & Faturalama

GET    /api/v1/billing/credits/balance
GET    /api/v1/billing/credits/history
GET    /api/v1/billing/pricing
GET    /api/v1/billing/status

Sağlık Kontrolleri

GET    /api/v1/health
GET    /api/v1/stats
GET    /api/v1/tts/voices
GET    /api/v1/tts/sample

Webhook'lar

Arama tamamlanma/başarısızlık eventleri için webhook tetikleyebilirsiniz.

curl -X POST https://avaritcall.com/api/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://yourapp.com/webhooks/calls",
    "events": ["call.completed", "call.failed"],
    "secret": "your-webhook-secret"
  }'

Webhook Payload Örneği

{
  "event": "call.completed",
  "timestamp": "2026-02-19T14:35:00Z",
  "data": {
    "call_id": "uuid",
    "profile_id": "uuid",
    "duration_sec": 45.2,
    "lead_score": 7.8,
    "caller_name": "Ahmet",
    "transcript": []
  }
}

8. Fiyatlandırma

AvaritCall kredi bazlı çalışır. 1 kredi = $0.01.

Örnek Arama Maliyeti (3 dk Türkçe)

STT Fiyatları

TTS Fiyatları

LLM Fiyatları

Realtime Fiyatları