نظرة عامة
مكّن وكلاءك من إدارة الشركات وجهات الاتصال داخل HubSpot. أنشئ سجلات جديدة وبسّط عمليات CRM باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل HubSpot، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال.
- حساب HubSpot بالصلاحيات المناسبة.
- ربط حساب HubSpot الخاص بك عبر صفحة التكاملات.
إعداد تكامل HubSpot
1. ربط حساب HubSpot الخاص بك
- انتقل إلى تكاملات CrewAI AMP.
- ابحث عن HubSpot في قسم تكاملات المصادقة.
- انقر على Connect وأكمل عملية OAuth.
- امنح الصلاحيات اللازمة لإدارة الشركات وجهات الاتصال.
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
hubspot/create_company
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/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/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/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/update_company
الوصف: تحديث سجل شركة موجود في HubSpot.المعاملات:
recordId(string, مطلوب): معرّف الشركة المراد تحديثها.name(string, اختياري): اسم الشركة.domain(string, اختياري): اسم نطاق الشركة.industry(string, اختياري): القطاع.phone(string, اختياري): رقم الهاتف.description(string, اختياري): الوصف.
hubspot/update_contact
hubspot/update_contact
الوصف: تحديث سجل جهة اتصال موجود في HubSpot.المعاملات:
recordId(string, مطلوب): معرّف جهة الاتصال المراد تحديثها.firstname(string, اختياري): الاسم الأول.lastname(string, اختياري): اسم العائلة.email(string, اختياري): عنوان البريد الإلكتروني.phone(string, اختياري): رقم الهاتف.company(string, اختياري): اسم الشركة.jobtitle(string, اختياري): المسمى الوظيفي.
hubspot/update_deal
hubspot/update_deal
الوصف: تحديث سجل صفقة موجود في HubSpot.المعاملات:
recordId(string, مطلوب): معرّف الصفقة المراد تحديثها.dealname(string, اختياري): اسم الصفقة.amount(number, اختياري): قيمة الصفقة.dealstage(string, اختياري): مرحلة مسار الصفقة.closedate(string, اختياري): تاريخ الإغلاق المتوقع.
hubspot/list_companies
hubspot/list_companies
الوصف: الحصول على قائمة بسجلات الشركات من HubSpot.المعاملات:
paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/list_contacts
hubspot/list_contacts
الوصف: الحصول على قائمة بسجلات جهات الاتصال من HubSpot.المعاملات:
paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/list_deals
hubspot/list_deals
الوصف: الحصول على قائمة بسجلات الصفقات من HubSpot.المعاملات:
paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/get_company
hubspot/get_company
الوصف: الحصول على سجل شركة واحد بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف الشركة المراد استرجاعها.
hubspot/get_contact
hubspot/get_contact
الوصف: الحصول على سجل جهة اتصال واحد بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف جهة الاتصال المراد استرجاعها.
hubspot/get_deal
hubspot/get_deal
الوصف: الحصول على سجل صفقة واحد بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف الصفقة المراد استرجاعها.
hubspot/search_companies
hubspot/search_companies
الوصف: البحث عن سجلات الشركات في HubSpot باستخدام صيغة فلتر.المعاملات:
filterFormula(object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/search_contacts
hubspot/search_contacts
الوصف: البحث عن سجلات جهات الاتصال في HubSpot باستخدام صيغة فلتر.المعاملات:
filterFormula(object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/search_deals
hubspot/search_deals
الوصف: البحث عن سجلات الصفقات في HubSpot باستخدام صيغة فلتر.المعاملات:
filterFormula(object, اختياري): فلتر بصيغة التعبير العادي المنفصل (OR لمجموعات AND).paginationParameters(object, اختياري): استخدمpageCursorلجلب الصفحات اللاحقة.
hubspot/delete_record_companies
hubspot/delete_record_companies
الوصف: حذف سجل شركة بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف الشركة المراد حذفها.
hubspot/delete_record_contacts
hubspot/delete_record_contacts
الوصف: حذف سجل جهة اتصال بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف جهة الاتصال المراد حذفها.
hubspot/delete_record_deals
hubspot/delete_record_deals
الوصف: حذف سجل صفقة بواسطة معرّفه.المعاملات:
recordId(string, مطلوب): معرّف الصفقة المراد حذفها.
hubspot/describe_action_schema
hubspot/describe_action_schema
الوصف: الحصول على المخطط المتوقع لنوع كائن وعملية معينة.المعاملات:
recordType(string, مطلوب): معرّف نوع الكائن (مثال: ‘companies’).operation(string, مطلوب): نوع العملية (مثال: ‘CREATE_RECORD’).
أمثلة الاستخدام
إعداد Agent أساسي لـ HubSpot
تصفية أدوات HubSpot المحددة
إدارة جهات الاتصال
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل HubSpot أو
استكشاف الأخطاء وإصلاحها.
