n8n, Make ve Web Form ile Lead Webhook’u

Hazır bir entegrasyonu olmayan her kaynaktan lead’i Purvisor’a sokmanın en kısa yolu: tek bir HTTP isteği. n8n akışından, Make senaryosundan ya da doğrudan kendi web formundan /api/n8n/incoming-lead adresine bir POST at — Purvisor kontağı saniyeler içinde oluşturur, yapay zeka asistanını atar ve (istersen) mesai saatine göre otomatik aramayı planlar. Lead’i 5 dakikada aramak, 30 dakika sonra aramaya göre kat kat daha yüksek dönüşüm sağlar; bu webhook o pencereyi otomatikleştirir.

Nasıl çalışır?

n8n / Make / Web formu / Google Ads lead formu
        ↓  (HTTP POST + x-api-key başlığı)
POST /api/n8n/incoming-lead
        ↓
Purvisor kontağı oluşturur (ad, telefon, e-posta, form_data)
        ↓
Otomatik arama açıksa → mesai penceresine göre planlanır
        ↓
Yapay zeka asistanı lead'i arar → görüşme → analiz + (varsa) kadans takibi

“Purvisor lead formumu görmüyor, akış nasıl kurulacak?” — Purvisor kaynağa bakmaz; sen kaynağı bu webhook’a bağlarsın. n8n/Make bir “HTTP Request” düğümüyle, web formu ise sunucu tarafı bir istekle payload’u gönderir. Mantık tek yönlü ve basittir.

Ön koşullar

• n8n API anahtarı (N8N_API_KEY) — isteği yetkilendiren gizli anahtar. Purvisor tarafında tanımlıdır; senin akışında x-api-key başlığına konur.
• Purvisor’da hazır bir outbound asistan (İlk Asistanını Oluştur) ve onun assistant_id’si.
• Otomatik arama yapılacaksa bağlı bir telefon numarası (SIP trunk) — arama bu numaradan çıkar (Telefon Numarası (SIP)).
• Lead’i sahiplenecek Purvisor hesabının user_id’si (ya da otomatik çözümleme için page_id/form_id).

Uç nokta

Payload alanları

{
  "source": "website",
  "user_id": "1",
  "assistant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "campaign_id": "123",
  "cadence_id": "45",
  "auto_call": true,
  "delay_minutes": 5,
  "lead": {
    "full_name": "Ahmet Yılmaz",
    "phone": "+905321234567",
    "email": "ahmet@ornek.com",
    "company": "ABC Ltd",
    "title": "Satın Alma Müdürü",
    "form_data": { "ilgilenilen_urun": "Isı pompası", "butce": "50000" }
  }
}

Kurulum

curl -X POST https://PANEL_ALAN_ADIN/api/n8n/incoming-lead \
  -H "x-api-key: $N8N_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "website",
    "user_id": "1",
    "assistant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "auto_call": true,
    "delay_minutes": 5,
    "lead": {
      "full_name": "Ahmet Yılmaz",
      "phone": "+905321234567",
      "email": "ahmet@ornek.com",
      "company": "ABC Ltd",
      "form_data": { "ilgilenilen_urun": "Isı pompası" }
    }
  }'

{
  "success": true,
  "contact_id": "12345",
  "phone": "+905321234567",
  "name": "Ahmet Yılmaz",
  "source": "website",
  "auto_call": true,
  "auto_call_scheduled_at": "2026-07-12T14:05:00.000Z",
  "deferred_to_business_hours": false,
  "delay_minutes": 5
}

Mesai saatleri ve zamanlama

Otomatik arama, kontrolsüz gece aramalarını önlemek için mesai penceresine göre planlanır. Bu webhook için pencere sabittir:

Akış şöyle işler: arama zamanı şimdi + delay_minutes olarak hesaplanır. Bu an mesai içindeyse arama o zamana planlanır (deferred_to_business_hours: false). Mesai dışındaysa (gece, Pazar, saat 19:00 sonrası) arama bir sonraki iş gününün 09:00’ına ertelenir ve yanıtta deferred_to_business_hours: true döner.

Bu erteleme otomatiktir; payload’da bir mesai anahtarı yoktur. Farklı bir pencere gerekiyorsa delay_minutes ile ince ayar yapabilir, ya da form-bazlı mesai ayarları sunan Meta Lead Ads entegrasyonunu kullanabilirsin.

Aynı kişi tekrar tekrar aranır mı?

Hayır. Aynı hesapta, aynı telefona (numaranın son 10 hanesine göre) ait aktif bir kontak zaten varsa, yeni kayıt oluşturulmaz — mevcut kontak güncellenir. Bu durumda yanıt reused: true içerir. Ayrıca lead son 10 dakika içinde alınmışsa yeni bir arama planlanmaz; bu, aynı formun iki kez gönderilmesi gibi durumlarda çift aramayı engeller.

Durum kodları

Bu uç nokta webhook kovasında hız sınırına (rate limit) tabidir; çok sık istek atarsan geçici olarak sınırlanabilirsin. Sınır ve hata sözleşmesi için Limitler ve Hatalar.

KVKK notu

Otomatik arama, kişisel veri (telefon) işleme ve iletişim anlamına gelir. Web formunda ya da lead kaynağında topladığın açık rıza, “sizi telefonla arayabiliriz” kapsamını da içermeli. Rıza yoksa auto_call: false gönderip önce manuel değerlendirme yapmak daha güvenlidir. Asistanının prompt’unda açılışta kim olduğunu ve neden aradığını net söylediğinden emin ol — “Web sitemizden teklif istemiştiniz” gibi bağlam, hem dönüşümü hem uyumu güçlendirir.

Sorun giderme

İlgili