Lead Oluşturma — POST /leads

Reklamdan, formdan ya da bir CRM’den düşen lead’i tek istekle kaydeder ve aramayı doğru zamana planlar. POST /calls’tan farkı tam olarak budur: o uç anında arar, bu uç gecikmeyi ve yasal arama penceresini hesaba katar.

Lead’i 5 dakika içinde aramak, 30 dakika sonra aramaya göre kat kat yüksek dönüşüm verir — ama bu, gece yarısı aramak anlamına gelmez. delay_minutes ile “olabildiğince hızlı” der, gerisini Purvisor halleder.

İstek

POST /api/v1/leads
X-API-Key: pk_live_...
Content-Type: application/json

Gövde alanları

Gövde hem snake_case hem camelCase kabul eder.

Arama ne zaman yapılır?

Planlanan an, iki pencerenin kesişimidir:

1. Senin çalışma pencelen — Ayarlar → Arama Penceresi & Bölge (saat aralığı, çalışma günleri, saat dilimi).
2. Aranan kişinin yasal penceresi — numaradan çıkarılan ülkeye göre (TR mesai kuralları, ABD TCPA, Birleşik Krallık PECR).

delay_minutes sonrası bu iki pencere de açıksa arama o ana planlanır. Değilse ikisinin birden açık olduğu ilk ana ertelenir ve yanıtta deferred_to_call_window: true döner.

Mükerrer önleme

Aynı hesapta aynı numaraya ait aktif bir kişi varsa yeni kayıt açılmaz — mevcut kişi güncellenir ve yanıt existing: true içerir. Ayrıca o kişiden son 10 dakika içinde bir lead alınmışsa yeni arama planlanmaz; aynı formun iki kez gönderilmesi çift arama üretmez.

Yanıt

Yeni kayıt → 201, mevcut kayıt güncellendi → 200.

{
  "contact_id": "1042",
  "existing": false,
  "phone": "+905321234567",
  "name": "Ahmet Yılmaz",
  "source": "meta_lead_ads",
  "auto_call": true,
  "auto_call_scheduled_at": "2026-07-08T06:05:00.000Z",
  "deferred_to_call_window": false,
  "delay_minutes": 5,
  "cadence_id": "12"
}

Hata kodları

Hangi ucu kullanmalıyım?