اعتبارنامه‌های HubSpot#
می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر استفاده کنید:
روش‌های تایید هویت پشتیبانی‌شده#
- توکن برنامه: استفاده با نود HubSpot.
- کلید API توسعه‌دهنده: استفاده با نود گیرنده HubSpot.
- OAuth2: استفاده با نود HubSpot.
/// هشدار | کلید API منسوخ شده هاب‌اسپات روش تأیید هویت معمول کلید API را منسوخ کرده است. این گزینه هنوز در n98n ظاهر می‌شود، اما باید از روش‌های تأیید هویت بالا استفاده کنید. اگر اینتگریشن‌های موجود دارید که از این روش کلید API استفاده می‌کنند، به راهنمای انتقال یک اینتگریشن کلید API به یک برنامه خصوصی مراجعه کنید و یک توکن برنامه تنظیم کنید. ///
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مدارک API HubSpot مراجعه کنید. نود گیرنده HubSpot از API Webhooks استفاده می‌کند؛ برای اطلاعات بیشتر درباره آن، به مدارک API Webhooks HubSpot مراجعه کنید.
استفاده از توکن برنامه#
برای پیکربندی این اعتبارنامه، به یک حساب HubSpot یا حساب توسعه‌دهنده HubSpot نیاز دارید و:
- یک توکن برنامه
برای تولید توکن برنامه، در HubSpot یک برنامه خصوصی بسازید:
- وارد حساب HubSpot خود شوید و روی نماد تنظیمات در نوار ناوبری اصلی کلیک کنید.
- در منوی سمت چپ، به یکپارچگی‌ها > برنامه‌های خصوصی بروید.
- روی ایجاد برنامه خصوصی کلیک کنید.
- در برگه اطلاعات پایه، نام برنامه خود را وارد کنید.
- روی لوگو جای‌گذاری شده قرار گرفته و گزینه آپلود را انتخاب کنید تا تصویری مربعی که به عنوان لوگوی برنامه شما عمل می‌کند، بارگذاری کنید.
- در قسمت توضیحات، توضیح مربوط به برنامه را وارد کنید.
- برگه دامنه‌ها را باز کنید و دامنه‌های مناسب را اضافه کنید. برای لیست کامل دامنه‌های مورد نیاز، به دامنه‌های مورد نیاز برای نود HubSpot مراجعه کنید.
- روی ایجاد برنامه کلیک کنید تا فرآیند پایان یابد.
- در پنجره پاپ‌آپ، اطلاعات مربوط به توکن دسترسی برنامه خود را بررسی کنید، سپس روی ادامه فرآیند ایجاد کلیک کنید.
- پس از ساخت برنامه، برگه توکن دسترسی را باز کنید و روی نمایش توکن کلیک کنید تا توکن نشان داده شود.
- این توکن را کپی کرده و در اعتبارنامه n98n خود وارد کنید.
برای اطلاعات بیشتر، به مستندات برنامه‌های خصوصی HubSpot مراجعه کنید.
استفاده از کلید API توسعه‌دهنده#
برای پیکربندی این اعتبارنامه، نیازمند حساب توسعه‌دهنده HubSpot و موارد زیر هستید:
- یک شناسه کلاینت: تولید شده هنگام ساختن یک برنامه عمومی.
- یک رمز کلاینت: تولید شده هنگام ساختن یک برنامه عمومی.
- یک کلید API توسعه‌دهنده: از داشبورد برنامه‌های توسعه‌دهنده خود تولید می‌شود.
- یک شناسه برنامه (App ID): هنگام ساختن برنامه عمومی ساخته می‌شود.
برای ساختن برنامه عمومی و تنظیم این اعتبارنامه:
- وارد حساب توسعه‌دهنده برنامه‌های HubSpot شوید.
- از نوار ناوبری اصلی، برنامه‌ها را انتخاب کنید.
- روی دریافت کلید API HubSpot کلیک کنید. ممکن است نیاز باشد گزینه نمایش کلید را فعال کنید.
- کلید را کپی کرده و در n98n به عنوان کلید API توسعه‌دهنده وارد کنید.
- در همان صفحه برنامه‌ها، روی ایجاد برنامه کلیک کنید.
- در برگه اطلاعات برنامه، نام برنامه، توضیحات، لوگو و هر اطلاعات تماس پشتیبانی که می‌خواهید ارائه دهید، وارد کنید. این اطلاعات برای افرادی که با برنامه مواجه می‌شوند مشاهده می‌شود.
- برگه احراز هویت را باز کنید.
- شناسه برنامه (App ID) را کپی کرده و در n98n وارد کنید.
- شناسه کلاینت را کپی کرده و در n98n وارد کنید.
- رمز کلاینت را کپی کرده و در n98n وارد کنید.
- در بخش دامنه‌ها (Scopes)، روی افزودن دامنه جدید کلیک کنید.
- تمامی دامنه‌های موجود در دامنه‌های مورد نیاز برای نود HubSpot Trigger را به برنامه خود اضافه کنید.
- روی به‌روزرسانی کلیک کنید.
- آدرس بازگشت OAuth n8n را کپی کرده و به عنوان آدرس بازگشت (Redirect URL) در برنامه HubSpot وارد کنید.
- روی ایجاد برنامه کلیک کنید تا فرآیند ساخته شدن برنامه HubSpot کامل شود.
برای اطلاعات بیشتر، به مستندات برنامه‌های عمومی HubSpot مراجعه کنید.
دامنه‌های مورد نیاز برای نود HubSpot Trigger#
اگر در حال ساخت برنامه برای استفاده با نود گیرنده HubSpot هستید، توصیه می‌شود با این دامنه‌ها شروع کنید:
| عنصر | شیء | مجوز | نام دامنه |
|---|---|---|---|
| نام‌وجود ندارد | نام‌وجود ندارد | نام‌وجود ندارد | oauth |
| CRM | شرکت‌ها | خواندن | crm.objects.companies.read |
| CRM | اسکمه‌های شرکت‌ها | خواندن | crm.schemas.companies.read |
| CRM | تماس‌ها | خواندن | crm.objects.contacts.read |
| CRM | اسکمه‌های تماس‌ها | خواندن | crm.schemas.contacts.read |
| CRM | معاملات | خواندن | crm.objects.deals.read |
| CRM | اسکمه‌های معاملات | خواندن | crm.schemas.deals.read |
/// هشدار | حساب‌های قدیمی HubSpot برخی حساب‌های HubSpot به تمام دامنه‌ها دسترسی ندارند. HubSpot حساب‌ها را به صورت تدریجی مهاجرت می‌دهد. اگر نتوانستید تمام دامنه‌ها را در حساب توسعه‌دهنده فعلی خود پیدا کنید، تلاش کنید حساب توسعه‌دهنده جدیدی بسازید. ///
استفاده از OAuth2#
نکته برای کاربران n98n کلود
کاربران کلود نیازی به ارائه جزئیات کانکشن ندارند. گزینه کانکشن حساب کاربری من را انتخاب کنید تا از طریق مرورگر خود ارتباط برقرار کنید.
```
اگر در حال استقرار خود (self-hosting) n98n هستید، باید OAuth2 را از ابتدا پیکربندی کنید و یک برنامه عمومی جدید بسازید:
- وارد حساب توسعه‌دهنده برنامه HubSpot شوید.
- از نوار ناوبری اصلی، برنامه‌ها را انتخاب کنید.
- روی ایجاد برنامه کلیک کنید.
- در برگه اطلاعات برنامه، نام برنامه، توضیحات، لوگو و هر اطلاعات تماس پشتیبانی که می‌خواهید، وارد کنید.
- برگه احراز هویت را باز کنید.
- شناسه برنامه (App ID) را کپی کرده و در n98n وارد کنید.
- شناسه کلاینت را کپی کرده و در n98n وارد کنید.
- رمز کلاینت را کپی کرده و در n98n وارد کنید.
- در بخش دامنه‌ها (Scopes)، روی افزودن دامنه جدید کلیک کنید.
- تمامی دامنه‌های موجود در دامنه‌های مورد نیاز برای نود HubSpot را اضافه کنید.
- روی به‌روزرسانی کلیک کنید.
- آدرس بازگشت OAuth n8n را کپی کرده و به عنوان آدرس بازگشت (Redirect URL) در برنامه HubSpot وارد کنید.
- روی ایجاد برنامه کلیک کنید تا فرآیند ساخته شدن برنامه HubSpot کامل شود.
برای اطلاعات بیشتر، به مستندات برنامه‌های عمومی HubSpot مراجعه کنید. برای جزئیات بیشتر درباره روند OAuth، به مدارک working with OAuth HubSpot مراجعه کنید.
دامنه‌های مورد نیاز برای نود HubSpot#
اگر در حال ساخت برنامه برای استفاده با نود HubSpot هستید، این دامنه‌ها را پیشنهاد می‌کنیم:
| عنصر | شیء | مجوز | نام دامنه (Scope name(s)) |
|---|---|---|---|
| نام‌وجود ندارد | نام‌وجود ندارد | نام‌وجود ندارد | oauth |
| نام‌وجود ندارد | نام‌وجود ندارد | نام‌وجود ندارد | forms |
| نام‌وجود ندارد | نام‌وجود ندارد | نام‌وجود ندارد | tickets |
| CRM | شرکت‌ها | خواندن نوشتن |
crm.objects.companies.read crm.objects.companies.write |
| CRM | اسکمه‌های شرکت‌ها | خواندن | crm.schemas.companies.read |
| CRM | اسکمه‌های تماس‌ها | خواندن | crm.schemas.contacts.read |
| CRM | تماس‌ها | خواندن نوشتن |
crm.objects.contacts.read crm.objects.contacts.write |
| CRM | معاملات | خواندن نوشتن |
crm.objects.deals.read crm.objects.deals.write |
| CRM | اسکمه‌های معاملات | خواندن | crm.schemas.deals.read |
| CRM | مالکان | خواندن | crm.objects.owners.read |
| CRM | فهرست‌ها | نوشتن | crm.lists.write |
/// هشدار | حساب‌های قدیمی HubSpot برخی حساب‌های HubSpot به تمام دامنه‌ها دسترسی ندارند. HubSpot در حال مهاجرت حساب‌ها است، پس اگر در حساب توسعه‌دهنده فعلی، دامنه مورد نیاز را نمی‌بینید، سعی کنید یک حساب توسعه‌دهنده جدید بسازید. ///