Kampanyalar: toplu giden arama

Kampanya, tek bir asistanı aynı anda yüzlerce aramaya çeviren yapıdır. Asistan aynı kalır; kampanya kuyruğu, eşzamanlılığı, tekrarları ve raporlamayı üstlenir.

Bir kampanyanın parçaları

1. 1Asistan — aramada ne söyleneceğini belirler, ayrı yapılandırılır.
2. 2Arayan numara — hangi numaradan çıkılacağı.
3. 3Kişi listesi — CSV ile bir kerede yüklenir ya da zamanla eklenir.
4. 4Çalışma ayarları — eşzamanlılık, dakikadaki arama sayısı, tekrar kuralları.

Kampanya draft (taslak) durumunda oluşur. Kişileri ekleyip başlat aksiyonunu vermeden hiçbir arama yapılmaz.

CSV formatı

phone_number,name,company
+905551234567,Ahmet Yılmaz,ABC Ltd
+905559876543,Zeynep Demir,XYZ A.Ş.
+902121234567,Mehmet Kaya,Kaya İnşaat

Zorunlu tek kolon phone_number ve E.164 formatında olmalı: başında + ve ülke kodu. Türkiye için +90 ile başlar, baştaki 0 yazılmaz — +905551234567 doğru, 05551234567 yanlış.

Diğer tüm kolonlar dinamik değişken olarak aramada kullanılabilir. Asistanın talimatında {{name}} yazarsanız ilk satırda "Ahmet Yılmaz", ikinci satırda "Zeynep Demir" olur.

API ile kampanya

# 1. Kampanyayı oluştur (taslak olarak açılır)
curl -X POST https://api.call2me.app/v1/campaigns \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "name": "Mayıs geri arama listesi",
    "from_number": "+908501234567",
    "max_concurrent": 10,
    "calls_per_minute": 10,
    "retry_count": 2,
    "retry_delay_minutes": 30
  }'

# 2. Kişileri CSV ile yükle
curl -X POST https://api.call2me.app/v1/campaigns/camp_xyz/upload-csv \
  -H "Authorization: Bearer sk_live_..." \
  -F "[email protected]"

# 3. Başlat
curl -X POST https://api.call2me.app/v1/campaigns/camp_xyz/action \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"action": "start"}'

Çalışma ayarları

Yüksek eşzamanlılık kampanyayı hızlandırır ama üç şey gerektirir: yeterli numara kapasitesi, işlem gücü (50 eşzamanlı arama 50 ses oturumu demektir) ve operatörünüzün izin verdiği hız sınırı.

Tekrar kuralları

Her kişinin bir durumu vardır: pending, dialing, completed, failed, busy, no-answer. Tekrar yalnızca failed, busy ve no-answer durumlarına uygulanır. Bir kişi completed olduğunda ya da tekrarları tükendiğinde nihai kabul edilir.

Zaman penceresi

Bireysel tüketiciye yapılan kampanyalarda kabul edilebilir saatler dışında arama yapılmaması için pencere tanımlayın. Kampanya bu pencereye tekrarlarda da uyar — akşam 20:00’de hata alan bir numara ertesi sabah 09:00’a kadar bekler.

{
  "allowed_hours": { "start": "09:00", "end": "20:00" },
  "timezone": "Europe/Istanbul",
  "skip_weekends": true
}

Canlı izleme

• Kuyruk boyutu ve ilerleme çubuğu.
• Canlı sayaçlar: tamamlandı / başarısız / meşgul / cevap yok.
• Ortalama süre ve o ana kadarki toplam maliyet.
• Biten aramaların dökümü ve kayıt bağlantıları, tamamlandıkça listeye düşer.

Aynı ekrandan istediğiniz an duraklatabilir, devam ettirebilir veya durdurabilirsiniz. Duraklat kuyruğu korur, yeni arama başlatmaz; durdur ise yürüyen her şeyi iptal eder.

Ne kadar sürer, ne kadar tutar

Sonuçları veriye çevirmek

Kampanyayı arama sonrası veri çıkarımıyla birleştirdiğinizde her arama yapılandırılmış bir satıra dönüşür. Alanları bir kez asistanda tanımlarsınız (ilgi_seviyesi, geri_arama_gerekli, itiraz_sebebi) ve her kampanya araması bu alanlar dolu bir JSON kaydı üretir. Sonuçlar sekmesinden CSV olarak alınır.