استخدم n8n لتشغيل Tomba تلقائيًا ضمن سير عمل، وهو مجموعة من الخطوات تعمل من تلقاء نفسها. فمثلًا، عند وصول جهة اتصال جديدة، يمكن لـ n8n العثور على بريدها الإلكتروني والتحقق منه.
وn8n أداة مستقلة لسير العمل. يمكنك استخدام n8n Cloud، أو تشغيلها على خادمك الخاص. ويتولى Tomba تطوير عقدة Tomba وصيانتها. والعقدة هي خطوة واحدة في سير عمل n8n.
قبل أن تبدأ
تحتاج إلى حساب n8n، ويجب أن تكون مالكًا أو مسؤولًا فيه لتثبيت عقدة Tomba.
تحتاج إلى مفتاح API والمفتاح السري في Tomba. وهما رمزان خاصان يتيحان لتطبيق آخر استخدام حسابك في Tomba.
ربط Tomba بـ n8n
تنفّذ ذلك في n8n، وليس في Tomba. فالبطاقة N8n في صفحة Integrations لا تفتح سوى دليل إعداد تقني، لذا يمكنك تجاوزها.
الخطوة 1. في Tomba، افتح API في القائمة اليسرى وانسخ مفتاحك ومفتاحك السري. وللمساعدة، راجع كيف أجد مفتاح API الخاص بي؟.
الخطوة 2. في n8n، افتح سير عمل ثم افتح لوحة العقد. ابحث عن Tomba، وحدد العقدة ضمن More from the community، ثم انقر على Install. ولا تحتاج إلى ذلك إلا مرة واحدة لحساب n8n بأكمله.
الخطوة 3. افتح عقدة Tomba واترك Authentication مضبوطًا على API Key.
الخطوة 4. ضمن Credential to connect with، أنشئ بيانات اعتماد Tomba API. وبيانات الاعتماد هي الطريقة التي تخزّن بها n8n بيانات تسجيل دخولك إلى تطبيق ما. أدخل API Key وAPI Secret.
الخطوة 5. اختر Resource، ثم Operation. فمثلًا، اختر Email، ثم Email Finder.
الخطوة 6. اربط العقدة بالخطوات الأخرى في سير العمل، واختبرها، ثم فعّل سير العمل.
💡 نصيحة: إذا كنت تشغّل n8n على خادمك الخاص، يمكنك أيضًا تثبيت العقدة من Settings > Community Nodes. أدخل n8n-nodes-tomba كاسم للحزمة.
ما يمكن لـ Tomba فعله في n8n
توجد عقدة Tomba واحدة تضم 45 عملية، والعمليات هي المهام التي يمكنها تنفيذها. وهي مجمّعة حسب المورد:
المورد | العمليات |
Domain | Domain Search, Domain Status, Autocomplete, Location, Similar, Technology |
Email Finder, Email Verifier, Email Enrichment, Email Count, Email Sources, Email Format | |
Finder | Author Finder, LinkedIn Finder |
Phone | Phone Finder, Phone Validator |
Company | Search Companies |
Enrichment | Person, Company, Combined |
Lead, Lead List, Lead Attribute | List, Get, Create, Update, Delete |
Key | List, Get, Create, Reset, Delete |
Account | Account, Usage, Logs |
Flag | List, Create |
مثال: العثور على جهة اتصال جديدة والتحقق منها
البداية: استخدم نموذجًا أو صفًا في جدول بيانات يتضمن الاسم الأول واسم العائلة وموقع الشركة الإلكتروني.
Tomba > Email > Email Finder: املأ Domain وFirst Name وLast Name من الخطوة 1.
Tomba > Email > Email Verifier: اضبط Email على البريد الإلكتروني الناتج عن الخطوة 2.
If: تابع فقط عندما تكون النتيجة
deliverable، أي أن الرسائل يُفترض أن تصل إلى هذا البريد الإلكتروني.
💳 الأرصدة: تكلفة كل عملية هي نفسها تكلفة إجراء ذلك البحث في Tomba. في هذا المثال، يُخصم لكل جهة اتصال رصيد بحث واحد عند العثور على بريد إلكتروني، ورصيد تحقق واحد للتحقق منه.
⚠️ مهم: في Domain Search، يُحتسب Return All على أنه 100 نتيجة، أي 10 من أرصدة البحث. كما أنه يفشل في الخطة Free. ولتقليل الإنفاق، اضبط Limit على 10 أو 20 أو 50 بدلًا من ذلك.
الأسئلة الشائعة
لماذا لا أجد Tomba في لوحة العقد؟
ربما تكون العقد المجتمعية الموثّقة معطّلة في n8n لديك، وهي المجموعة التي تنتمي إليها عقدة Tomba. في n8n Cloud، يفعّلها المالك من Cloud Admin Panel. ويجب أيضًا أن تكون مالكًا أو مسؤولًا لتثبيت عقدة.
لماذا فشل اختبار بيانات الاعتماد؟
مفتاحك أو مفتاحك السري غير صحيح، أو انتهت صلاحية المفتاح. فلكل مفتاح تاريخ انتهاء صلاحية. انسخ كليهما من جديد من API Keys، وأنشئ مفتاحًا جديدًا إذا انتهت صلاحية مفتاحك.
لماذا توقف Email Finder مع ظهور خطأ؟
على الأرجح أن أحد الحقول فارغ. لا تضع n8n علامة «مطلوب» على هذه الحقول، لكن Email Finder يحتاج إليها: Domain أو Company، بالإضافة إلى Full Name أو كلٍّ من First Name وLast Name.
لماذا لا يظهر عميلي المحتمل الجديد في قائمته؟
هذه مشكلة معروفة في Lead > Create: فقد يصل العميل المحتمل دون اسم وخارج قائمته. أضف العميل المحتمل إلى القائمة بنفسك في Leads.
للمطورين: راجع وثائق Tomba.
مقالات ذات صلة