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

نظرة عامة

مكّن وكلاءك من إدارة الشركات وجهات الاتصال داخل HubSpot. أنشئ سجلات جديدة وبسّط عمليات CRM باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

المتطلبات الأساسية

قبل استخدام تكامل HubSpot، تأكد من توفر ما يلي:

إعداد تكامل HubSpot

1. ربط حساب HubSpot الخاص بك

  1. انتقل إلى تكاملات CrewAI AMP.
  2. ابحث عن HubSpot في قسم تكاملات المصادقة.
  3. انقر على Connect وأكمل عملية OAuth.
  4. امنح الصلاحيات اللازمة لإدارة الشركات وجهات الاتصال.
  5. انسخ رمز المؤسسة من إعدادات التكامل

2. تثبيت الحزمة المطلوبة

3. إعداد متغير البيئة

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.
أو أضفه إلى ملف .env:

الإجراءات المتاحة

الوصف: إنشاء سجل شركة جديد في HubSpot.المعاملات:
  • name (string, مطلوب): اسم الشركة.
  • domain (string, اختياري): اسم نطاق الشركة.
  • industry (string, اختياري): القطاع.
  • phone (string, اختياري): رقم الهاتف.
  • hubspot_owner_id (string, اختياري): معرّف مالك الشركة.
  • type (string, اختياري): نوع الشركة. القيم المتاحة: PROSPECT, PARTNER, RESELLER, VENDOR, OTHER.
  • city (string, اختياري): المدينة.
  • state (string, اختياري): الولاية/المنطقة.
  • zip (string, اختياري): الرمز البريدي.
  • numberofemployees (number, اختياري): عدد الموظفين.
  • annualrevenue (number, اختياري): الإيرادات السنوية.
  • description (string, اختياري): الوصف.
  • website (string, اختياري): عنوان URL للموقع الإلكتروني.
الوصف: إنشاء سجل جهة اتصال جديد في HubSpot.المعاملات:
  • email (string, مطلوب): عنوان البريد الإلكتروني لجهة الاتصال.
  • firstname (string, اختياري): الاسم الأول.
  • lastname (string, اختياري): اسم العائلة.
  • phone (string, اختياري): رقم الهاتف.
  • hubspot_owner_id (string, اختياري): مالك جهة الاتصال.
  • lifecyclestage (string, اختياري): مرحلة دورة الحياة. القيم المتاحة: subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, evangelist, other.
  • company (string, اختياري): اسم الشركة.
  • jobtitle (string, اختياري): المسمى الوظيفي.
الوصف: إنشاء سجل صفقة جديد في HubSpot.المعاملات:
  • dealname (string, مطلوب): اسم الصفقة.
  • amount (number, اختياري): قيمة الصفقة.
  • dealstage (string, اختياري): مرحلة مسار الصفقة.
  • pipeline (string, اختياري): مسار المبيعات الذي تنتمي إليه الصفقة.
  • closedate (string, اختياري): التاريخ المتوقع لإغلاق الصفقة.
  • hubspot_owner_id (string, اختياري): مالك الصفقة.
  • dealtype (string, اختياري): نوع الصفقة. القيم المتاحة: newbusiness, existingbusiness.
  • description (string, اختياري): وصف الصفقة.
  • hs_priority (string, اختياري): أولوية الصفقة. القيم المتاحة: low, medium, high.
الوصف: إنشاء تفاعل جديد (مثل ملاحظة، بريد إلكتروني، مكالمة، اجتماع، مهمة) في HubSpot.المعاملات:
  • engagementType (string, مطلوب): نوع التفاعل. القيم المتاحة: NOTE, EMAIL, CALL, MEETING, TASK.
  • hubspot_owner_id (string, اختياري): المستخدم المعيّن للنشاط.
  • hs_timestamp (string, اختياري): تاريخ ووقت النشاط.
  • hs_note_body (string, اختياري): نص الملاحظة. (يُستخدم لـ NOTE)
  • hs_task_subject (string, اختياري): عنوان المهمة. (يُستخدم لـ TASK)
  • hs_meeting_title (string, اختياري): عنوان الاجتماع. (يُستخدم لـ MEETING)
الوصف: تحديث سجل شركة موجود في HubSpot.المعاملات:
  • recordId (string, مطلوب): معرّف الشركة المراد تحديثها.
  • name (string, اختياري): اسم الشركة.
  • domain (string, اختياري): اسم نطاق الشركة.
  • industry (string, اختياري): القطاع.
  • phone (string, اختياري): رقم الهاتف.
  • description (string, اختياري): الوصف.
الوصف: تحديث سجل جهة اتصال موجود في HubSpot.المعاملات:
  • recordId (string, مطلوب): معرّف جهة الاتصال المراد تحديثها.
  • firstname (string, اختياري): الاسم الأول.
  • lastname (string, اختياري): اسم العائلة.
  • email (string, اختياري): عنوان البريد الإلكتروني.
  • phone (string, اختياري): رقم الهاتف.
  • company (string, اختياري): اسم الشركة.
  • jobtitle (string, اختياري): المسمى الوظيفي.
الوصف: تحديث سجل صفقة موجود في HubSpot.المعاملات:
  • recordId (string, مطلوب): معرّف الصفقة المراد تحديثها.
  • dealname (string, اختياري): اسم الصفقة.
  • amount (number, اختياري): قيمة الصفقة.
  • dealstage (string, اختياري): مرحلة مسار الصفقة.
  • closedate (string, اختياري): تاريخ الإغلاق المتوقع.
الوصف: الحصول على قائمة بسجلات الشركات من HubSpot.المعاملات:
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: الحصول على قائمة بسجلات جهات الاتصال من HubSpot.المعاملات:
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: الحصول على قائمة بسجلات الصفقات من HubSpot.المعاملات:
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: الحصول على سجل شركة واحد بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف الشركة المراد استرجاعها.
الوصف: الحصول على سجل جهة اتصال واحد بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف جهة الاتصال المراد استرجاعها.
الوصف: الحصول على سجل صفقة واحد بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف الصفقة المراد استرجاعها.
الوصف: البحث عن سجلات الشركات في HubSpot باستخدام صيغة فلتر.المعاملات:
  • filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: البحث عن سجلات جهات الاتصال في HubSpot باستخدام صيغة فلتر.المعاملات:
  • filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: البحث عن سجلات الصفقات في HubSpot باستخدام صيغة فلتر.المعاملات:
  • filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
  • paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.
الوصف: حذف سجل شركة بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف الشركة المراد حذفها.
الوصف: حذف سجل جهة اتصال بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف جهة الاتصال المراد حذفها.
الوصف: حذف سجل صفقة بواسطة معرّفه.المعاملات:
  • recordId (string, مطلوب): معرّف الصفقة المراد حذفها.
الوصف: الحصول على المخطط المتوقع لنوع كائن وعملية معينة.المعاملات:
  • recordType (string, مطلوب): معرّف نوع الكائن (مثال: ‘companies’).
  • operation (string, مطلوب): نوع العملية (مثال: ‘CREATE_RECORD’).

أمثلة الاستخدام

إعداد Agent أساسي لـ HubSpot

تصفية أدوات HubSpot المحددة

إدارة جهات الاتصال

الحصول على المساعدة

تحتاج مساعدة؟

تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل HubSpot أو استكشاف الأخطاء وإصلاحها.