TL;DR: Inbound lead'leri ajanlarla zenginleştirmek için, kaydolan her kullanıcının e-postasını ve alan adını bir ajan çalıştırmasını başlatan webhook'a iletin. Ajan; People Data Labs üzerinden kişiyi, Apollo üzerinden şirketi zenginleştirir, ismi yaptırım listelerine karşı tarar, sonucu ICP'nize göre puanlar ve lead başına bir görev açar. Yanıt gönderilmeden önce nitelikli her lead bir insan tarafından incelenir. Böylece kullanıcı lisansı (seat) başına değil, lead başına Firecrawl kredisiyle ödeme yaparsınız.
Yeni bir kayıt geldiğinde elinizde iki kullanışlı veri bulunur: bir e-posta adresi ve bir şirket alan adı. Birinin bu verileri bir karara dönüştürmesi gerekir: Karşınızdaki kişi potansiyel bir alıcı mı, bir öğrenci mi, bir rakip mi yoksa yasal olarak iş yapamayacağınız biri mi?
Geleneksel çözüm, lead'leri sınıflandıran herkes için veri zenginleştirme aracında ayrı bir kullanıcı lisansı (seat) satın almaktır. Apollo lisans başına faturalandırma yapar ve fiyatlandırma sayfasında bir hesaptaki tüm lisansların tek bir planı paylaştığı belirtilir. İncelemeleri insanlar yaparken bu yaklaşım mantıklıdır. Ancak bu aramaları bir ajan yürüttüğünde, sonuçları okuyan kişinin bir lisansa hiç ihtiyacı kalmaz.
Bu kılavuz, çalışma ortamı (runtime) olarak Claude Code veya Codex'i, veri katmanı olarak ise Firecrawl Alexandria'yı kullanarak bu iş akışını Sharkly üzerinde kurar. Aşağıda listelenen tüm kredi fiyatları, Firecrawl'un 3 Kasım 2026 tarihindeki güncel fiyatlarıdır. Bu yazı için canlı bir lead çalıştırılmadığından, toplam tutarları örnek hesaplamalar olarak değerlendirin ve entegrasyonu kurmadan önce playground üzerinden fiyatları mutlaka kontrol edin.
Inbound lead'leri neden ajanlarla zenginleştirmelisiniz?
Inbound lead zenginleştirme, ekibiniz bir adaya vakit ayırmadan önce yeni bir iletişim kişisinin unvanını, şirketini ve firmanıza uygunluğunu otomatik olarak belirlemek anlamına gelir. Bir ajan bu sorgulamaları çalıştırabilir, kurallarınızı uygulayabilir ve tek paragraflık bir özet metin hazırlayabilir. Kimin yanıt alacağına dair nihai kararı ise bir insan verir.
Aramaları ajan devraldığında üç temel unsur değişir:
- Faturalandırma lead sayısına göre yapılır. Tek bir Firecrawl API anahtarı tüm veri sağlayıcılarını kapsar. Her sorgunun liste fiyatı belirlenmiştir ve aşağıda listelenen sağlayıcılarda eşleşmeyen aramalar için hiçbir ücret ödenmez.
- Kurallar birer kod dosyasına dönüşür. ICP kriterleriniz bir incelemecinin hafızasında değil, ajanın her çalıştırmada okuduğu, daha önce denetlenmiş bir dosyada yer alır.
- Her lead aynı denetimlerden geçer. Günün 40. kaydı da ilk kayıtla tamamen aynı yaptırım taramasından geçirilir.
Inbound zenginleştirme ardışık düzenine (pipeline) genel bakış
| Adım | Sağlayıcı ve yetenek | Liste fiyatı | Ücretsiz olduğu durum |
|---|---|---|---|
| 1. Webhook çalıştırmayı başlatır | Sharkly Automation | 0 kredi | Her zaman |
| 2. Kişi verisini zenginleştirme | People Data Labs person/enrich |
60 kredi | Eşleşme min_likelihood değerinin altında kaldığında (404) |
| 3. Şirket verisini zenginleştirme | Apollo companies/bulk-enrich |
Eşleşen şirket başına 30 kredi | Alan adı eşleşmediğinde |
| 4. Yaptırım listesi taraması | OpenSanctions (opensanctions-org) |
find-tools ile kontrol edin |
Asla varsayımda bulunmayın |
| 5. Puanlama ve yönlendirme | Kural dosyanız | 0 kredi | Her zaman |
Adım 1: Webhook zenginleştirme çalıştırmasını başlatır
Sharkly'de bir Automation, tekrarlanabilir işleri tek bir Agent'a veya Crew'a devreden, Space'e ait bir kuraldır. Tetikleyici türlerinden biri webhook'tur: Başka bir servis tarafından gönderilen POST isteklerini kabul eden gizli bir URL. Kayıt backend'iniz yeni gelen lead'i bu adrese gönderir.
# From your signup handler. The URL is a secret; keep it in your app's env.
curl -X POST "$SHARKLY_LEAD_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"signup_id": "su_10482", "email": "[email protected]", "domain": "example-corp.com"}'
Sharkly bu URL'nin tamamını tetikleyiciyi ilk oluşturduğunuzda veya yeniden ürettiğinizde yalnızca bir kez gösterir. Sonrasında tetikleyici kartında yalnızca URL'nin etkin olduğu belirtilir. İsteklerin imza doğrulamasından geçmesini sağlamak için bir imzalama parolası (signing secret) da ekleyebilirsiniz.
Tasarımı belirleyen önemli bir detay şudur: Bir Automation bir görev (task) değil, bir ajan çalıştırması (run) başlatır. Bu nedenle verilen talimatlar, süreci tamamlayan ajana lead görevini çalıştırmanın sonunda bizzat oluşturmasını söyler. Çalıştırma ayrıntıları tetikleyici yükünü (payload) saklar; böylece her lead için nelerin geldiğine dair tam bir kayıt tutulmuş olur.
Adım 2: E-posta adresiyle kişi verisini zenginleştirme
People Data Labs'in person/enrich yeteneği çağrı başına 60 kredi olarak listelenmiştir. Girdi olarak yalnızca bir email yeterlidir. Harcamanızı belirleyen ana ayar, 1 ile 10 arasında değişen ve varsayılan olarak 2 gelen min_likelihood değeridir. Bu değeri yükselttiğinizde, zayıf eşleşmeler bir veri kaydı yerine 404 döner. Firecrawl'un sağlayıcı sayfasında bu durum çok net ifade edilir: "burada 404 ücretsizdir, yanlış bir kayıt ise değildir."
// enrich-lead.mjs: one call per signup, key injected as $FIRECRAWL_API_KEY
const call = (alexandria) =>
fetch("https://api.firecrawl.dev/v2/scrape", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ alexandria }),
}).then((r) => r.json());
const person = await call({
provider: "people-data-labs",
capability: "person/enrich",
options: { email: lead.email, min_likelihood: 6, titlecase: true },
});
const p = person.alexandria?.[0];
if (p?.error) brief.errors.push(p.error); // check every result before using it
Dönen kayıt yaklaşık 150 alan içerir; oluşturacağınız özet için bunlardan beşi yeterlidir. Yer tutucu değerlerle ajanın ayırdığı kısım şu şekilde görünür:
{
"full_name": "Jordan Example",
"job_title": "Director Of Platform Engineering",
"job_company_name": "Example Corp",
"linkedin_url": "linkedin.com/in/placeholder",
"likelihood": 8
}
Kullanım kotanızı da yakından takip edin. Alexandria aracılığıyla People Data Labs, müşteri organizasyonu başına hem kişi hem de şirket uç noktaları toplamında yıllık 50.000 API çağrısına izin verir. Yeniden denemeler (retry) kotadan düşer ve kota her yıl 1 Ocak UTC tarihinde sıfırlanır.
Adım 3: Alan adı üzerinden şirket verisini zenginleştirme
Apollo'nun şirket verileri; yatırım turlarını, çalışan sayısını ve kullanılan teknolojileri kapsar. Firecrawl'un kendi örneğinde, çağrı başına on adede kadar alan adı kabul eden companies/bulk-enrich yeteneği kullanılır. Firecrawl'un Ekim 2026 karşılaştırmasında bu işlem, eşleşen şirket başına 30 kredi olarak listelenirken, eşleşmeyen alan adları ücretsizdir.
const company = await call({
provider: "apollo",
capability: "companies/bulk-enrich",
options: { "domains[]": [lead.domain] },
});
const org = company.alexandria?.[0]?.data?.organizations?.[0];
// org.name, org.estimated_num_employees, funding and technology fields
Apollo'nun Alexandria sayfasında "CRM account data refresh" (CRM hesap verisi yenileme) adında yerleşik bir yetenek (skill) listelenir. Bu yetenek, alan adına göre hesapları yeniden zenginleştirir ve yeni değerleri CRM'de mevcut olanlarla karşılaştırır. Bu, yeni kayıtlar yerine mevcut hesaplarınıza yönlendirilmiş aynı API çağrısıdır.
Adım 4: Lead'i yaptırım listesine karşı tarama
Alexandria'daki People kategorisi; yaptırımlar, PEP (Siyasi Nüfuz Sahibi Kişiler) ve ilgilenilen şahıslar veritabanı olan OpenSanctions'ın yanı sıra Birleşik Krallık Yaptırım Listesi'ni de içerir. Keşif (discovery) ücretsizdir; bu yüzden ilk ücretli çağrıyı yapmadan önce ajanın tarama yeteneğini ve maliyetini bulmasını sağlayın:
firecrawl find-tools --options '{"providers": ["opensanctions-org"]}' --include-costs
OpenSanctions'ın veri kümesi (dataset) yeteneği çalıştırma başına 5 kredi olarak görünür. Varlık aramasının (entity search) da aynı maliyette olacağını varsaymayın; find-tools komutunun döndürdüğü güncel fiyatı okuyun. Ayrıca lisansı da kontrol edin: OpenSanctions verilerini CC BY-NC 4.0 altında yayımlar ve ticari amaçlı taramalar için ayrı lisanslar satar. Bu nedenle ticari bir lead akışında doğru lisansa sahip olmanız gerekir.
Bir eşleşmenin bulunması, ajanın lead'i doğrudan reddedeceği anlamına gelmez. Bu durum, görevin eşleşme ayrıntısıyla birlikte incelenmek üzere bir insana yönlendirileceği anlamına gelir.
Adım 5: Lead'i ICP kriterlerinize göre puanlama
Puanlama işlemi tamamen ücretsizdir çünkü zaten satın aldığınız alanları okur. Kuralları bir Sharkly Skill dosyasına yerleştirin; böylece her çalıştırma aynı dosyayı okur ve bu dosyada yapılacak değişiklikler denetimden geçer.
# inbound-icp.md (owner: head of sales)
qualify_if: employees >= 50 AND title in [Director, VP, Head, CTO] AND sanctions_match == false
nurture_if: employees < 50 OR title not senior
disqualify_if: free_email_domain OR known_competitor_domain
on_sanctions_match: route to Sales review with the match, never auto-reply
brief_fields: [name, title, company, employees, funding, score, reason, credits_spent]
Lead'i pano üzerinde yönlendirme
Sharkly asıl değerini yönlendirme aşamasında gösterir. Görev durumları görev türüne göre yapılandırılabilir ve her durum sabit bir kategoriye aittir. Lead süreçleri için üç durum yeterlidir:
| Durum | Kategori | Atanan kişi | Sonraki adım |
|---|---|---|---|
| Sales review | Unstarted | Bir kişi | Görev içindeki özet ve yanıt taslağı gönderilmeden önce incelenir |
| Nurture | Backlog | Kimse | İlerideki bir kampanya için bekletilir |
| Disqualified | Canceled | Kimse | Gerekçesiyle saklanır, başka bir çalıştırma yapılmaz |
Ajan, görevi çalıştırmasının son adımı olarak oluşturur:
sharkly task create \
--title "Lead: Example Corp (Director Of Platform Engineering)" \
--body-file brief.md \
--status "Sales review" \
--assignee <member> --output json
Atanan görev, ilgili kişinin Inbox bölümüne birincil (Primary) bir sinyal olarak düşer. Ajan ilk yanıtı taslak olarak hazırlamışsa, bu taslak görevin gövdesinde yer alır. Ajan bu yanıtı asla kendisi göndermez. Bu onay mekanizması, döngüde insanın bulunduğu kodlama ajanları rehberimizde anlattığımız yaklaşımla tamamen aynıdır.
Lead başına kredi dökümü
Her iki zenginleştirmenin de eşleştiği tek bir lead için liste fiyatları şu şekilde hesaplanır:
| Çağrı | Kredi |
|---|---|
People Data Labs person/enrich |
60 |
Apollo companies/bulk-enrich (1 eşleşen alan adı) |
30 |
| Yaptırım taraması | find-tools çıktısındaki fiyat |
| Puanlama ve yönlendirme | 0 |
| Tarama öncesi toplam | 90 |
Firecrawl fiyatlandırmasına göre Hobby planı ayda 5.000 kredi için 19 dolardır; yani kredi başına 0,0038 dolar. Bu durumda 90 kredi, lead başına 0,342 dolara denk gelir. Standard planı ise 100.000 kredi için 99 dolardır; yani kredi başına 0,00099 dolar. Böylece aynı lead yalnızca 0,0891 dolara mal olur. gmail.com gibi ücretsiz e-posta sağlayıcılarının alan adları için şirket sorgusu çağrısını atlayın; aksi takdirde Google'ın çalışan sayısını öğrenmek için gereksiz yere 30 kredi ödersiniz.
Ayda eşleşen 100 lead için 9.000 kredi harcarsınız. Bu, Hobby planının 5.000 kredisini aşacağı için ek kredi satın almanız veya Standard plana geçmeniz gerekir. Bir plan seçmeden önce bu hesabı kendi iş hacminize göre yapın.
Kullanıcı lisansı karşılaştırmasına dair bir not: Apollo kullanıcı lisansı (seat) başına faturalandırır. Clay ise böyle çalışmaz; fiyatlandırma sayfasında her planda çalışma alanı başına sınırsız kullanıcı sunduğu belirtilir. Buradaki temel argüman "lisanslar kötüdür" demekten ibaret değildir. Aramaları ajanlar yaptığında faturalandırma, sonuçları okuyan insan sayısına göre değil, işlenen lead sayısına göre gerçekleşir.
Sharkly iş akışını nasıl bir arada tutar?
API çağrılarını Claude Code veya Codex yürütür. Sharkly ise tüm bu iş sürecinin görünür ve takip edilebilir kalmasını sağlar.
- API anahtarları görevlerin dışında tutulur.
FIRECRAWL_API_KEYdeğerini Ajanın Ortam Değişkenleri (Environment Variables) altına tanımlayın. Sharkly bu düz metin ayarları Ajan yöneticilerine görünür kıldığından, yalnızca bu işe özgü sınırlandırılmış bir anahtar kullanın. - Ajanlar kullanıcı lisansı (seat) kaplamaz. Sharkly'de bir lisans gerçek bir insana aittir. Ajanlar, Crew'lar, Bilgisayarlar ve Çalışma Zamanları (Runtimes) lisans kotasını doldurmaz.
- Çalıştırmalar kayıt altında tutulur. Automation çalıştırma geçmişi; tetikleyici yükünü, ajan çalıştırmasını ve varsa hata nedenlerini eksiksiz gösterir.
Webhook'u canlıya almadan önce Automation üzerinde bir test yüküyle Run now seçeneğini kullanın. Otomatik taslak yanıtları eklemeden önce birkaç çalıştırmayı bizzat inceleyin. Her tetikleyici türünün ayrıntıları Automations kılavuzunda açıklanmaktadır.
Tek bir webhook ile başlayın
Inbound lead'leri ajanlarla zenginleştirmeye küçük adımlarla başlayın: Tek bir webhook, tek bir ajan, iki zenginleştirme çağrısı, bir kural dosyası ve bir inceleme durumu. Bu yapıyı sıradaki 20 kaydınızda deneyin ve ekibiniz yanıt vermeden önce hazırlanan her özeti dikkatle okuyun. Sharkly'yi kullanmaya başlamak ücretsizdir; model kullanımı ise halihazırda Runtime'ınıza bağlı olan Claude Code veya Codex planınız üzerinden karşılanır.
Sıkça Sorulan Sorular
Firecrawl ile bir inbound lead'i zenginleştirmek ne kadara mal olur?
Firecrawl'un liste fiyatlarıyla, hem People Data Labs hem de Apollo'da eşleşen bir lead, yaptırım taraması hariç 90 krediye mal olur. Bu da aylık faturalandırmada Hobby planında yaklaşık 0,34 dolara, Standard planında ise 0,09 dolara denk gelir.
Başarısız bir veri zenginleştirme kredi harcar mı?
Bu iki sağlayıcıda harcamaz. People Data Labs'te belirlediğiniz min_likelihood değerinin altındaki bir eşleşme ücretsiz 404 döner; Apollo'nun toplu şirket zenginleştirmesi ise eşleşmeyen alan adları için ücret almaz.
Ajan lead'e kendi başına yanıt verebilir mi?
Bunu yapmasına izin vermemelisiniz. Ajan görevi bir taslak yanıtla birlikte kaydeder ve yanıt ancak bir insan incelemesinden geçtikten sonra gönderilir.
OpenSanctions ticari kullanım için ücretsiz mi?
Hayır. Verileri CC BY-NC 4.0 lisansına tabidir ve ticari taramalar için ücretli lisanslarından birinin alınması gerekir. Satış akışınıza dahil etmeden önce bu konuyu mutlaka netleştirin.
Bunun için bir Apollo kullanıcı lisansına (seat) ihtiyacım var mı?
Ajanın çağrıları Firecrawl anahtarınız üzerinden çalıştığı için bir Apollo lisansına ihtiyaç yoktur. Ancak Firecrawl, önce bir organizasyon yöneticisinin sağlayıcının veri koşullarını kabul etmesini isteyebilir; bu durumdaki hata kodu THIRD_PARTY_DATA_TERMS_REQUIRED şeklindedir.
Firecrawl çalıştırmanın ortasında koşulların kabul edilmesini isterse ne olur?
Dönen yanıtta bir requiresAction.url adresi yer alır. Organizasyon yöneticisi ilgili koşulları bu adres üzerinden kabul eder. Firecrawl dokümantasyonu, ajanların koşulları kabul etmeden önce açık kullanıcı onayına ihtiyaç duyduğunu belirtir; bu nedenle ajan bu görevi bir insanın onaylaması için beklemede bırakmalıdır.
