إنتقل إلى المحتوى الرئيسي

تكاملات البيانات والإنتاجية

سجّل كل عميل محتمل في جدول بيانات أو قاعدة بيانات أو نقطة نهاية API الخاصة بك. اضبط الإعدادات من الإعدادات ← التكاملات.

Google Sheets​

إضافة صف جديد في Google Sheet لكل عميل محتمل يدخل LeadHub.

الخطوة 1 — إنشاء مشروع Google Cloud​

  1. انتقل إلى console.cloud.google.com.
  2. انقر New Project وسمّه LeadHub.
  3. ابحث عن Google Sheets API وفعّله، وفعّل أيضًا Google Drive API.

الخطوة 2 — إنشاء بيانات اعتماد OAuth​

  1. في Cloud Console، انتقل إلى APIs & Services ← Credentials.
  2. انقر Create Credentials ← OAuth client ID.
  3. اضبط Application Type على Web application.
  4. أضف https://yourdomain.com/oauth/google-sheets/callback كـ Authorized redirect URI.
  5. انسخ Client ID وClient Secret.

الخطوة 3 — إعداد Google Sheet​

  1. أنشئ جدول بيانات Google جديدًا.
  2. أضف رؤوس الأعمدة في الصف الأول.
  3. انسخ Spreadsheet ID من الرابط.

الخطوة 4 — الضبط في LeadHub​

  1. انتقل إلى الإعدادات ← التكاملات ← Google Sheets.
  2. أكمل الحقول وانقر Connect with Google.

Notion​

إنشاء صفحة جديدة (إدخال قاعدة بيانات) في قاعدة بيانات Notion لكل عميل محتمل.

الخطوة 1 — إنشاء تكامل Notion​

  1. انتقل إلى notion.so/my-integrations.
  2. انقر + New integration وأعطه اسمًا.
  3. انسخ Internal Integration Token.

الخطوة 2 — مشاركة قاعدة البيانات مع التكامل​

  1. افتح قاعدة البيانات ← انقر Share ← ابحث عن تكاملك ← Invite.

الخطوة 3 — الحصول على معرف قاعدة البيانات​

انسخ Database ID من رابط URL (السلسلة المكونة من 32 حرفًا قبل علامة ?).

الخطوة 4 — الضبط في LeadHub​

  1. انتقل إلى الإعدادات ← التكاملات ← Notion.
  2. أكمل الحقول وانقر حفظ واختبار.

Airtable​

إضافة سجل جديد في قاعدة Airtable لكل عميل محتمل.

الخطوة 1 — الحصول على مفتاح API والتفاصيل​

  1. انتقل إلى airtable.com/account وأنشئ Personal Access Token.
  2. احصل على Base ID من الرابط.
  3. دوّن Table Name.

الخطوة 2 — الضبط في LeadHub​

  1. انتقل إلى الإعدادات ← التكاملات ← Airtable.
  2. أكمل الحقول وانقر حفظ واختبار.

Generic Webhook​

إرسال بيانات العميل المحتمل إلى أي رابط URL — خادمك الخاص أو دالة بلا خادم أو أي نقطة نهاية تقبل طلبات HTTP POST.

الخطوة 1 — إعداد نقطة النهاية​

يجب أن تقبل نقطة نهايتك:

  • طلبات HTTP POST
  • Content-Type: application/json
  • إعادة كود HTTP 2xx عند النجاح

الخطوة 2 — الضبط في LeadHub​

  1. انتقل إلى الإعدادات ← التكاملات ← Generic Webhook.
  2. أكمل Webhook URL والـ Secret Key (اختياري) وانقر حفظ واختبار.

بنية الحمولة​

{
  "event": "lead.created",
  "id": "lead_01HXZ3...",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "phone": "+1 555 000 1234",
  "company": "Acme Corp",
  "source": "facebook_lead_ads",
  "pipeline": "Sales",
  "stage": "New",
  "score": 72,
  "tags": ["webinar", "hot"],
  "custom_fields": {},
  "created_at": "2025-06-15T14:23:00Z"
}

REST API Push​

إرسال بيانات العميل المحتمل إلى نقطة نهاية RESTful مع إمكانية ضبط طريقة HTTP والرؤوس وتعيين الحقول.

الخطوة 1 — تحديد نقطة نهاية API​

تحتاج إلى:

  • رابط نقطة النهاية الكامل
  • طريقة HTTP: POST أو PUT أو PATCH
  • أي رؤوس مصادقة مطلوبة

الخطوة 2 — الضبط في LeadHub​

  1. انتقل إلى الإعدادات ← التكاملات ← REST API Push.
  2. أكمل الحقول وانقر حفظ واختبار.

استكشاف الأخطاء وإصلاحها​

المشكلةالحل
خطأ OAuth في Google Sheetsتأكد من تطابق redirect URI تمامًا بما في ذلك https://
"object not found" في Notionالتكامل غير مشارك مع قاعدة البيانات — راجع الخطوة 2
عدم تطابق حقول Airtableأسماء الحقول حساسة لحالة الأحرف — تحقق من الأسماء الدقيقة
Webhook يُعيد 4xxتأكد من أن نقطة نهايتك تقبل Content-Type: application/json