تكامل HubSpot

نظرة عامة

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

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

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

• حساب CrewAI AMP مع اشتراك فعّال.
• حساب HubSpot بالصلاحيات المناسبة.
• ربط حساب HubSpot الخاص بك عبر صفحة التكاملات.

إعداد تكامل HubSpot

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

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

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

uv add crewai-tools

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

Note

لاستخدام التكاملات مع Agent(apps=[]), يجب تعيين متغير البيئة CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك.

export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

أو أضفه إلى ملف .env:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token

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

hubspot/create_company

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

الوصف: إنشاء سجل جهة اتصال جديد في 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/create_deal

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

الوصف: إنشاء تفاعل جديد (مثل ملاحظة، بريد إلكتروني، مكالمة، اجتماع، مهمة) في 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/update_company

الوصف: تحديث سجل شركة موجود في HubSpot.

المعاملات:

• recordId (string, مطلوب): معرّف الشركة المراد تحديثها.
• name (string, اختياري): اسم الشركة.
• domain (string, اختياري): اسم نطاق الشركة.
• industry (string, اختياري): القطاع.
• phone (string, اختياري): رقم الهاتف.
• description (string, اختياري): الوصف.

hubspot/update_contact

الوصف: تحديث سجل جهة اتصال موجود في HubSpot.

المعاملات:

• recordId (string, مطلوب): معرّف جهة الاتصال المراد تحديثها.
• firstname (string, اختياري): الاسم الأول.
• lastname (string, اختياري): اسم العائلة.
• email (string, اختياري): عنوان البريد الإلكتروني.
• phone (string, اختياري): رقم الهاتف.
• company (string, اختياري): اسم الشركة.
• jobtitle (string, اختياري): المسمى الوظيفي.

hubspot/update_deal

الوصف: تحديث سجل صفقة موجود في HubSpot.

المعاملات:

• recordId (string, مطلوب): معرّف الصفقة المراد تحديثها.
• dealname (string, اختياري): اسم الصفقة.
• amount (number, اختياري): قيمة الصفقة.
• dealstage (string, اختياري): مرحلة مسار الصفقة.
• closedate (string, اختياري): تاريخ الإغلاق المتوقع.

hubspot/list_companies

الوصف: الحصول على قائمة بسجلات الشركات من HubSpot.

المعاملات:

• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/list_contacts

الوصف: الحصول على قائمة بسجلات جهات الاتصال من HubSpot.

المعاملات:

• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/list_deals

الوصف: الحصول على قائمة بسجلات الصفقات من HubSpot.

المعاملات:

• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/get_company

الوصف: الحصول على سجل شركة واحد بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف الشركة المراد استرجاعها.

hubspot/get_contact

الوصف: الحصول على سجل جهة اتصال واحد بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف جهة الاتصال المراد استرجاعها.

hubspot/get_deal

الوصف: الحصول على سجل صفقة واحد بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف الصفقة المراد استرجاعها.

hubspot/search_companies

الوصف: البحث عن سجلات الشركات في HubSpot باستخدام صيغة فلتر.

المعاملات:

• filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/search_contacts

الوصف: البحث عن سجلات جهات الاتصال في HubSpot باستخدام صيغة فلتر.

المعاملات:

• filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/search_deals

الوصف: البحث عن سجلات الصفقات في HubSpot باستخدام صيغة فلتر.

المعاملات:

• filterFormula (object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).
• paginationParameters (object, اختياري): استخدم pageCursor لجلب الصفحات اللاحقة.

hubspot/delete_record_companies

الوصف: حذف سجل شركة بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف الشركة المراد حذفها.

hubspot/delete_record_contacts

الوصف: حذف سجل جهة اتصال بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف جهة الاتصال المراد حذفها.

hubspot/delete_record_deals

الوصف: حذف سجل صفقة بواسطة معرّفه.

المعاملات:

• recordId (string, مطلوب): معرّف الصفقة المراد حذفها.

hubspot/describe_action_schema

الوصف: الحصول على المخطط المتوقع لنوع كائن وعملية معينة.

المعاملات:

• 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 '[email protected]'.",
    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 '[email protected]'.",
    agent=crm_manager,
    expected_output="Contact database updated with the new contact."
)

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

crew.kickoff()

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

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

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