غنی‌سازی خودکار شرکت‌ها و همگام‌سازی با HubSpot با GPT-4o-mini

اتوماسیون غنی‌سازی داده‌های شرکت و همگام‌سازی با HubSpot با GPT-4o-mini

دسته‌بندی‌ها: تولید سرنخ، هوش مصنوعی چندوجهی، ادغام CRM، غنی‌سازی داده

لینک گردش کار: کاتالوگ n8n پیکسی.می

نمای کلی گردش کار

این گردش کار، فرآیند غنی‌سازی داده‌های شرکت‌ها را از یک Google Sheet و همگام‌سازی آن با HubSpot CRM را خودکار می‌کند. این گردش کار از مدل GPT-4o-mini OpenAI برای جمع‌آوری اطلاعات تجاری دقیق استفاده می‌کند و اطمینان می‌دهد که CRM شما به‌روز و جامع باقی می‌ماند. این گردش کار برای تیم‌های فروش و بازاریابی B2B که به دنبال ساده‌سازی مدیریت سرنخ‌ها و افزایش داده‌ها هستند، ایده‌آل است.

گردش کار به چهار مرحله کلیدی تقسیم شده است:

1. دریافت و اعتبارسنجی سرنخ: با ورودی‌های جدید در یک Google Sheet فعال می‌شود و سرنخ‌های ناقص را فیلتر می‌کند.

2. غنی‌سازی با هوش مصنوعی: از GPT-4o-mini برای جمع‌آوری اطلاعات دقیق در مورد هر شرکت استفاده می‌کند.

3. همگام‌سازی HubSpot CRM: شرکت‌های موجود در HubSpot را بررسی کرده و در صورت لزوم رکوردهای جدید ایجاد می‌کند.

4. ثبت رکورد در Google Sheets: Google Sheet اصلی را با داده‌های غنی‌شده و همگام‌شده به‌روز می‌کند.

---

تشریح کامل گردش کار

۱. دریافت و اعتبارسنجی سرنخ‌ها

این مرحله اولیه تضمین می‌کند که فقط سرنخ‌های شرکتی معتبر از Google Sheet شما پردازش می‌شوند.

نودها:

• 📥 Google Sheet Trigger: ردیابی ردیف‌های جدید اضافه شده به یک Google Sheet مشخص را انجام می‌دهد.
• 🧹 Filter: Valid Company Name: ردیف‌هایی را که فیلد "Company Name" در آن‌ها خالی است، فیلتر می‌کند.

جزئیات نود:

• 📥 Google Sheet Trigger

* Type: n8n-nodes-base.googleSheetsTrigger

* Purpose: ردیابی ردیف‌های جدید اضافه شده به یک Google Sheet مشخص (به عنوان مثال، "Sheet1" در یک سند خاص) را انجام می‌دهد.

* Configuration: با استفاده از احراز هویت OAuth2، برای بررسی ردیف‌های جدید در یک بازه زمانی مشخص (به عنوان مثال، هر دقیقه) پیکربندی شده است.

* Input: ندارد (نود تریگر).

* Output: برای هر ردیف جدید شناسایی شده، داده صادر می‌کند.

* Potential Issues: اعتبارنامه‌های نامعتبر OAuth، حذف/تغییر نام برگه، محدودیت‌های نرخ API به دلیل بررسی مکرر.

• 🧹 Filter: Valid Company Name

* Type: n8n-nodes-base.if

* Purpose: اطمینان حاصل می‌کند که فقط ردیف‌های حاوی نام شرکت به مرحله بعدی می‌روند و از پردازش داده‌های ناقص جلوگیری می‌کند.

* Configuration: یک بررسی شرطی برای تأیید اینکه آیا فیلد "Company Name" خالی نیست.

* Input: خروجی از Google Sheet Trigger.

* Output:

* True Branch: در صورت وجود نام شرکت، به غنی‌سازی با هوش مصنوعی ادامه می‌دهد.

* False Branch: ردیف‌های فاقد نام شرکت را حذف می‌کند.

* Potential Issues: عدم تطابق نام فیلد (حساس به حروف بزرگ و کوچک)، عدم شناسایی نام‌هایی که فقط شامل فاصله هستند در صورت عدم حذف فاصله‌ها.

۲. غنی‌سازی شرکت با قدرت هوش مصنوعی

این مرحله از GPT-4o-mini برای جمع‌آوری داده‌های غنی و ساختاریافته در مورد هر شرکت استفاده می‌کند.

نودها:

• 🤖 OpenAI Enrichment (GPT-4o-mini): نام شرکت‌ها را به GPT-4o-mini ارسال می‌کند تا اطلاعات تجاری دقیق را در قالب JSON تولید کند.
• 🧾 Parse Enriched Data: پاسخ JSON را از نود OpenAI استخراج و قالب‌بندی می‌کند.

جزئیات نود:

• 🤖 OpenAI Enrichment (GPT-4o-mini)

* Type: @n8n/n8n-nodes-langchain.openAi

* Purpose: با پرس‌وجو از GPT-4o-mini با یک prompt سیستمی که برای استخراج خروجی JSON ساختاریافته حاوی صنعت، اندازه، سال تأسیس و سایر جزئیات مرتبط طراحی شده است، داده‌های شرکت را غنی می‌کند.

* Configuration:

* Model: gpt-4o-mini

* Max Tokens: برای کنترل طول پاسخ تنظیم شده است (به عنوان مثال، ۵۰۰).

* Temperature: مقدار پایین (به عنوان مثال، ۰.۳) برای خروجی واقعی و سازگار.

* Messages: شامل یک prompt سیستمی که ساختار JSON مورد نظر را تعریف می‌کند و یک prompt کاربر که حاوی نام شرکت است.

* Input: ردیف‌های فیلتر شده با نام شرکت‌های معتبر.

* Output: پاسخ خام از مدل GPT، حاوی جزئیات شرکت در قالب JSON.

* Credentials: نیاز به کلید API OpenAI دارد.

* Potential Issues: خطاهای API (سهمیه، احراز هویت)، خروجی JSON نامعتبر از GPT، داده‌های ناقص یا نادرست، قطع شدن شبکه.

• 🧾 Parse Enriched Data

* Type: n8n-nodes-base.set

* Purpose: فیلد message.content را از خروجی نود OpenAI تجزیه می‌کند و رشته JSON خام را به یک شیء JSON قابل استفاده تبدیل می‌کند.

* Configuration: فیلد message.content را به خروجی نود نگاشت می‌کند.

* Input: خروجی از OpenAI Enrichment node.

* Output: شیء JSON ساختاریافته حاوی داده‌های شرکت غنی شده.

* Potential Issues: خطاهای تجزیه در صورت انحراف فرمت خروجی GPT از انتظارات، محتوای خالی یا null.

۳. همگام‌سازی HubSpot CRM

این مرحله با بررسی و ایجاد رکوردهای شرکت در HubSpot، سازگاری داده‌ها را تضمین می‌کند.

نودها:

• 🔍 HubSpot: Find Company by Domain: رکورد شرکت موجود را با استفاده از دامنه شرکت در HubSpot جستجو می‌کند.
• ⚖️ Check: Company Exists in HubSpot?: تعیین می‌کند که آیا رکورد شرکتی در HubSpot پیدا شده است یا خیر.
• 🏢 Create Company in HubSpot: در صورت عدم وجود، رکورد شرکت جدیدی را در HubSpot ایجاد می‌کند.
• 🧰 Prepare Sheet Data: داده‌های غنی شده و همگام‌سازی شده را برای به‌روزرسانی Google Sheet آماده می‌کند.

جزئیات نود:

• 🔍 HubSpot: Find Company by Domain

* Type: n8n-nodes-base.hubspot

* Purpose: رکورد شرکت موجود را بر اساس نام دامنه آن در HubSpot CRM جستجو می‌کند.

* Configuration:

* Operation: Search by Domain

* Domain Expression: از نام شرکت برای استخراج دامنه استفاده می‌کند (توجه: این ممکن است نیاز به پیش‌پردازش برای استخراج دامنه معتبر داشته باشد).

* Input: داده‌های غنی شده تجزیه شده.

* Output: داده‌های شرکت HubSpot در صورت یافت شدن، یا نتیجه خالی در صورت عدم یافتن.

* Credentials: نیاز به کلید API HubSpot دارد.

* Potential Issues: فرمت دامنه نامعتبر از نام شرکت، خطاهای احراز هویت، محدودیت‌های نرخ API، نام شرکت گمشده.

• ⚖️ Check: Company Exists in HubSpot?

* Type: n8n-nodes-base.if

* Purpose: گردش کار را بر اساس اینکه آیا جستجوی HubSpot رکورد شرکتی را برگردانده است یا خیر، منشعب می‌کند.

* Configuration: وجود فیلد id را در نتیجه جستجوی HubSpot بررسی می‌کند.

* Input: خروجی از HubSpot: Find Company by Domain node.

* Output:

* True Branch (Company Exists): به آماده‌سازی داده‌ها برای به‌روزرسانی برگه ادامه می‌دهد.

* False Branch (Company Does Not Exist): به ایجاد شرکت جدید در HubSpot ادامه می‌دهد.

* Potential Issues: ساختار پاسخ API HubSpot غیرمنتظره.

• 🏢 Create Company in HubSpot

* Type: n8n-nodes-base.hubspot

* Purpose: با استفاده از داده‌های غنی شده، رکورد شرکت جدیدی را در HubSpot CRM ایجاد می‌کند.

* Configuration:

* Resource: Company

* Fields: فیلدهای استاندارد HubSpot (مانند Name، Website URL، Description، Founding Year، Industry) را با استفاده از داده‌های غنی‌سازی GPT پر می‌کند.

* Input: از شاخه "False" نود بررسی وجود.

* Output: داده‌های شرکت HubSpot تازه ایجاد شده.

* Credentials: نیاز به کلید API HubSpot دارد.

* Potential Issues: خطاهای API (اعتبارسنجی، محدود کردن)، فیلدهای مورد نیاز برای ایجاد شرکت گمشده.

• 🧰 Prepare Sheet Data

* Type: n8n-nodes-base.set

* Purpose: داده‌های غنی شده (چه تازه ایجاد شده و چه موجود در HubSpot) را برای به‌روزرسانی مجدد در Google Sheet استاندارد و قالب‌بندی می‌کند.

* Configuration: معمولاً شامل نگاشت و ساختاردهی فیلدها از هر دو منبع داده GPT و HubSpot است.

* Input: خروجی از شاخه "True" بررسی وجود یا نود "Create Company in HubSpot".

* Output: داده‌های ساختاریافته و آماده برای نود به‌روزرسانی Google Sheets.

* Potential Issues: ناسازگاری داده‌ها بین داده‌های غنی شده و CRM.

۴. ثبت رکورد Google Sheets

مرحله نهایی Google Sheet اصلی را با آخرین اطلاعات شرکت به‌روزرسانی می‌کند.

نودها:

• 📊 Update Google Sheet: ردیف‌ها را در Google Sheet با جزئیات شرکت غنی شده و وضعیت همگام‌سازی شده، اضافه یا به‌روزرسانی می‌کند.

جزئیات نود:

• 📊 Update Google Sheet

* Type: n8n-nodes-base.googleSheets

* Purpose: Google Sheet منبع را با جزئیات شرکت غنی شده و وضعیت همگام‌سازی به‌روزرسانی می‌کند و یک مسیر حسابرسی واضح ارائه می‌دهد.

* Configuration:

* Operation: appendOrUpdate

* Matching Column: از "Company Name" برای شناسایی ردیف مورد نظر برای به‌روزرسانی استفاده می‌کند.

* Column Mapping: فیلدهای داده غنی شده (وب‌سایت، صنعت، توضیحات و غیره) را از داده‌های آماده شده به ستون‌های مربوطه Google Sheet نگاشت می‌کند.

* Credentials: از احراز هویت OAuth2 برای Google Sheets استفاده می‌کند.

* Input: داده‌های آماده شده از نود "Prepare Sheet Data".

* Output: ندارد (نود پایانی).

* Potential Issues: خطاهای API Google Sheets، محدودیت‌های نرخ، ردیف‌های تکراری به دلیل مشکلات ستون تطبیق، غلط‌های املایی در نام ستون‌ها (به عنوان مثال، "Headquaters"، "Buisness Type" همانطور که در منبع ذکر شده است)، تداخل به‌روزرسانی همزمان.

---

جدول خلاصه