Otomatik Arama (IVR Kampanyaları)

Anket, borç hatırlatma, duyuru veya onay alma gibi amaçlarla toplu dış arama kampanyaları oluşturun.

Kampanya Oluşturma

POST https://api.bulutsantralim.com/ivr_campaigns.json
Content-Type: application/json

Parametreler

Parametre	Zorunlu	Açıklama
name	Evet	Kampanya adı
call_type	Evet	queue (kuyruğa aktar) veya ivr (tuşlama menüsü)
phone_list	Evet	Aranacak numaralar dizisi: [{"phone": "905001234567"}]
cli	Evet	Arayan numara (karşı tarafın göreceği)
welcome_announcement_id	Hayır	Dinletilecek ses dosyası ID'si
queue_number	Hayır	call_type=queue ise hedef kuyruk
thread_multiplier	Hayır	Müsait temsilci sayısının kaç katı kadar çağrı açılacağı
max_thread_count	Hayır	Eşzamanlı maksimum çağrı sayısı
ring_timeout	Hayır	Çaldırma süresi (25–60 sn)
call_retries	Hayır	Cevap vermeyenler için tekrar arama sayısı
date_range_begin	Hayır	Kampanya başlangıç tarihi (YYYY-MM-DD)
date_range_end	Hayır	Kampanya bitiş tarihi (YYYY-MM-DD)
time_range_begin	Hayır	Günlük çalışma saati başlangıcı (SS:DD)
time_range_end	Hayır	Günlük çalışma saati bitişi (SS:DD)
active_days	Hayır	Çalışma günleri (1=Pzt … 7=Paz): [1,2,3,4,5]
webhook_url	Hayır	Tuşlamaların bildirileceği URL
digit_target_1 … digit_target_9	Hayır	Tuşa basıldığında yönlendirilecek hedef
digit_target_star	Hayır	* tuşu hedefi
digit_target_square	Hayır	# tuşu hedefi
timeout_target	Hayır	Süre dolduğunda yönlendirilecek hedef
digit_retries	Hayır	Geçersiz tuşlamada tekrar sayısı
digit_timeout	Hayır	Tuşlama bekleme süresi (1–10 sn, varsayılan 4)
recording_enabled	Hayır	true → arama başlar başlamaz kayıt alınır
is_commercial	Hayır	Ticari ileti ise true
iys_recipient_type	Hayır	BIREYSEL / TACIR (ticari gönderimde zorunlu)

Örnek

{
  "name": "Borç Hatırlatma - Ocak",
  "call_type": "ivr",
  "cli": "908505320000",
  "ring_timeout": 30,
  "call_retries": 2,
  "time_range_begin": "09:00",
  "time_range_end": "18:00",
  "active_days": [1, 2, 3, 4, 5],
  "welcome_announcement_id": 42,
  "digit_target_1": "queue:destek",
  "digit_target_2": "hangup",
  "phone_list": [
    { "phone": "905001234567" },
    { "phone": "905007654321" }
  ]
}

---

Kampanya Başlatma / Durdurma

PATCH https://api.bulutsantralim.com/ivr_campaigns/{id}.json

{ "status": "start" }

status değerleri: start, pause, stop

---

Kampanya Silme

DELETE https://api.bulutsantralim.com/ivr_campaigns/{id}.json

curl -X DELETE "https://api.bulutsantralim.com/ivr_campaigns/123.json?key=API_ANAHTARINIZ"