نانوپ
مستندات n8n
74+ نود

مستندات n8n

74+ نود مستند شده · ۰ بازدید

🌐

وب‌فلو

Webflow

مدیریت خودکار محتوای CMS، محصولات و فرم‌های Webflow

ابزارهای توسعه
متوسط
۰ بازدید
n8n 1.0+

نمای کلی

نود Webflow چیست؟

نود Webflow امکان مدیریت خودکار محتوای سایت‌های Webflow را در n8n فراهم می‌کند. Webflow یکی از محبوب‌ترین پلتفرم‌های no-code web design است.

قابلیت‌های کلیدی:

  • CMS Management: ایجاد، ویرایش، حذف و لیست آیتم‌های Collection
  • Publish/Unpublish: مدیریت وضعیت انتشار آیتم‌ها
  • Site Info: دریافت اطلاعات سایت و Collections
  • Ecommerce: مدیریت محصولات و سفارش‌ها
  • Forms: پردازش فرم‌های ارسالی
  • Memberships: مدیریت اعضا و دسترسی‌ها

اجزای Webflow:

  • Designer: ابزار visual drag-and-drop برای طراحی
  • CMS: سیستم مدیریت محتوای دینامیک (Blog, Portfolio, Products)
  • Ecommerce: فروشگاه آنلاین یکپارچه
  • Hosting: CDN سریع با SSL رایگان
  • Interactions: انیمیشن و micro-interactions
  • Memberships: سیستم عضویت و محتوای محدود

محدودیت‌های API:

  • Rate Limit: ۶۰ درخواست در دقیقه (General), ۱۰ درخواست در دقیقه (CMS Publish)
  • Bulk Operations: حداکثر ۱۰۰ آیتم در هر batch
  • File Upload: حداکثر ۴MB برای هر asset

احراز هویت

احراز هویت Webflow

روش ۱: API Token (ساده‌ترین)

  1. 1به Webflow Dashboard بروید
  2. 2Site Settings > Integrations > API Access را باز کنید
  3. 3یک API Token جدید generate کنید
  4. 4Scopes مورد نیاز را انتخاب کنید:
  • CMS: Read/Write برای collection items
  • Sites: Read برای اطلاعات سایت
  • Ecommerce: Read/Write برای محصولات و سفارش‌ها
  • Forms: Read برای فرم‌های ارسالی
  • Memberships: Read/Write برای اعضا
  1. 1Token را کپی و در n8n وارد کنید

⚠️ نکته: Token به سایت خاص متصل است. برای سایت‌های مختلف، توکن‌های جداگانه بسازید.

روش ۲: OAuth2 (برای اپلیکیشن‌ها)

  1. 1در Webflow Dashboard > Workspace Settings > Integrations یک App بسازید
  2. 2Client ID و Client Secret را دریافت کنید
  3. 3Redirect URI و Scopes را تنظیم کنید
  4. 4در n8n از OAuth2 credential استفاده کنید

Scopes مورد نیاز:

| Scope | دسترسی | کاربرد | |-------|---------|--------| | sites:read | خواندن سایت‌ها | دریافت اطلاعات سایت | | sites:write | نوشتن سایت‌ها | Publish سایت | | cms:read | خواندن CMS | لیست و دریافت آیتم‌ها | | cms:write | نوشتن CMS | ایجاد و ویرایش آیتم‌ها | | ecommerce:read | خواندن فروشگاه | لیست محصولات و سفارش‌ها | | ecommerce:write | نوشتن فروشگاه | مدیریت محصولات | | forms:read | خواندن فرم‌ها | دریافت فرم‌های ارسالی |

عملیات‌های موجود

1

item-create

ایجاد آیتم جدید در Collection

2

item-get

خواندن یک آیتم از Collection

3

item-update

ویرایش آیتم موجود در Collection

4

item-delete

حذف آیتم از Collection

5

item-list

دریافت همه آیتم‌های یک Collection

6

item-publish

Publish کردن یک یا چند آیتم CMS

7

collection-list

دریافت همه Collections سایت

8

collection-get

دریافت schema و اطلاعات یک Collection

9

site-list

دریافت لیست سایت‌های Webflow

10

site-publish

Publish کردن سایت Webflow

11

form-list

دریافت لیست فرم‌های ارسال شده

12

form-submissions

دریافت پاسخ‌های ارسالی یک فرم

13

ecommerce-product-list

دریافت لیست محصولات فروشگاه

14

ecommerce-order-list

دریافت لیست سفارش‌های فروشگاه

کاربردهای متداول

کاربردهای رایج

۱. Import محصولات از CSV/Excel

محصولات را از فایل CSV یا Google Sheets بخوانید و خودکار در CMS اضافه کنید.

code
Google Sheets (خواندن محصولات) → Loop → Webflow (ایجاد آیتم CMS) → Webflow (publish)

۲. Blog Automation از Notion

وقتی مقاله جدید در Notion publish شود، خودکار در Webflow blog اضافه شود.

code
Notion Trigger (page updated) → Notion (دریافت محتوا) → Code (Markdown to HTML) → Webflow (ایجاد blog post) → Webflow (publish)

۳. همگام‌سازی محصولات با Shopify

محصولات Shopify را با Webflow Ecommerce همگام نگه دارید.

code
Shopify Trigger (product updated) → Webflow (ویرایش محصول) → Webflow (publish)

۴. پردازش فرم تماس

فرم‌های ارسالی Webflow را پردازش کرده، در CRM ذخیره و ایمیل تأیید ارسال کنید.

code
Webflow Trigger (form submission) → HubSpot (ایجاد contact) → Email (ارسال تأیید) → Slack (اطلاع‌رسانی تیم)

۵. Multi-Language Content

محتوای فارسی/انگلیسی را مدیریت و خودکار ترجمه کنید.

code
Webflow (دریافت آیتم) → OpenAI (ترجمه) → Webflow (ویرایش آیتم ترجمه) → Webflow (publish)

۶. SEO Automation

خودکار meta description و structured data برای هر صفحه CMS generate کنید.

code
Schedule → Webflow (لیست آیتم‌ها بدون SEO) → OpenAI (generate meta) → Webflow (ویرایش)

۷. Inventory Sync

موجودی محصولات را از سیستم انبار خودکار در Webflow به‌روز کنید.

code
Schedule (هر ساعت) → Database (موجودی) → Webflow (ویرایش آیتم) → IF (موجودی ۰) → Webflow (archive)

۸. Social Media Cross-posting

وقتی blog post جدید publish شود، در شبکه‌های اجتماعی هم share شود.

code
Webflow Trigger (item created in blog) → Telegram + Twitter + LinkedIn (ارسال خلاصه + لینک)

۹. Portfolio Update از Behance

پروژه‌های جدید Behance را خودکار در portfolio سایت اضافه کنید.

code
Schedule → HTTP Request (Behance API) → Code (فرمت داده) → Webflow (ایجاد آیتم portfolio)

۱۰. Analytics Report

هر هفته گزارش آمار سایت و CMS ارسال شود.

code
Schedule (هفتگی) → Webflow (لیست آیتم‌ها) → Code (محاسبه آمار) → Email (ارسال گزارش)

نکات حرفه‌ای

نکات حرفه‌ای

۱. از Collection ID (نه نام) استفاده کنید

همیشه از Collection ID عددی در API calls استفاده کنید. نام Collection ممکن است تغییر کند.

۲. Item Slug باید Unique باشد

هر آیتم CMS یک slug unique نیاز دارد. برای import خودکار، slug را از عنوان generate کنید.

۳. Reference Fields نیاز به Item ID دارند

فیلدهای Reference/Multi-Reference مقدار Item ID می‌گیرند، نه نام آیتم. ابتدا آیتم مرجع را بسازید.

۴. Publish بعد از تغییرات

تغییرات CMS تا زمانی که publish نشوند، در سایت live دیده نمی‌شوند. حتماً بعد از ویرایش، publish کنید.

۵. از Staging Environment استفاده کنید

قبل از تغییرات production، در staging تست کنید. Webflow امکان staging domain دارد.

۶. Batch Operations

برای import حجیم، آیتم‌ها را در batch‌های ۱۰ تایی ارسال کنید تا از rate limit جلوگیری شود.

۷. Webflow Trigger با Webhook

از Webflow Webhooks برای trigger شدن workflow استفاده کنید: form_submission, ecommerce_new_order, collection_item_created.

۸. Image Optimization

تصاویر را قبل از upload بهینه‌سازی کنید. از CDN URL استفاده کنید و سایز مناسب انتخاب کنید.

۹. Rich Text Fields

برای فیلدهای Rich Text، محتوا را به HTML ارسال کنید. Webflow از subset خاصی از HTML tags پشتیبانی می‌کند.

۱۰. Backup Strategy

قبل از import حجیم، از CMS بک‌آپ بگیرید. Webflow امکان backup دستی دارد.

۱۱. Dynamic Content با CMS

از CMS Collections برای محتوای دینامیک استفاده کنید. n8n می‌تواند خودکار محتوا را به‌روز نگه دارد.

۱۲. Multi-Site Management

با n8n می‌توانید چندین سایت Webflow را از یک workflow مدیریت کنید. از Loop و مقادیر dynamic استفاده کنید.

۱۳. Form Data Processing

فرم‌های Webflow فقط data ارسال می‌کنند. از n8n برای validation، ذخیره در database و ارسال notification استفاده کنید.

۱۴. SEO Fields

برای هر آیتم CMS، فیلدهای SEO (meta title, meta description, og:image) را پر کنید. n8n + AI می‌تواند خودکار generate کند.

۱۵. Error Handling

برای import خودکار، از Error Trigger و retry logic استفاده کنید تا آیتم‌های failed خودکار retry شوند.

رفع مشکلات

رفع مشکلات رایج

❌ خطای "Collection not found"

علت: Collection ID نامعتبر

راه‌حل

  • Collection ID را از URL کپی کنید (نه نام Collection)
  • از API /sites/{site_id}/collections لیست Collections را دریافت کنید
  • مطمئن شوید Collection حذف نشده باشد

❌ خطای "Required field missing"

علت: فیلدهای اجباری پر نشده‌اند

راه‌حل

  • ابتدا schema Collection را بررسی کنید
  • همه فیلدهای required: true باید مقدار داشته باشند
  • فیلد name و slug معمولاً اجباری هستند
  • Reference fields نیاز به item ID دارند (نه نام)

❌ خطای "Slug already exists"

علت: slug تکراری

راه‌حل

  • هر آیتم CMS باید slug unique داشته باشد
  • از Code node برای generate slug unique استفاده کنید
  • مثال: slug-1770541551145

❌ خطای Rate Limit (429)

علت: بیش از ۶۰ درخواست در دقیقه

راه‌حل

  • بین درخواست‌ها Wait node (۱ ثانیه) اضافه کنید
  • برای bulk operations، از batch mode استفاده کنید
  • CMS Publish محدودیت ۱۰ req/min دارد

❌ خطای "Invalid API Token"

علت: Token نامعتبر یا منقضی

راه‌حل

  • Token را از Webflow Site Settings بررسی کنید
  • مطمئن شوید Token برای سایت صحیح generate شده
  • Token را regenerate کنید

❌ تغییرات در سایت دیده نمی‌شود

علت: آیتم‌ها publish نشده‌اند

راه‌حل

  • پس از ایجاد/ویرایش آیتم، حتماً publish کنید
  • از item-publish operation استفاده کنید
  • یا سایت را با site-publish به صورت کامل publish کنید

❌ خطای "Reference field invalid"

علت: ID آیتم مرجع نادرست

راه‌حل

  • Reference fields نیاز به item ID دارند
  • ابتدا آیتم مرجع را بسازید و ID آن را استفاده کنید
  • Multi-reference به صورت آرایه‌ای از IDs ارسال شود

❌ خطای "Image field must be a URL"

علت: فرمت URL تصویر نادرست

راه‌حل

  • URL باید publicly accessible باشد
  • فرمت‌های مجاز: JPG, PNG, GIF, SVG, WebP
  • حداکثر سایز: ۴MB
  • از CDN URL استفاده کنید برای سرعت بالاتر
اشتراک‌گذاری:

آیا این مستندات مفید بود؟