اتوماسیون جستجو و درخواست آپارتمان در آلمان با n8n

اتوماسیون جستجو و درخواست آپارتمان در آلمان با ImmobilienScout24 و سرویس‌های گوگل

این گردش کار فرآیند جستجوی آپارتمان‌های اجاره‌ای در آلمان را خودکار می‌کند، آن‌ها را بر اساس معیارهای شما فیلتر کرده و به طور خودکار برای آگهی‌های مناسب از طریق ایمیل درخواست می‌دهد. این گردش کار با ImmobilienScout24 برای لیست آپارتمان‌ها، Google Drive برای بازیابی اسناد شخصی (گزارش Schufa و فیش‌های حقوقی) و Google Sheets برای ثبت درخواست‌ها ادغام می‌شود. اتوماسیون به صورت روزانه اجرا می‌شود و برای ساده‌سازی و تسریع روند جستجوی آپارتمان شما طراحی شده است.

شما می‌توانید این گردش کار و موارد دیگر را در کاتالوگ n8n Axeto.ai بیابید.

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

این گردش کار به بخش‌های منطقی زیر تقسیم می‌شود:

1. راه‌انداز و پیکربندی: اجرای روزانه را زمان‌بندی کنید و پارامترهای جستجو و تماس مخصوص کاربر را تنظیم کنید.

2. پردازش مکان: نام شهرها را برای کوئری‌های API به GeoID مورد نیاز تبدیل کنید.

3. بازیابی و فیلتر کردن لیست آپارتمان‌ها: لیست آپارتمان‌ها را دریافت کرده و بر اساس اجاره و تعداد اتاق فیلتر کنید.

4. پردازش متوالی آپارتمان‌ها: برای آماده‌سازی درخواست‌ها، یکی یکی از میان آپارتمان‌های فیلتر شده عبور کنید.

5. بازیابی اسناد: اسناد شخصی مورد نیاز را از Google Drive دریافت کنید.

6. آماده‌سازی و ارسال درخواست: نامه‌های پوششی شخصی‌سازی شده ایجاد کرده و ایمیل‌های درخواست را با پیوست ارسال کنید.

7. ثبت درخواست: هر درخواست را برای پیگیری در یک Google Sheet ثبت کنید.

تشریح جزئیات

۱. راه‌اندازی تریگر و پیکربندی

• هدف: این بخش گردش کار را روزانه آغاز می‌کند و تمام پارامترهای پیکربندی لازم مانند شهر هدف، حداکثر اجاره، تعداد اتاق‌های مورد نیاز، اطلاعات تماس شما و شناسه‌های فایل Google Drive/Sheet را تعریف می‌کند.
• نودها:

* Cron Trigger

* Set Config

• جزئیات نود:

* Cron Trigger

* نوع: n8n-nodes-base.cron

* نقش: اجرای گردش کار را به صورت روزانه آغاز می‌کند.

* پیکربندی: به طور پیش‌فرض، روزانه ساعت ۸ صبح (بر اساس منطقه زمانی گردش کار، به عنوان مثال Europe/Berlin) فعال می‌شود.

* مشکلات احتمالی: عبارت cron یا تنظیمات منطقه زمانی نادرست.

* Set Config

* نوع: n8n-nodes-base.set

* نقش: پارامترهای ثابت کاربر و جستجو را به عنوان متغیرهای گردش کار تعریف می‌کند.

* پیکربندی: متغیرهایی مانند CITY ("Berlin")، MAX_RENT (مثلاً ۱۲۰۰)، ROOMS (مثلاً ۲)، MY_EMAIL، MY_NAME، GDRIVE_SCHUFA_FILE_ID، GDRIVE_SALARY_FILE_ID و GOOGLE_SHEET_ID را تنظیم می‌کند.

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

۲. پردازش موقعیت مکانی

• هدف: نام شهر پیکربندی شده را به یک GeoID تبدیل می‌کند که برای API ImmobilienScout24 مورد نیاز است.
• نودها:

* GeoID Lookup

• جزئیات نود:

* GeoID Lookup

* نوع: n8n-nodes-base.function

* نقش: نام شهر را به GeoID مربوطه در ImmobilienScout24 نگاشت می‌کند. در حال حاضر از برلین پشتیبانی می‌کند.

* پیکربندی: از یک نگاشت ثابت استفاده می‌کند. اگر شهر پیدا نشود، به طور پیش‌فرض از GeoID برلین (12770000) استفاده می‌کند.

* عبارات: متغیر CITY را از ورودی می‌خواند.

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

۳. دریافت و فیلتر کردن لیست آپارتمان‌ها

• هدف: لیست‌های آپارتمان را از API ImmobilienScout24 بر اساس GeoID دریافت کرده و آن‌ها را بر اساس نوع، قیمت و تعداد اتاق فیلتر می‌کند.
• نودها:

* Fetch Listings From immobilienscout24

* Filter Results

• جزئیات نود:

* Fetch Listings From immobilienscout24

* نوع: n8n-nodes-base.httpRequest

* نقش: درخواستی را به API ImmobilienScout24 برای دریافت لیست‌های آپارتمان ارسال می‌کند.

* پیکربندی: URL با استفاده از پارامترهای geoid، ROOMS و MAX_RENT به صورت پویا ساخته می‌شود. انتظار پاسخ JSON را دارد.

* مشکلات احتمالی:

* تغییرات API ImmobilienScout24 یا محدودیت نرخ (rate limiting).

* قالب‌بندی نادرست URL یا پارامترهای از دست رفته.

* خطاهای زمانی شبکه (network timeouts).

* هیچ احراز هویتی صریحی استفاده نمی‌شود، فرض بر این است که API عمومی است.

* Filter Results

* نوع: n8n-nodes-base.function

* نقش: لیست‌های دریافت شده را فیلتر می‌کند تا فقط مواردی که قیمت آن‌ها کمتر یا مساوی MAX_RENT و تعداد اتاق‌ها بیشتر یا مساوی ROOMS است، شامل شوند.

* پیکربندی: از یک تابع فیلتر جاوا اسکریپت برای بررسی فیلدهای item.json.type، price و rooms هر لیست استفاده می‌کند.

* مشکلات احتمالی:

* خطاهای تجزیه (parsing errors) در صورتی که ساختار داده از API تغییر کند.

* فیلدهای از دست رفته در داده‌های لیست.

۴. پردازش متوالی آپارتمان‌ها

• هدف: اطمینان حاصل می‌کند که هر آپارتمان فیلتر شده به صورت جداگانه پردازش می‌شود تا نامه‌های درخواست آماده و ارسال شوند، و از مشکلات احتمالی ارسال همزمان چندین درخواست جلوگیری می‌کند.
• نودها:

* Process Apartments One-by-One

• جزئیات نود:

* Process Apartments One-by-One

* نوع: n8n-nodes-base.splitInBatches

* نقش: آرایه آپارتمان‌های فیلتر شده را به موارد جداگانه (بسته‌هایی با اندازه ۱) تقسیم می‌کند.

* پیکربندی: batchSize روی 1 تنظیم شده است.

* مشکلات احتمالی: پردازش تعداد بسیار زیادی آپارتمان به صورت متوالی می‌تواند زمان‌بر باشد.

۵. دریافت اسناد

• هدف: گزارش Schufa و آخرین فیش‌های حقوقی شما را از Google Drive دریافت می‌کند تا به ایمیل‌های درخواست پیوست شوند.
• نودها:

* Fetch Schufa (Google Drive)

* Fetch Salary Slips (Google Drive)

• جزئیات نود:

* Fetch Schufa (Google Drive)

* نوع: n8n-nodes-base.googleDrive

* نقش: فایل گزارش Schufa را با استفاده از GDRIVE_SCHUFA_FILE_ID پیکربندی شده در نود Set Config دانلود می‌کند.

* پیکربندی: نیاز به احراز هویت OAuth2 با Google Drive دارد.

* مشکلات احتمالی:

* انقضای توکن OAuth یا اعتبارنامه‌های نامعتبر.

* GDRIVE_SCHUFA_FILE_ID نادرست یا از دست رفته.

* خطاهای شبکه.

* Fetch Salary Slips (Google Drive)

* نوع: n8n-nodes-base.googleDrive

* نقش: فایل فیش‌های حقوقی را با استفاده از GDRIVE_SALARY_FILE_ID دانلود می‌کند.

* پیکربندی: مشابه نود دریافت Schufa، اما از شناسه فایل متفاوتی استفاده می‌کند.

* مشکلات احتمالی: مشابه نود Fetch Schufa.

۶. آماده‌سازی و ارسال درخواست

• هدف: یک نامه پوششی شخصی‌سازی شده ایجاد کرده و ایمیل درخواست را با پیوست‌های لازم ارسال می‌کند.
• نودها:

* Generate Cover Letter

* Send Application Email

• جزئیات نود:

* Generate Cover Letter

* نوع: n8n-nodes-base.function

* نقش: متن یک نامه پوششی شخصی‌سازی شده را ایجاد می‌کند و جزئیات مربوط به آپارتمان (شناسه expose، قیمت، اتاق‌ها) و اطلاعات شما را در بر می‌گیرد.

* پیکربندی: از یک رشته الگو (template string) با متغیرهایی که از داده‌های آپارتمان و نود پیکربندی گرفته شده‌اند، استفاده می‌کند.

* مشکلات احتمالی: متغیرهای از دست رفته یا تعریف نشده، خطاهای قالب‌بندی رشته.

* Send Application Email

* نوع: n8n-nodes-base.emailSend

* نقش: ایمیل درخواست را به مخاطب آپارتمان ارسال می‌کند.

* پیکربندی:

* موضوع (Subject): شناسه expose آپارتمان را به صورت پویا شامل می‌شود.

* به (To): از فیلد contactEmail از لیست آپارتمان استفاده می‌کند.

* از (From): از آدرس MY_EMAIL شما استفاده می‌کند.

* پیوست‌ها (Attachments): به داده‌های باینری دریافت شده از نودهای Google Drive (گزارش Schufa و فیش‌های حقوقی) پیوند می‌دهد.

* مشکلات احتمالی:

* مشکلات اعتبارنامه‌های SMTP یا سرویس ایمیل.

* contactEmail از دست رفته در لیست.

* محدودیت‌های اندازه پیوست که توسط ارائه‌دهنده ایمیل اعمال می‌شود.

۷. ثبت درخواست‌ها

• هدف: جزئیات هر درخواست آپارتمان را در یک Google Sheet برای نظارت و پیگیری آسان ثبت می‌کند.
• نودها:

* Log to Google Sheet

• جزئیات نود:

* Log to Google Sheet

* نوع: n8n-nodes-base.googleSheets

* نقش: یک ردیف جدید به Google Sheet مشخص شده شما با جزئیات درخواست اضافه می‌کند.

* پیکربندی:

* محدوده (Range): برای ستون‌های A:E پیکربندی شده است.

* شناسه Sheet (Sheet ID): از GOOGLE_SHEET_ID از نود Set Config استفاده می‌کند.

* احراز هویت: نیاز به احراز هویت OAuth2 با Google Sheets دارد.

* حالت ورودی مقدار (Value Input Mode): برای حفظ قالب‌بندی روی USER_ENTERED تنظیم شده است.

* داده‌های اضافه شده: عنوان آپار