Planlı aramalar: tek seferlik ve tekrarlayan

Planlı arama, gelecekte belirli bir ana bağlanmış tek bir aramadır — ya da tekrarlayan bir seri. Teyit, hatırlatma ve takip aramaları için doğru yapı budur.

Plan oluşturma

curl -X POST https://api.call2me.app/v1/schedules \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "to_number": "+905551234567",
    "from_number": "+908501234567",
    "scheduled_at": "2026-08-20T14:30:00",
    "timezone": "Europe/Istanbul",
    "dynamic_variables": {
      "musteri_adi": "Ahmet",
      "randevu_tarihi": "21 Ağustos Cuma 14:00"
    }
  }'

• Zorunlu: agent_id, to_number, scheduled_at, timezone.
• İsteğe bağlı: from_number (boşsa varsayılan giden numaranız kullanılır), dynamic_variables (arama anında talimata yerleşir).

Tekrar

recurrence alanı eklendiğinde plan tekrarlanır. Desteklenen sıklıklar: daily, weekly, monthly.

{
  "recurrence": {
    "frequency": "weekly",
    "interval": 1,
    "days_of_week": ["monday", "wednesday", "friday"],
    "until": "2026-12-31"
  }
}

until alanı isteğe bağlıdır; verilmezse plan siz silene kadar çalışmaya devam eder.

Saat dilimi ve yaz saati

Planlar yalnızca UTC değil, saat dilimini de saklar. Bu iki nedenle önemlidir.

• Yaz saati — Europe/Istanbul için 09:00 kurulmuş bir plan yıl boyunca yerel 09:00’da çalışır, geçiş dönemlerinde kaymaz.
• Farklı ülkedeki müşteri — operatörünüz İstanbul’da, müşteriniz Berlin’deyse planı müşterinin saatine göre kurun: timezone alanına Europe/Berlin yazın.

Aramanın kendi takibini planlaması

En sık kullanılan desen: asistanın konuşma sırasında kendi takip aramasını planlaması. Arayan "yarın saat 10’da beni arayın" dediğinde bu otomatik olarak plana dönüşür. Bunun için asistanda schedule_call tipinde bir arama sonrası işlem tanımlarsınız.

{
  "type": "schedule_call",
  "condition": "geri_arama_gerekli == true",
  "config": {
    "use_field": "geri_arama_tarihi",
    "fallback_delay_minutes": 1440
  }
}

Arama geri_arama_gerekli = true ile bittiğinde platform çıkarımdan geri_arama_tarihi alanını okur ve planı kurar. Tarih eksik veya geçersizse fallback_delay_minutes devreye girer — varsayılan 1440 dakika, yani 24 saat sonra.

Durum döngüsü

Durum geçişleri panelde gerçek zamanlı görünür. API tarafında planları listelemek, yaklaşanları görmek ve çalıştırma geçmişini incelemek için ayrı uçlar var:

# Tüm planlar
curl https://api.call2me.app/v1/schedules \
  -H "Authorization: Bearer sk_live_..."

# Yaklaşan planlar
curl https://api.call2me.app/v1/schedules/upcoming \
  -H "Authorization: Bearer sk_live_..."

# Bir planın çalıştırma geçmişi
curl https://api.call2me.app/v1/schedules/sch_abc123/executions \
  -H "Authorization: Bearer sk_live_..."

# İptal
curl -X POST https://api.call2me.app/v1/schedules/sch_abc123/cancel \
  -H "Authorization: Bearer sk_live_..."

Türkiye için pratik notlar

• Bireysel müşteriye 09:00 öncesi ve 20:00 sonrası arama planlamayın; cevaplanma oranı düşer, şikâyet oranı artar.
• Randevu hatırlatmalarını randevudan bir gün önce, öğleden sonra planlayın — en yüksek cevaplanma bandı budur.
• Ticari içerikli tekrarlayan aramalarda İYS onayı gereklidir; teyit ve hatırlatma aramaları ise mevcut bir ilişkinin parçasıdır.