اتوماسیون Pipedrive: ثبت خودکار لید از فورک‌های GitHub

اتوماسیون ایجاد لید در Pipedrive از فورک‌های GitHub

این Workflow به طور خودکار یک لید جدید در Pipedrive ایجاد می‌کند هر زمان که یک مخزن (repository) مشخص در GitHub فورک شود. این کار با ثبت علاقه‌مندی توسعه‌دهندگانی که با پروژه‌های متن‌باز شما تعامل دارند، فرآیند تولید لید را ساده می‌کند.

دسته‌بندی‌ها: فروش، مهندسی

گره‌ها (Nodes) استفاده شده: GitHub Trigger، HTTP Request، Pipedrive، IF، Set

نمای کلی Workflow

این Workflow برای موارد زیر طراحی شده است:

1. تشخیص فورک‌های GitHub: با فورک شدن یک مخزن مشخص GitHub، Workflow فعال می‌شود.

2. جمع‌آوری اطلاعات فورک‌کننده: اطلاعات دقیق کاربر فورک‌کننده مخزن، از جمله ایمیل او را بازیابی می‌کند.

3. بررسی Pipedrive: برای بررسی وجود مخاطب با آن ایمیل در Pipedrive جستجو می‌کند.

4. ایجاد یا به‌روزرسانی مخاطب:

* اگر مخاطب وجود داشته باشد، از شناسه (ID) موجود او استفاده می‌کند.

* اگر مخاطب وجود نداشته باشد، یک شخص جدید در Pipedrive ایجاد می‌کند.

5. ایجاد لید: یک لید جدید در Pipedrive ایجاد می‌کند که به مخاطب شناسایی شده یا تازه ایجاد شده پیوند داده می‌شود.

6. افزودن یادداشت مرجع: یک یادداشت به لید اضافه می‌کند که حاوی URL پروفایل کاربر GitHub برای ارجاع آسان است.

تشریح گره‌ها (Nodes)

۱. Trigger: On Fork

• نوع گره: n8n-nodes-base.githubTrigger
• هدف: هنگام وقوع رویداد فورک در یک مخزن GitHub تعیین شده، Workflow را آغاز می‌کند.
• پیکربندی:

* Credentials: اطلاعات احراز هویت حساب GitHub شما.

* Event: fork

* Repository Owner: John-n8n (نام کاربری خود را جایگزین کنید)

* Repository Name: DemoRepo (نام مخزن خود را جایگزین کنید)

• خروجی: داده‌های مربوط به رویداد فورک، از جمله اطلاعات کاربر فورک‌کننده مخزن را فراهم می‌کند.

۲. بازیابی اطلاعات کاربر GitHub

• نوع گره: n8n-nodes-base.httpRequest
• هدف: با استفاده از نقطه پایانی API که توسط Trigger ارائه شده، اطلاعات دقیق کاربر GitHub که مخزن را فورک کرده است را دریافت می‌کند.
• پیکربندی:

* URL: ={{ $json["body"].sender.url }} (URL API کاربر را به صورت پویا از خروجی Trigger دریافت می‌کند)

* Credentials: اطلاعات احراز هویت حساب GitHub شما.

* Method: GET

• ورودی: خروجی گره "On Fork".
• خروجی: داده‌های دقیق کاربر GitHub، از جمله آدرس ایمیل او (در صورت عمومی بودن).

۳. جستجوی مخاطب Pipedrive

• نوع گره: n8n-nodes-base.pipedrive (عملیات: Search)
• هدف: با استفاده از آدرس ایمیل به دست آمده از GitHub، مخاطب موجود در Pipedrive را جستجو می‌کند.
• پیکربندی:

* Resource: Person

* Operation: Search

* Credentials: اطلاعات احراز هویت حساب Pipedrive شما.

* Term: ={{ $json["email"] }} (از ایمیل گره HTTP Request قبلی استفاده می‌کند)

* Fields: email (برای اطمینان از اینکه جستجو به طور خاص بر روی فیلد ایمیل انجام شود)

* Always Output Data: فعال (برای اطمینان از خروجی حتی در صورت عدم یافتن تطابق)

• ورودی: خروجی گره "بازیابی اطلاعات کاربر GitHub".
• خروجی: نتایج جستجوی Pipedrive (یا داده‌های شخص موجود یا یک آرایه خالی).

۴. تصمیم‌گیری: آیا شخص وجود دارد؟

• نوع گره: n8n-nodes-base.if
• هدف: بر اساس نتایج جستجو، تعیین می‌کند که آیا مخاطب مطابق در Pipedrive پیدا شده است یا خیر.
• پیکربندی:

* Condition: {{ $json["name"] }} خالی نیست. (بررسی می‌کند که آیا فیلد name در نتایج جستجو وجود دارد، که نشان‌دهنده یافتن مخاطب است).

• ورودی: خروجی گره "جستجوی مخاطب Pipedrive".
• خروجی: Workflow را به دو مسیر تقسیم می‌کند:

* True: اگر مخاطب پیدا شد.

* False: اگر مخاطبی پیدا نشد.

۵. آماده‌سازی شناسه شخص Pipedrive

• نوع گره: n8n-nodes-base.set
• هدف: متغیری را برای نگهداری شناسه شخص Pipedrive تنظیم می‌کند، چه از یک مخاطب موجود باشد و چه از یک مخاطب تازه ایجاد شده. این شناسه برای ایجاد لید مورد نیاز است.
• پیکربندی:

* Add Field:

* Name: PipedrivePersonId

* Value: ={{ $json["id"] }} (این به طور پویا id را از خروجی گره "جستجوی مخاطب Pipedrive" (در صورت یافتن) یا خروجی گره "ایجاد شخص Pipedrive" (در صورت ایجاد) دریافت می‌کند).

• ورودی:

* از شاخه True گره "آیا شخص وجود دارد؟".

* از گره "ایجاد شخص Pipedrive" (که در ادامه پیکربندی خواهد شد).

• خروجی: متغیر PipedrivePersonId که به گره "ایجاد لید Pipedrive" ارسال می‌شود.

۶. ایجاد شخص Pipedrive (در صورت عدم یافتن)

• نوع گره: n8n-nodes-base.pipedrive (عملیات: Create)
• هدف: اگر جستجو در مرحله ۳ مخاطب موجودی پیدا نکرد، یک شخص جدید در Pipedrive ایجاد می‌کند.
• پیکربندی:

* Resource: Person

* Operation: Create

* Credentials: اطلاعات احراز هویت حساب Pipedrive شما.

* Name: ={{ $node["On fork"].json["body"].sender.login }} (از نام کاربری GitHub فورک‌کننده استفاده می‌کند)

* Additional Fields:

* Email: ={{ $json["email"] }} (از ایمیل گره "بازیابی اطلاعات کاربر GitHub" استفاده می‌کند)

• ورودی: از شاخه False گره "آیا شخص وجود دارد؟".
• خروجی: داده‌های شخص تازه ایجاد شده در Pipedrive، از جمله id او. این خروجی سپس به گره "آماده‌سازی شناسه شخص Pipedrive" تغذیه می‌شود.

۷. ایجاد لید Pipedrive

• نوع گره: n8n-nodes-base.pipedrive (عملیات: Create)
• هدف: یک لید جدید در Pipedrive ایجاد می‌کند و آن را به شخص مربوطه (موجود یا تازه ایجاد شده) پیوند می‌دهد.
• پیکربندی:

* Resource: Lead

* Operation: Create

* Credentials: اطلاعات احراز هویت حساب Pipedrive شما.

* Title: Repo '{{ $node["On fork"].json["body"]["repository"]["full_name"] }}' forked by {{$json["name"]}} (یک عنوان توصیفی شامل مخزن و نام فورک‌کننده)

* Person ID: ={{ $json["PipedrivePersonId"] }} (از شناسه آماده شده در گره "آماده‌سازی شناسه شخص Pipedrive" استفاده می‌کند)

* Associate With: Person (اطمینان حاصل کنید که این گزینه فعال است)

• ورودی: خروجی گره "آماده‌سازی شناسه شخص Pipedrive".
• خروجی: داده‌های لید تازه ایجاد شده در Pipedrive، از جمله id آن.

۸. افزودن یادداشت URL GitHub

• نوع گره: n8n-nodes-base.pipedrive (عملیات: Create)
• هدف: یک یادداشت به لید تازه ایجاد شده اضافه می‌کند که حاوی پیوند مستقیم به پروفایل کاربر GitHub برای پیگیری آسان است.
• پیکربندی:

* Resource: Note

* Operation: Create

* Credentials: اطلاعات احراز هویت حساب Pipedrive شما.

* Content: Github user url: {{ $node["On fork"].json["body"].sender.html_url }} (شامل URL پروفایل GitHub)

* Additional Fields:

* Lead ID: ={{ $json["id"] }} (از id لید ایجاد شده در مرحله قبل استفاده می‌کند)

• ورودی: خروجی گره "ایجاد لید Pipedrive".
• خروجی: ندارد (این آخرین گره در این Workflow است).

اتصالات Workflow

1. On fork → بازیابی اطلاعات کاربر GitHub

2. بازیابی اطلاعات کاربر GitHub → جستجوی مخاطب Pipedrive

3. جستجوی مخاطب Pipedrive → آیا شخص وجود دارد؟

4. آیا شخص وجود دارد؟ (شاخه True) → آماده‌سازی شناسه شخص Pipedrive

5. آیا شخص وجود دارد؟ (شاخه False) → ایجاد شخص Pipedrive (در صورت عدم یافتن)

6. ایجاد شخص Pipedrive (در صورت عدم یافتن) → آماده‌سازی شناسه شخص Pipedrive

7. آماده‌سازی شناسه شخص Pipedrive → ایجاد لید Pipedrive

8. ایجاد لید Pipedrive → افزودن یادداشت URL GitHub

نحوه بازسازی این Workflow

1. افزودن GitHub Trigger:

* گره GitHub Trigger را انتخاب کنید.

* اطلاعات احراز هویت GitHub خود را پیکربندی کنید.

* Event را روی fork تنظیم کنید.

* Repository Owner و Repository Name خود را وارد کنید.

2. افزودن گره HTTP Request:

* گره HTTP Request را انتخاب کنید.

* آن را به GitHub Trigger متصل کنید.

* URL را روی ={{ $json["body"].sender.url }} تنظیم کنید.

* اطلاعات احراز هویت GitHub خود را برای احراز هویت پیکربندی کنید.

3. افزودن گره جستجوی Pipedrive:

* گره Pipedrive را انتخاب کنید.

* آن را به گره HTTP Request متصل کنید.

* Resource را روی Person و Operation را روی Search تنظیم کنید.

* اطلاعات احراز هویت Pipedrive خود را پیکربندی کنید.

* Term را روی ={{ $json["email"] }} تنظیم کنید.

* در Additional Fields، fields را با مقدار email اضافه کنید.

* Always Output Data را فعال کنید.

4. افزودن گره IF:

* گره IF را انتخاب کنید.

* آن را به گره جستجوی Pipedrive متصل کنید.

* Condition را روی String → {{ $json["name"] }} is not empty تنظیم کنید.

5. افزودن گره Set:

* گره Set را انتخاب کنید.

* آن را به شاخه True گره IF متصل کنید.

* یک فیلد اضافه کنید: Name: PipedrivePersonId، Value: ={{ $json["id"] }}.

6. افزودن گره ایجاد شخص Pipedrive:

* گره Pipedrive را انتخاب کنید.

* آن را به شاخه False گره IF متصل کنید.

* Resource را روی Person و Operation را روی Create تنظیم کنید.

* اطلاعات احراز هویت Pipedrive خود را پیکربندی کنید.

* Name را روی ={{ $node["On fork"].json["body"].sender.login }} تنظیم کنید.

* در Additional Fields، Email را با مقدار ={{ $json["email"] }} اضافه کنید.

7. افزودن گره ایجاد لید Pipedrive:

* گره Pipedrive را انتخاب کنید.

* گره Set را به این گره Pipedrive متصل کنید.

* Resource را روی Lead و Operation را روی Create تنظیم کنید.

* اطلاعات احراز هویت Pipedrive خود را پیکربندی کنید.

* Title را روی Repo '{{$node["On fork"].json["body"]["repository"]["full_name"]}}' forked by {{$json["name"]}} تنظیم کنید.

* Person ID را روی ={{ $json["PipedrivePersonId"] }} تنظیم کنید.

* Associate With: Person را فعال کنید.

8. افزودن گره ایجاد یادداشت Pipedrive:

* گره Pipedrive را انتخاب کنید.

* آن را به گره ایجاد لید متصل کنید.

* Resource را روی Note و Operation را روی Create تنظیم کنید.

* اطلاعات احراز هویت Pipedrive خود را پیکربندی کنید.

* Content را روی Github user url: {{ $node["On fork"].json["body"].sender.html_url }} تنظیم کنید.

* در Additional Fields، Lead ID را با مقدار ={{ $json["id"] }} اضافه کنید.

9. گره‌ها را همانطور که در بخش "اتصالات Workflow" توضیح داده شده است، متصل کنید. اطمینان حاصل کنید که گره "آماده‌سازی شناسه شخص Pipedrive" ورودی را از گره "ایجاد شخص Pipedrive" نیز دریافت می‌کند.