خلاصه تصمیم: اگر لید، سفارش یا پیگیری‌های روزمره‌تان داخل گوگل شیت است، n8n می‌تواند همان شیت را به «مغز اتوماسیون» تبدیل کند: ردیف جدید → غربال → ثبت/به‌روزرسانی → اطلاع به انسان. این راهنما قدم‌به‌قدم اتصال Google Sheets به n8n، سه ورک‌فلو واقعی، و ترفندهای خطایابی را پوشش می‌دهد — بدون قیمت و بدون وعده جادویی.

فرزند خوشه‌ی اتوماسیون با n8n. فرض: n8n روی HTTPS آماده است. اگر نیست → نصب دستور به دستور با Docker. برای انتخاب ابزار هم مقایسه n8n و Make را ببینید.

این مقاله برای چه کسی است؟

• فریلنسر یا SME که لیدها را در Google Sheets نگه می‌دارد
• تیمی که فرم سایت / تلگرام / اینستاگرام را دستی به شیت کپی می‌کند
• کسی که می‌خواهد بدون کدنویسی سنگین، شیت را به CRM سبک وصل کند

اگر هنوز با خود Sheets آشنا نیستید، پایه را از گوگل شیت چیست؟ مرور کنید؛ بعد برگردید اینجا برای لایه‌ی اتوماسیون.

چرا Google Sheets + n8n ترکیب برنده‌ای است؟

Sheets برای انسان خوانا است؛ n8n برای ماشین قابل اعتماد است. وقتی با هم کار کنند:

• منبع حقیقت واحد: یک شیت، چند کانال ورودی (فرم، ربات، وب‌هوک)
• بدون قفل وندور سنگین: داده پیش شماست؛ ورک‌فلو قابل بکاپ است
• مسیر رشد نرم: از شیت شروع می‌کنید؛ بعداً به CRM واقعی مهاجرت می‌دهید بدون دور ریختن منطق

مثال واقعی: فرم لندینگ → ردیف در شیت «Leads» → اگر بودجه ≥ X، ردیف به شیت «Sales» کپی و در تلگرام به فروشنده پینگ می‌شود. همین الگو را در ربات پشتیبانی تلگرام با n8n هم می‌بینید؛ فقط منبع داده اینجا Sheets است.

پیش‌نیازها (۱۰ دقیقه)

1. n8n در دسترس با HTTPS (ترجیحاً Self-host؛ راهنما: نصب Docker)
2. یک حساب Google که به Sheets دسترسی دارد
3. یک Spreadsheet خالی با نام معنادار (مثلاً ops-leads-2026)
4. ستون‌های ثابت از روز اول — نام ستون را بعداً عوض نکنید مگر ورک‌فلو را هم آپدیت کنید

قالب ستون‌های پیشنهادی برای شیت Leads

• created_at — زمان ورود
• source — فرم / تلگرام / دستی
• name — نام
• phone یا email
• budget — عدد خام
• status — new / qualified / lost / done
• owner — مسئول پیگیری
• notes — یادداشت آزاد

اتصال Google به n8n (OAuth؛ یک‌بار برای همیشه)

1. در n8n یک Credential از نوع Google Sheets OAuth2 بسازید.
2. در Google Cloud Console یک پروژه بسازید، Google Sheets API را Enable کنید.
3. OAuth Client از نوع Web بسازید؛ Redirect URI را دقیقاً از n8n کپی کنید (معمولاً شبیه https://YOUR-N8N/rest/oauth2-credential/callback).
4. Client ID و Secret را در n8n بگذارید → Connect → حساب را تأیید کنید.
5. یک نود Google Sheets آزمایشی بزنید: Get Many Rows روی همان شیت تست. اگر ردیف‌ها آمد، Credential سالم است.

ترفند: برای تیم، یک حساب سرویس‌مانند (مثلاً automation@yourdomain) بسازید و فقط همان را به شیت‌های عملیاتی Share کنید — وقتی فرد از شرکت می‌رود، ورک‌فلو نمی‌میرد.

سه ورک‌فلو کاربردی (از ساده به واقعی)

۱) فرم / وب‌هوک → ردیف جدید در Sheets

هدف: هر لید جدید بدون کپی‌پیست وارد شیت شود.

1. Trigger: Webhook (یا نود فرم n8n)
2. Set / Edit Fields: فیلدها را به نام ستون‌ها نگاشت کنید
3. Google Sheets: عملیات Append (یا Append or Update اگر کلید یکتا دارید)
4. اختیاری: IF روی budget → نود Telegram/Email برای فروشنده

مثال نگاشت: body.name → name ، body.phone → phone ، {{$now}} → created_at ، مقدار ثابت webhook → source.

۲) ردیف جدید در شیت → اطلاع و غربال

هدف: وقتی کسی دستی هم در شیت ردیف زد، اتوماسیون بیدار شود.

1. Trigger: Google Sheets Row Added (یا Poll روی شیت اگر Trigger لحظه‌ای ندارید)
2. IF: مثلاً status = new و budget >= 5
3. Sheets: Update همان ردیف → status = qualified ، owner = sara
4. Telegram / Email: پیام خلاصه به مسئول

برای متن پیام‌های فروش/پشتیبانی می‌توانید از قالب‌های پرامپت فارسی ایده بگیرید و کوتاه‌شان کنید.

۳) همگام‌سازی سبک CRM: Update با کلید یکتا

هدف: اگر همان شماره دوباره آمد، ردیف تکراری نسازید.

1. قبل از Append، یک Lookup روی ستون phone بزنید
2. اگر پیدا شد → Update ردیف (مثلاً notes و updated_at)
3. اگر نبود → Append

این الگو همان «CRM سبک روی شیت» است؛ برای SME تا صدها ردیف در هفته معمولاً کافی است. وقتی حجم یا دسترسی همزمان بالا رفت، زمان مهاجرت به CRM واقعی است — منطق n8n‌تان قابل انتقال می‌ماند.

چک‌لیست قبل از اعلام به تیم

• Credential فقط به شیت‌های لازم دسترسی دارد (Least Privilege)
• نام Sheet Tab ثابت است (Leads نه «شیت۱»)
• یک ردیف تست با داده جعلی زده‌اید و Rollback کرده‌اید
• مسیر خطا دارید: نود Error Trigger یا حداقل پیام به ادمین وقتی Append شکست می‌خورد
• ستون‌های تاریخ با یک فرمت واحد نوشته می‌شوند (ترجیحاً ISO)
• شماره موبایل را نرمال کرده‌اید (مثلاً همیشه با 98 شروع شود) تا Lookup اشتباه نکند
• اجراها (Executions) را بعد از دیباگ Prune می‌کنید تا دیسک VPS پر نشود — جزئیات در راهنمای نصب

خطاهای رایج و رفع سریع

• 403 / insufficient permissions: Sheets API Enable نشده یا حساب OAuth به فایل Share نشده
• Range not found: نام Tab غلط است یا هدر ستون با نام فیلد در نود یکی نیست
• Duplicate rows: Lookup قبل از Append ندارید؛ یا کلید یکتا خالی است
• Rate limit: حلقه روی هزاران ردیف بدون Batch؛ از Get Many با صفحه‌بندی و فاصله زمانی استفاده کنید
• Timezone کج: $now را با timezone سرور یکی کنید یا صریحاً تنظیم کنید

الگوی امنیتی حداقلی

• Webhook عمومی را بدون Secret/Header چک رها نکنید
• شیت عملیاتی را «Anyone with link = Editor» نگذارید
• توکن و Client Secret را در اسکرین‌شات آموزش پاک کنید
• ستون‌های حساس (کد ملی، کارت) را اصلاً در Sheets عمومی نگذارید

تمرین ۳۰ دقیقه‌ای همین هفته

1. یک شیت Leads با ستون‌های بالا بسازید
2. Webhook → Append را تا رسیدن یک ردیف تست پیش ببرید
3. یک IF ساده روی بودجه + پیام تلگرام به خودتان اضافه کنید
4. عمداً یک درخواست بد بفرستید و ببینید Error را کجا می‌بینید

اگر می‌خواهید همین تمرین را داخل مسیر پروژه‌محور پیش ببرید، دوره n8n همیار لایه‌ی ساخت واقعی را پوشش می‌دهد. برای شروع رایگان هم بسته شروع n8n را ببینید.

FAQ

آیا باید از Google Sheets API Key استفاده کنم یا OAuth؟
برای ویرایش شیت‌های کاربر، OAuth (یا Service Account با Share صریح) پایدارتر است. API Key معمولاً برای داده‌ی عمومی فقط‌خواندنی است.

Sheets کند می‌شود؛ تا چند ردیف امن است؟
برای اتوماسیون روزمره SME، هزاران ردیف معمولاًOK است؛ ده‌ها هزار ردیف + Lookup مکرر را با آرشیو ماهانه یا انتقال به دیتابیس سبک مدیریت کنید.

می‌توانم به‌جای Sheets از Excel آنلاین استفاده کنم؟
بله، اما اکوسیستم نود و مثال‌های n8n برای Google Sheets بالغ‌تر است. اگر تیم‌تان روی Google Drive است، همان را استاندارد کنید.

ربات تلگرام را چطور به همین شیت وصل کنم؟
خروجی غربال ربات را Append/Update کنید — الگوی کامل در ربات پشتیبانی تلگرام با n8n.

جمع‌بندی

Google Sheets وقتی با n8n جفت شود، از «فایل مشترک» به «سیستم عملیاتی سبک» تبدیل می‌شود: ورودی یکتا، غربال، به‌روزرسانی، اطلاع. از یک ورک‌فلو Append شروع کنید، بعد Lookup و مسیر خطا را اضافه کنید، بعد کانال‌های بیشتر.

ادامه مسیر پیشنهادی:

• ستون خوشه: اتوماسیون n8n برای کسب‌وکار
• زیرساخت: نصب n8n با Docker
• کانال پیام: ربات تلگرام
• تصمیم ابزار: n8n یا Make
• ایده‌های اتوماسیون AI: ۱۰ کار تکراری با AI

اگر می‌خواهی اولین اتوماسیون n8n را رایگان راه بیندازی، بسته‌ی شروع همیار را ببین. اگر ساخت پروژه‌محور را ترجیح می‌دهی، دوره‌ی n8n همیار قدم‌های بعدی را پوشش می‌دهد.