اعتبارنامه‌های Pipedrive#
می‌توانید از این اعتبارنامه‌ها برای احراز هویت نودهای زیر استفاده کنید:
روش‌های پشتیبانی‌شده احراز هویت#
- توکن API
- OAuth2
منابع مرتبط#
برای اطلاعات بیشتر درباره سرویس، به مستندات توسعه‌دهندگان Pipedrive مراجعه کنید.
استفاده از توکن API#
برای پیکربندی این اعتبارنامه، به یک حساب Pipedrive و:
- یک توکن API
برای دریافت توکن API خود:
- حساب کاربری خود را در بخش ترجیحات شخصی API باز کنید.
- توکن API شخصی شما را کپی کنید و در اعتبارنامه n98n وارد نمایید.
اگر چندین شرکت دارید، ابتدا باید شرکت مناسب را انتخاب کنید:
- نام حساب کاربری خود را انتخاب کنید و مطمئن شوید که شرکت مناسب را مشاهده می‌کنید.
- سپس بر روی تنظیمات شرکت کلیک کنید.
- سپس بر روی ترجیحات شخصی کلیک کنید.
- بر روی تب API کلیک کنید.
- توکن API شخصی شما را کپی کرده و در اعتبارنامه n98n وارد کنید.
برای اطلاعات بیشتر، به چگونه توکن API را پیدا کنیم مراجعه کنید.
استفاده از OAuth2#
برای پیکربندی این اعتبارنامه، به یک حساب شبیه‌ساز توسعه‌دهنده Pipedrive و:
- یک شناسه مشتری (Client ID)
- یک سری کلاینت (Client Secret)
برای دریافت هر دو، باید یک برنامه جدید ثبت کنید:
- نام پروفایل خود را در گوشه بالا سمت راست انتخاب کنید.
- نام شرکت حساب شبیه‌ساز خود را پیدا کنید و بر روی مرکز توسعه‌دهندگان کلیک کنید.
/// نکته | بدون مرکز توسعه‌دهندگان اگر در منوی کشویی حساب خود، گزینه مرکز توسعه‌دهندگان را نمی‌بینید، در حساب شبیه‌ساز توسعه‌دهنده ثبت‌نام کنید حساب توسعه‌دهنده. ///
- بر روی ایجاد برنامه کلیک کنید.
- بر روی ایجاد برنامه عمومی کلیک کنید. تب اطلاعات پایه برنامه باز می‌شود.
- نام برنامه خود، مانند
اینتگریشن n8n، را وارد کنید. - URL بازگشتی OAuth از n98n را کپی کنید و آن را به عنوان Callback URL برنامه اضافه کنید.
- بر روی ذخیره کلیک کنید. تب OAuth و حوزه‌های دسترسی برنامه باز می‌شود.
- مجوزهای مناسب (Scopes) را برای برنامه خود فعال کنید. برای راهنمایی بیشتر به محدوده‌های نود Pipedrive و محدوده‌های نود پیشنهاد Pipedrive مراجعه کنید.
- شناسه مشتری (Client ID) را کپی کرده و در اعتبارنامه n98n وارد کنید.
- سری کلاینت (Client Secret) را کپی کرده و در اعتبارنامه n98n وارد کنید.
برای اطلاعات بیشتر، به ثبت‌نام یک برنامه عمومی مراجعه کنید.
محدوده‌های نود Pipedrive#
محدوده‌هایی که به برنامه خود اضافه می‌کنید، بستگی به این دارد که قصد دارید از آن در چه نودهایی در n98n استفاده کنید و چه اقداماتی می‌خواهید انجام دهید.
محدوده‌هایی که ممکن است برای نود Pipedrive:
| شی | عملگر نود | دامنه UI | دامنه واقعی |
|---|---|---|---|
| فعالیت | دریافت داده‌های یک فعالیت دریافت داده‌های تمام فعالیت‌ها |
فعالیت‌ها: فقط خواندن یا فعالیت‌ها: دسترسی کامل |
activities:read یا activities:full |
| فعالیت | ساختن حذف به‌روزرسانی |
فعالیت‌ها: دسترسی کامل | activities:full |
| معامله | دریافت داده‌های یک معامله دریافت داده‌های تمام معاملات جست‌وجوی یک معامله |
معاملات: فقط خواندن یا معاملات: دسترسی کامل |
deals:read یا deals:full |
| معامله | ساختن حذف کپی‌اش به‌روزرسانی |
معاملات: دسترسی کامل | deals:full |
| فعالیت معامله | دریافت تمام فعالیت‌های مربوط به یک معامله | فعالیت‌ها: فقط خواندن یا فعالیت‌ها: دسترسی کامل |
activities:read یا activities:full |
| محصول معامله | دریافت تمام محصولات در یک معامله | محصولات: فقط خواندن یا محصولات: دسترسی کامل |
products:read یا products:full |
| فایل | دانلود دریافت داده‌های یک فایل |
به یادداشت زیر مراجعه کنید | به یادداشت زیر مراجعه کنید |
| فایل | ساختن حذف |
به یادداشت زیر مراجعه کنید | به یادداشت زیر مراجعه کنید |
| سرنخ | دریافت داده‌های سرنخ دریافت داده‌های تمام سرنخ‌ها |
سرنخ‌ها: فقط خواندن یا سرنخ‌ها: دسترسی کامل |
leads:read یا leads:full |
| سرنخ | ساختن حذف به‌روزرسانی |
سرنخ‌ها: دسترسی کامل | leads:full |
| یادداشت | دریافت داده‌های یک یادداشت دریافت داده‌های تمام یادداشت‌ها |
به یادداشت زیر مراجعه کنید | به یادداشت زیر مراجعه کنید |
| یادداشت | ساختن حذف به‌روزرسانی |
به یادداشت زیر مراجعه کنید | به یادداشت زیر مراجعه کنید |
| سازمان | دریافت داده‌های یک سازمان دریافت داده‌های تمامی سازمان‌ها جست‌وجو |
مخاطبین: فقط خواندن یا مخاطبین: دسترسی کامل |
contacts:read یا contacts:full |
| سازمان | ساختن حذف به‌روزرسانی |
مخاطبین: دسترسی کامل | contacts:full |
| فرد | دریافت داده‌های یک فرد دریافت داده‌های تمام افراد جست‌وجو |
مخاطبین: فقط خواندن یا مخاطبین: دسترسی کامل |
contacts:read or contacts:full |
| فرد | ساختن حذف به‌روزرسانی |
مخاطبین: دسترسی کامل | contacts:full |
| محصول | دریافت داده‌های تمام محصولات | محصولات: فقط خواندن | products:read |
/// یادداشت | فایل‌ها و یادداشت‌ها محدوده‌های مربوط به فایل‌ها و یادداشت‌ها، بستگی به شیء مربوطه دارند:
- فایل‌ها مربوط به معاملات، فعالیت‌ها یا مخاطبین هستند.
- یادداشت‌ها مربوط به معاملات یا مخاطبین هستند.
برای آن اشیاء، محدوده‌ها را بررسی کنید. ///
نود Pipedrive همچنین از فراخوانی‌های API سفارشی پشتیبانی می‌کند. محدوده‌های مرتبط با هر نوع فراخوانی API سفارشی را اضافه کنید.
برای اطلاعات بیشتر، به توضیحات مربوط به محدوده‌ها و مجوزها مراجعه کنید.
محدوده‌های نود پیشنهاد Pipedrive#
نود پیشنهاد Pipedrive نیازمند دامنه وب‌هوک‌ها: دسترسی کامل (webhooks:full) می‌باشد.