Lead ve CRM (Leads & CRM) node'ları

Bu rehberde: Müşteri adaylarını oluşturan, güncelleyen, arayan, bilgilerini tamamlayan ve CRM'e aktaran kutuları öğrenirsiniz. Tekilleştirme kuralları burada.

⏱ 10 dakika

Kısaca#

Bu kutular müşteri adayı (lead) veritabanınızla çalışır. Yapay zekâ kullanmazlar; maliyetleri yoktur (yalnızca Zenginleştir Hunter/Apollo kredisi harcar). Lead ajanları aynı işleri araçlarla yapar; bu kutular kuralları sizin belirlediğiniz akışlar içindir.

Teknik ayrıntılar#

Lead node'ları organizasyonunuzun lead veritabanıyla çalışır: oluşturma (tekilleştirmeli), güncelleme, sorgulama, zenginleştirme ve dış CRM'lere aktarma. Lead ajanları (Researcher, Qualifier, Outreach) aynı veriyi araçlarla kullanır; bu node'lar deterministik akışlar için uygundur.

Lead durumları#

NEW → RESEARCHING → QUALIFIED → CONTACTED → REPLIED → MEETING → CONVERTED, herhangi bir noktadan DISQUALIFIED. Skor 0-100, scoreReason metni. Ayrıntı: Lead pipeline.

Lead alanları: id, name, email, phone, company, website, title, status, score, scoreReason, tags[], source, notes, socials { linkedin, instagram, x }, industry, companySize, country, assignedToId, lastContactedAt, createdAt, updatedAt, özel alanlar custom.*.

Create / upsert lead (leads.create)#

Lead oluşturur; email, phone veya website eşleşirse mevcut kaydı günceller (upsert). lead.created (yeni) veya lead.updated olayı yayınlanır.

Çıktı: item + leadId, isNew, lead (tam kayıt). Boş email, phone ve website ile gelen item'lar tekilleştirilemediği için her zaman yeni lead oluşturur; formda en az birini zorunlu tutun.

Örnek – webhook'tan lead:

trigger.webhook → leads.create
  mapping:
    name:    {{ $json.body.fullName }}
    email:   {{ $json.body.email }}
    phone:   {{ $json.body.phone }}
    company: {{ $json.body.company }}
    message: {{ $json.body.message }}      ← custom.message
  source: website
  tags: [inbound, {{ $json.query.utm_campaign ?? "organic" }}]

Update lead (leads.update)#

Durum QUALIFIED olursa lead.qualified, REPLIED olursa lead.replied olayı yayınlanır. Çıktı: güncel lead.

Örnek: ai.classify (input {{ $json.text }}, categories [interested, not_now, unsubscribe]) → interested → leads.update (status REPLIED, addTags [hot], note "Yanıt: {{ $json.text }}"); unsubscribe → leads.update (addTags [unsubscribed], note "Opt-out").

Find leads (leads.query)#

Filtreye uyan lead'leri getirir; her lead ayrı item. Hiç sonuç yoksa downstream node'lar SKIPPED olur.

Proje filtresi iş akışının projesidir. Çıktı item'ı lead kaydının kendisidir ({{ $json.email }}, {{ $json.score }}).

Örnek – 14 gün temas edilmemiş nitelikli lead'lere takip:

trigger.schedule (0 10 * * 2) → leads.query (status [QUALIFIED, CONTACTED], minScore 70, notContactedDays 14, limit 30)
→ logic.loop (batchSize 5)
   loop → agent.outreach (channel email, offer {{ $vars.offer }}, sequenceSteps 1, requireApproval true)
   done → utility.report (type OUTREACH_SUMMARY, title "Takip turu {{ $today }}")

Enrich lead (leads.enrich)#

Hunter veya Apollo ile e-posta, şirket büyüklüğü, sektör ve sosyal profilleri bulur; hesap seçimi denetçi panelinden. Lead kaydı varsa (leadId) alanlar doldurulur.

Çıktı: item + email, emailConfidence (0-100), emailVerified, companyName, companySize, industry, country, socials { linkedin, x, instagram }, enrichmentSource. Her çağrı sağlayıcı kredisi tüketir; logic.filter ({{ !$json.email }}) ile yalnızca e-postası olmayanları zenginleştirin.

Örnek: leads.query (status [NEW]) → logic.filter ({{ !$json.email && $json.website }}) → leads.enrich → leads.update (leadId {{ $json.id }}, status RESEARCHING, note "Zenginleştirildi: {{ $json.enrichmentSource }}").

Sync to CRM / Sheet (leads.crmSync)#

Lead item'larını dış sisteme yazar (upsert; e-posta anahtar). Tek yönlüdür (OrqLabs → dış sistem).

Hedefe göre varsayılan eşleme:

Çıktı: item + synced: true, externalId, externalUrl. Hatalar INVALID (eksik property) veya RATE_LIMIT.

Örnek – nitelenen lead'i HubSpot'a yaz:

trigger.event (lead.qualified, filter {{ $json.score >= 70 }})
→ leads.crmSync (hesap: HubSpot)
   mapping:
     firstname: {{ $json.name.split(" ")[0] }}
     lastname:  {{ $json.name.split(" ").slice(1).join(" ") }}
     email:     {{ $json.email }}
     company:   {{ $json.company }}
     agentflow_score: {{ $json.score }}
     hs_lead_status: OPEN

Ayrıntı: CRM senkronizasyonu ve dışa aktarma.

İpuçları ve sınırlar#

• Tekilleştirme öncelik sırası: email → phone → website. Aynı şirketten iki kişi aynı website ile gelirse ikinci kişi ilkini günceller; kişi bazlı lead'lerde e-posta veya telefon zorunlu tutun.
• Lead node'ları LLM kullanmaz, maliyeti yoktur; zenginleştirme sağlayıcı kredisi harcar.
• leads.query en fazla 500 item döndürür; büyük listelerde logic.loop ile parti parti işleyin.
• İçe/dışa aktarma için CSV uç noktaları: POST /orgs/:orgId/leads/import, GET /orgs/:orgId/leads/export.
• KVKK/GDPR: kişisel veriyi yalnızca meşru menfaat veya açık rıza ile işleyin; silme talebinde DELETE /orgs/:orgId/leads/:id ve CRM tarafında ayrıca silme gerekir.

Sık sorulan sorular#

Aynı kişi iki kez eklenir mi? Hayır. E-posta, telefon veya web sitesi eşleşirse mevcut kayıt güncellenir.

CRM'deki değişiklikler geri gelir mi? Hayır; CRM'e yaz tek yönlüdür. Ters yön için webhook tetikleyicisi kullanın.

Zenginleştirme ücretli mi? Hunter veya Apollo kredisi harcar. Önce Süz ile yalnızca eksik olanları seçin.

Sonraki adım#

• Lead Researcher
• Lead Qualifier
• Outreach Agent
• Hunter
• Apollo
• HubSpot