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

نظرة عامة

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

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

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

إعداد تكامل HubSpot

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

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

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

uv add crewai-tools

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

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

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

الوصف: إنشاء سجل شركة جديد في 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

from crewai import Agent, Task, Crew

# Create an agent with HubSpot capabilities
hubspot_agent = Agent(
    role="CRM Manager",
    goal="Manage company and contact records in HubSpot",
    backstory="An AI assistant specialized in CRM management.",
    apps=['hubspot']  # All HubSpot actions will be available
)

# Task to create a new company
create_company_task = Task(
    description="Create a new company in HubSpot with name 'Innovate Corp' and domain 'innovatecorp.com'.",
    agent=hubspot_agent,
    expected_output="Company created successfully with confirmation"
)

# Run the task
crew = Crew(
    agents=[hubspot_agent],
    tasks=[create_company_task]
)

crew.kickoff()

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

from crewai import Agent, Task, Crew

# Create agent with specific HubSpot actions only
contact_creator = Agent(
    role="Contact Creator",
    goal="Create new contacts in HubSpot",
    backstory="An AI assistant that focuses on creating new contact entries in the CRM.",
    apps=['hubspot/create_contact']  # Only contact creation action
)

# Task to create a contact
create_contact = Task(
    description="Create a new contact for 'John Doe' with email 'john.doe@example.com'.",
    agent=contact_creator,
    expected_output="Contact created successfully in HubSpot."
)

crew = Crew(
    agents=[contact_creator],
    tasks=[create_contact]
)

crew.kickoff()

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

from crewai import Agent, Task, Crew

# Create agent with HubSpot contact management capabilities
crm_manager = Agent(
    role="CRM Manager",
    goal="Manage and organize HubSpot contacts efficiently.",
    backstory="An experienced CRM manager who maintains an organized contact database.",
    apps=['hubspot']  # All HubSpot actions including contact management
)

# Task to manage contacts
contact_task = Task(
    description="Create a new contact for 'Jane Smith' at 'Global Tech Inc.' with email 'jane.smith@globaltech.com'.",
    agent=crm_manager,
    expected_output="Contact database updated with the new contact."
)

crew = Crew(
    agents=[crm_manager],
    tasks=[contact_task]
)

crew.kickoff()

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

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

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