باختصار: لإثراء بيانات العملاء المحتملين الواردين (Inbound Leads) باستخدام الوكلاء، أرسل البريد الإلكتروني والنطاق الخاصين بكل عملية تسجيل إلى خطاف ويب (webhook) يبدأ تشغيل الوكيل. يقوم الوكيل بإثراء بيانات الشخص عبر People Data Labs، وبيانات الشركة عبر Apollo، ويفحص الاسم مقابل قائمة العقوبات، ويقيّم النتيجة وفقاً لملف العميل المثالي (ICP) الخاص بك، ثم ينشئ مهمة واحدة لكل عميل محتمل. بعد ذلك يراجع شخص بشري كل عميل محتمل مؤهل قبل أن يتولى أي شخص الرد عليه. وتُسدد التكلفة لكل عميل محتمل برصيد Firecrawl، وليس لكل مقعد مستخدم.
يصل التسجيل ومعه حقلان مفيدان: بريد إلكتروني ونطاق الشركة. ويتعين على شخص ما تحويل ذلك إلى قرار: هل هذا المتقدم مشترٍ محتمل، أم طالب، أم منافس، أم اسم يُحظر التعامل معه قانونياً؟
الحل المعتاد هو شراء مقعد على أداة إثراء بيانات لكل شخص يتولى فرز العملاء المحتملين. تفرض Apollo رسومها لكل مقعد، وتشير صفحة الأسعار لديها إلى أن جميع المقاعد في الحساب تتشارك خطة واحدة. وهذا أمر منطقي عندما يتولى البشر عمليات البحث، ولكن عندما يقوم بها وكيل ذكاء اصطناعي، فإن الشخص الذي يطلع على النتيجة لا يحتاج إلى مقعد على الإطلاق.
يشرح هذا الدليل كيفية بناء هذا المسار على Sharkly، باستخدام Claude Code أو Codex كبيئة تشغيل، وFirecrawl Alexandria كطبقة للبيانات. جميع أسعار الرصيد المذكورة أدناه هي الأسعار المعلنة لدى Firecrawl كما وردت في 3 نوفمبر 2026. لم نقم بتشغيل عميل محتمل فعلي في هذا المقال، لذا تعامل مع الأرقام الإجمالية كأمثلة عملية وتأكد من الأسعار في بيئة التجربة (playground) قبل ربط أي شيء.
لماذا يجب إثراء بيانات العملاء المحتملين الواردين باستخدام الوكلاء؟
يعني إثراء بيانات العملاء المحتملين الواردين استكمال معلومات جهة الاتصال الجديدة مثل المسمى الوظيفي والشركة ومدى الملاءمة قبل أن يستهلك أي موظف وقته فيها. يستطيع الوكيل إجراء عمليات البحث، وتطبيق قواعدك، وصياغة ملخص من فقرة واحدة، بينما يظل القرار النهائي بشأن من يتلقى رداً بيد العنصر البشري.
تتغير ثلاثة أمور أساسية عندما يتولى الوكيل عمليات البحث:
- تعتمد الفوترة على عدد العملاء المحتملين: يغطي مفتاح Firecrawl واحد جميع المزودين. وتخضع كل عملية بحث لسعر محدد من الرصيد، كما أن عمليات البحث التي لا تسفر عن مطابقة لدى المزودين المذكورين أدناه لا تكلف شيئاً.
- تتحول القواعد إلى ملف: تصبح مواصفات العميل المثالي (ICP) محفوظة في ملف مراجع يقرأه الوكيل في كل تشغيل، بدلاً من بقائها في ذهن المراجع.
- يخضع كل عميل محتمل لنفس الفحوصات: يخضع التسجيل الأربعون في اليوم لفحص العقوبات تماماً كالتسجيل الأول.
نظرة عامة على مسار إثراء بيانات العملاء الواردين
| Step | Provider and capability | Listed price | Free when |
|---|---|---|---|
| 1. خطاف الويب يبدأ التشغيل | Sharkly Automation | 0 credits | دائماً |
| 2. إثراء بيانات الشخص | People Data Labs person/enrich |
60 credits | تقل احتمالية التطابق عن min_likelihood (رمز 404) |
| 3. إثراء بيانات الشركة | Apollo companies/bulk-enrich |
30 credits لكل شركة متطابقة | لا يتطابق النطاق |
| 4. الفحص مقابل قائمة العقوبات | OpenSanctions (opensanctions-org) |
يُتحقق منها عبر find-tools |
لا تفترض ذلك أبداً |
| 5. التقييم والتوجيه | ملف القواعد الخاص بك | 0 credits | دائماً |

الخطوة 1: خطاف الويب يبدأ عملية الإثراء
في Sharkly، تُعد الأتمتة (Automation) قاعدة مملوكة لمساحة العمل (Space) تسند المهام المتكررة إلى وكيل (Agent) أو طاقم عمل (Crew). ويُعد خطاف الويب (webhook) أحد أنواع المشغلات المتاحة: وهو رابط URL سري يستقبل طلبات POST من خدمة أخرى، حيث ترسل الواجهة الخلفية لنظام التسجيل لديك بيانات العميل المحتمل الجديد إليه.
# 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 عنوان URL الكامل مرة واحدة فقط، وذلك عند إنشاء المشغّل أو إعادة إنشائه. بعد ذلك، تكتفي بطاقة المشغّل بالإشارة إلى أن الرابط نشط. ويمكنك أيضاً إضافة سر توقيع (signing secret) لإلزام الطلبات باجتياز التحقق من التوقيع.

هناك تفصيل محدد يحدد معالم هذا التصميم: تبدأ الأتمتة تشغيل وكيل وليس مهمة مباشرة. لذا توجه التعليمات الوكيل لإنشاء مهمة العميل المحتمل بنفسه في نهاية المطاف. وتحتفظ تفاصيل التشغيل بحمولة المشغّل (trigger payload)، مما يوفر لكل عميل محتمل سجلاً بالبيانات الواردة.
الخطوة 2: إثراء بيانات الشخص من البريد الإلكتروني
تُدرج إمكانية person/enrich من People Data Labs بسعر 60 رصيداً لكل استدعاء. ويُعد حقل email وحده مدخلاً كافياً. أما الإعداد الذي يتحكم في نفقاتك فهو min_likelihood، الذي تتراوح قيمته بين 1 و10 وتكون قيمته الافتراضية 2. فإذا رفعت هذه القيمة، فإن التطابقات الضعيفة ستعيد رمز الخطأ 404 بدلاً من إرجاع سجل. وتوضح صفحة المزود في Firecrawl ذلك بصراحة: "رمز 404 مجاني هنا، أما السجل غير الصحيح فليس مجانياً".
// 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
يتضمن السجل نحو 150 حقلاً، بينما يحتاج ملخصك إلى خمسة حقول فقط منها. مع استخدام قيم نائبة، يبدو الجزء الذي يحتفظ به الوكيل على هذا النحو:
{
"full_name": "Jordan Example",
"job_title": "Director Of Platform Engineering",
"job_company_name": "Example Corp",
"linkedin_url": "linkedin.com/in/placeholder",
"likelihood": 8
}
انتبه أيضاً إلى الحصة المحددة (quota)؛ فمن خلال Alexandria، تسمح People Data Labs بـ 50,000 استدعاء لواجهة برمجة التطبيقات سنوياً لكل مؤسسة عبر نقاط نهاية الأشخاص والشركات. وتُحسب محاولات إعادة الطلب ضمن هذه الحصة، ويُعاد ضبطها في 1 يناير بالتوقيت العالمي المنسق (UTC).
الخطوة 3: إثراء بيانات الشركة من النطاق
تغطي بيانات الشركات في Apollo مجالات التمويل، وعدد الموظفين، والتقنيات المستخدمة. يستخدم مثال Firecrawl نفسه إمكانية companies/bulk-enrich، والتي تستقبل ما يصل إلى عشرة نطاقات في كل استدعاء. وتُدرج مقارنة Firecrawl لشهر أكتوبر 2026 تكلفتها عند 30 رصيداً لكل شركة متطابقة، مع بقاء النطاقات غير المتطابقة مجانية دون رسوم.
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 على Alexandria مهارة مدمجة تُسمى "تحديث بيانات حسابات إدارة علاقات العملاء (CRM)". وهي تعيد إثراء بيانات الحسابات حسب النطاق وتقارن القيم الجديدة بما هو مسجل بالفعل في نظام CRM. هذا هو الاستدعاء نفسه، ولكنه موجه نحو حساباتك الحالية بدلاً من التسجيلات الجديدة.
الخطوة 4: فحص العميل المحتمل مقابل قائمة العقوبات
تتضمن فئة الأشخاص (People) في Alexandria قاعدة بيانات OpenSanctions، وهي قاعدة بيانات للعقوبات، والشخصيات المعرضة سياسياً (PEP)، والأشخاص محل الاهتمام، بالإضافة إلى قائمة العقوبات البريطانية. وتُعد عملية الاستكشاف مجانية، لذا اجعل الوكيل يبحث عن إمكانية الفحص وسعرها قبل إجراء أول استدعاء مدفوع:
firecrawl find-tools --options '{"providers": ["opensanctions-org"]}' --include-costs
تُظهر إمكانية مجموعات البيانات في OpenSanctions تكلفة قدرها 5 أرصدة لكل تشغيل. لا تفترض أن البحث عن الكيانات يكلف المقدار نفسه؛ بل تحقق من السعر الذي ترجعه أداة find-tools. وتأكد من الترخيص أيضاً؛ إذ تنشر OpenSanctions بياناتها بموجب ترخيص CC BY-NC 4.0 وتبيع تراخيص منفصلة لفحص الأعمال، لذا يتطلب مسار العملاء التجاري الحصول على الترخيص الملائم.
لا تعني المطابقة أن يرفض الوكيل العميل المحتمل، بل تعني تحويل المهمة إلى شخص بشري مع إرفاق تفاصيل المطابقة بها.
الخطوة 5: تقييم مدى الملاءمة لملف العميل المثالي (ICP)
لا يكلف التقييم أي رصيد لأنه يقرأ حقولاً قمت بالدفع مقابلها بالفعل. ضع القواعد في Sharkly Skill، بحيث يقرأ كل تشغيل نفس الملف وتخضع أي تعديلات تطرأ عليه للمراجعة.
# 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]
توجيه العميل المحتمل على اللوحة
التوجيه هو الميزة التي تُبرز القيمة الحقيقية لمنصة Sharkly. فحالات المهام قابلة للتهيئة حسب نوع المهمة، وتنتمي كل حالة إلى فئة ثابتة. وبالنسبة للعملاء المحتملين، فإن ثلاث حالات تكفي لتغطية المسار بالكامل:
| Status | Category | Assignee | What happens next |
|---|---|---|---|
| مراجعة المبيعات (Sales review) | لم تبدأ (Unstarted) | شخص بشري | يتوفر الملخص ومسودة الرد في المهمة، وتتم مراجعتهما قبل الإرسال |
| المتابعة والتدريب (Nurture) | قائمة الانتظار (Backlog) | لا أحد | ينتظر حملة لاحقة |
| مستبعد (Disqualified) | ملغاة (Canceled) | لا أحد | يُحفظ مع تدوين السبب، دون تشغيلات أخرى |
ينشئ الوكيل المهمة كخطوة أخيرة في عملية تشغيله:
sharkly task create \
--title "Lead: Example Corp (Director Of Platform Engineering)" \
--body-file brief.md \
--status "Sales review" \
--assignee <member> --output json
يصل التكليف إلى صندوق الوارد (Inbox) الخاص بالشخص كإشعار رئيسي. وإذا قام الوكيل بصياغة مسودة الرد الأول، تظل المسودة محفوظة داخل نص المهمة ولا يقوم الوكيل بإرسالها إطلاقاً. تمثل بوابة التحقق هذه النمط ذاته الذي شرحناه في مقال وكلاء البرمجة مع وجود بشري في حلقة اتخاذ القرار (human-in-the-loop).
بيان تكلفة الرصيد لكل عميل محتمل
بالنسبة لعميل محتمل واحد تتطابق فيه كلتا عمليتي الإثراء، تُحسب الأسعار المعلنة إجمالاً على النحو التالي:
| Call | Credits |
|---|---|
People Data Labs person/enrich |
60 |
Apollo companies/bulk-enrich (نطاق متطابق واحد) |
30 |
| فحص العقوبات | السعر الناتج من find-tools |
| التقييم والتوجيه | 0 |
| الإجمالي قبل الفحص | 90 |
وفقاً لـ أسعار Firecrawl، تبلغ تكلفة خطة Hobby نحو 19 دولاراً مقابل 5,000 رصيد شهرياً، أي 0.0038 دولار لكل رصيد، مما يجعل تكلفة 90 رصيداً تعادل 0.342 دولار لكل عميل محتمل. وتبلغ تكلفة خطة Standard نحو 99 دولاراً مقابل 100,000 رصيد، أي 0.00099 دولار لكل رصيد، وبالتالي تبلغ تكلفة العميل المحتمل نفسه 0.0891 دولار. ويمكنك تخطي استدعاء الشركة لنطاقات البريد الإلكتروني المجانية مثل gmail.com؛ وإلا ستدفع 30 رصيداً فقط لمعرفة عدد موظفي Google.
عند معالجة 100 عميل محتمل متطابق شهرياً، ستستهلك 9,000 رصيد، وهو ما يتجاوز رصيد خطة Hobby البالغ 5,000، لذا سيتعين عليك شراء رصيد إضافي أو الترقية إلى خطة Standard. قم بإجراء هذه الحسابات بناءً على حجم بياناتك قبل اختيار الخطة.
تنبيه هام بشأن المقارنة القائمة على المقاعد: تفرض Apollo رسوماً لكل مقعد، بينما لا تفعل Clay ذلك؛ إذ تتيح صفحة أسعارها إضافة عدد غير محدود من المستخدمين لكل مساحة عمل في كافة الخطط. الحجة هنا أدق من مجرد مقولة "نظام المقاعد سيئ"؛ فعندما يتولى الوكلاء عمليات البحث، ترتبط الفوترة بعدد العملاء المحتملين، وليس بعدد الأشخاص الذين يطلعون على نتائجهم.
كيف تضمن Sharkly تكامل سير العمل
يتولى Claude Code أو Codex تنفيذ الاستدعاءات، بينما تجعل Sharkly العمل المحيط بهما واضحاً ومرئياً.
- يبقى المفتاح خارج المهام: عيّن
FIRECRAWL_API_KEYفي متغيرات بيئة الوكيل (Environment Variables). تصنف Sharkly هذه الإعدادات كنصوص صريحة مرئية لمديري الوكلاء، لذا استخدم مفتاحاً يقتصر نطاقه على هذه المهمة. - لا تستهلك الوكلاء أي مقاعد: في Sharkly، المقعد مخصص للأشخاص، ولا تشغل الوكلاء أو أطقم العمل (Crews) أو الحواسيب (Computers) أو بيئات التشغيل (Runtimes) أي مقعد.
- يترك كل تشغيل سجلاً موثقاً: يعرض سجل تشغيل الأتمتة حمولة المشغّل، وعملية تشغيل الوكيل، وأي سبب لحدوث خطأ.
قبل الاعتماد على خطاف الويب، استخدم خيار Run now في الأتمتة مع حمولة بيانات تجريبية. ثم راجع عدة تشغيلات قبل تفعيل الردود المصاغة تلقائياً. يغطي دليل الأتمتة كل نوع من أنواع المشغلات بالتفصيل.
ابدأ بخطاف ويب واحد
لإثراء بيانات العملاء المحتملين الواردين باستخدام الوكلاء، ابدأ بخطوات بسيطة: خطاف ويب واحد، ووكيل واحد، واستدعاءان للإثراء، وملف قواعد واحد، وحالة مراجعة واحدة. قم بتشغيل ذلك على عمليات التسجيل العشرين القادمة واقرأ كل ملخص قبل أن يرد أي شخص. التسجيل في Sharkly متاح مجاناً للبدء، ويُحتسب استخدام النماذج ضمن خطة Claude Code أو Codex المرتبطة بالفعل ببيئة التشغيل لديك.
الأسئلة الشائعة
كم تبلغ تكلفة إثراء بيانات عميل محتمل وارد واحد باستخدام Firecrawl؟
وفقاً لأسعار Firecrawl المعلنة، تبلغ تكلفة العميل المحتمل الذي يتطابق في كل من People Data Labs وApollo نحو 90 رصيداً قبل فحص العقوبات. ويعادل ذلك نحو 0.34 دولار في خطة Hobby و0.09 دولار في خطة Standard، بالفوترة الشهرية.
هل تستهلك عملية الإثراء غير الناجحة أي رصيد؟
ليس لدى هذين المزودين؛ حيث تعيد نتائج People Data Labs التي تقل عن قيمة min_likelihood المحددة رمز 404 مجاناً، كما لا تفرض خدمة إثراء الشركات المجمعة في Apollo أي رسوم على النطاقات غير المتطابقة.
هل يمكن للوكيل الرد على العميل المحتمل تلقائياً بمفرده؟
من الأفضل منعه من ذلك؛ إذ ينشئ الوكيل المهمة مرفقاً بها مسودة، بينما يتولى شخص بشري إرسال الرد بعد المراجعة.
هل منصة OpenSanctions مجانية للاستخدام التجاري؟
لا، فبياناتها منشورة بموجب ترخيص CC BY-NC 4.0، ويتطلب فحص الأعمال التجارية الحصول على أحد تراخيصها المدفوعة. تحقق من ذلك قبل دمجها في مسار المبيعات.
هل أحتاج إلى مقعد في Apollo لتنفيذ ذلك؟
لا يلزم أي مقعد لاستدعاءات الوكيل، لأنها تُنفذ عبر مفتاح Firecrawl الخاص بك. قد تطلب Firecrawl من مسؤول المؤسسة قبول شروط بيانات المزود أولاً، ويظهر الخطأ عندئذ كالتالي: THIRD_PARTY_DATA_TERMS_REQUIRED.
ماذا يحدث إذا طلبت Firecrawl الموافقة على الشروط في منتصف عملية التشغيل؟
تتضمن الاستجابة رابط requiresAction.url ليتمكن مسؤول المؤسسة من قبول الشروط من خلاله. وتشير وثائق Firecrawl إلى أن الوكلاء يحتاجون إلى تفويض صريح من المستخدم قبل قبول الشروط، لذا ينبغي للوكيل ترك المهمة قيد الانتظار لمراجعتها من قِبل شخص بشري.



