اتصال N8N با CRM پارس ویتایگر

اگر شما هم از کاربران نرم افزار CRM پارس ویتایگر هستید، حتماً می‌دانید که این پلتفرم قدرتمند، یک CRM با هسته متن باز  (Open-Source) دارد و با API کامل و قابلیت وب‌هوک، هیچ محدودیتی برای اتصال به ابزارهای خارجی باقی نمی‌گذارد. اما گاهی اوقات، استفاده مستقیم از API یا نوشتن کدهای پیچیده برای ایجاد یک گردش کار (Workflow) چندمرحله‌ای، برای کاربران غیرفنی یا حتی تیم‌های توسعه‌ای که زمان کافی ندارند، می‌تواند چالش‌برانگیز باشد. اینجا است که n8n وارد عمل می‌شود!

تصور کنید که بتوانید بدون یک خط کدنویسی، پارس ویتایگر خود را به صدها ابزار و پلتفرم دیگر متصل کنید؛ از تلگرام و واتساپ گرفته تا ابزارهای هوش مصنوعی و سرویس‌های داخلی. این اتصال، نه تنها داده‌های شما را متمرکز و دقیق نگه می‌دارد، بلکه به شما اجازه می‌دهد پیچیده‌ترین فرآیندهای کسب‌وکار را به‌صورت کاملاً خودکار دربیاورید. این همان ارزش افزوده نهایی است: تبدیل پارس ویتایگر CRM از یک “سیستم مدیریت ارتباط با مشتری” به یک “مرکز فرماندهی اتوماسیون هوشمند” برای کل سازمان.

n8n چیست و چرا باید از آن استفاده کنیم؟

n8n یک پلتفرم اتوماسیون گردش کار (Workflow Automation Tool) است که به صورت متن‌باز (Open-Source) ارائه شده است. در ساده‌ترین تعریف، n8n نقش یک «پل» یا «مترجم همزمان» را ایفا می‌کند و به شما اجازه می‌دهد تا نرم‌افزارهای مختلفی که در کسب‌وکارتان استفاده می‌کنید (مانند CRM، ابزارهای بازاریابی، پیام‌رسان‌ها، بانک‌های اطلاعاتی، ابزارهای هوش مصنوعی و …) را به یکدیگر متصل کرده و گردش کارهای پیچیده را بدون نیاز به کدنویسی یا با حداقل کدنویسی، طراحی و اجرا کنید.

مزایای کلیدی استفاده از n8n

مزیت	توضیح
رایگان و متن‌باز	هسته n8n کاملاً رایگان است و می‌توانید آن را روی سرور خودتان نصب کنید (Self-hosted) تا کنترل کامل بر داده‌ها و حریم خصوصی داشته باشید.
کنترل کامل و حریم خصوصی	برخلاف بسیاری از ابزارهای ابری (Cloud-based) مشابه، با نصب n8n روی سرور شخصی، تمام داده‌ها در اختیار شما باقی می‌ماند و نگرانی‌های امنیتی کاهش می‌یابد.
جامعیت اتصال (Nodes)	n8n دارای صدها Node (پلاگین اتصال) از پیش ساخته شده برای محبوب‌ترین پلتفرم‌ها در سطح جهان است، از گوگل و آمازون گرفته تا ابزارهای تخصصی مثل پارس ویتایگر و پلتفرم‌های هوش مصنوعی.
انعطاف‌پذیری بی‌نهایت	به دلیل ماهیت متن‌باز بودن و قابلیت افزودن نودهای دلخواه، تقریباً هیچ محدودیتی در طراحی گردش کارها ندارید و می‌توانید پیچیده‌ترین سناریوها را پیاده‌سازی کنید. n8n دارای بیش از ۵۰۰ اتصال داخلی (Connector) به برنامه‌های محبوب مانند Google Sheets، Slack، Telegram، و پلتفرم‌های هوش مصنوعی (AI) است. اگر اتصالی وجود نداشت، می‌توانید با استفاده از گره‌های HTTP/Webhook به هر API دیگری متصل شوید.
مبتنی بر جریان بصری	طراحی گردش کارها به صورت بصری (Visual Workflow) و با استفاده از کشیدن و رها کردن (Drag and Drop) نودها انجام می‌شود که یادگیری و استفاده از آن را برای کاربران غیرفنی آسان می‌کند.
منطق پیشرفته و پیچیده	برخلاف ابزارهای ساده‌تر، n8n به شما اجازه می‌دهد تا گردش‌های کاری شامل منطق‌های شرطی پیچیده (Conditional Logic)، حلقه‌ها (Loops) و تبدیل داده‌ها (Data Transformation) را اجرا کنید.

مزایای طلایی اتصال n8n به پارس ویتایگر CRM

پارس ویتایگر به صورت بومی دارای سیستم گردش کار (Workflow) داخلی بسیار قوی است و از طریق API کامل (REST API) و قابلیت‌های وب هوک (Webhook) می‌تواند به ابزارهای خارجی متصل شود.

این امکانات به تنهایی برای یکپارچه‌سازی‌های ساده یا برای توسعه‌دهندگان کافی و مناسب است. اما، برای کاربران غیرفنی یا برای سناریوهای پیچیده‌ای که نیاز به ترکیب داده‌ها، اعمال منطق‌های متعدد شرطی، یا اتصال به سرویس‌های تخصصی‌تر و چند مرحله‌ای دارند، n8n بازی را تغییر می‌دهد. چرا N8N را به پارس ویتایگر متصل کنم؟

• ارتباط با ابزارهایی که پارس ویتایگر امکان اتصال مستقیم برای آن‌ها ندارد: می‌توانید به هزاران اپلیکیشن دیگر که در لیست ماژول‌های پارس ویتایگر نیستند، متصل شوید.
• اتصال‌های سه‌طرفه یا بیشتر: یک رویداد در پارس ویتایگر می‌تواند چند اتفاق زنجیره‌ای در سیستم‌های دیگر (تلگرام، سرور FTP، ابزار حسابداری و…) را فعال کند.
• منطق‌های شرطی پیچیده: می‌توانید با استفاده از نودهای شرطی در n8n، قوانین و شرط‌های بسیار پیچیده‌تری را برای هدایت داده‌ها اعمال کنید.
• استفاده از تمام متدهای API: نودهای پیشرفته پارس ویتایگر در n8n به شما اجازه می‌دهند از تمام متدهای API شامل Create، Retrieve، Update، Delete و حتی Query (با استفاده از SQL) استفاده کنید که دست شما را بسیار باز می‌گذارد.

مزیت اتصال n8n به پارس ویتایگر	ارزش افزوده برای کسب‌وکار شما	مثال‌های کاربردی
اتوماسیون بین‌سیستمی بی‌وقفه	حذف خطای انسانی و همگام‌سازی لحظه‌ای داده‌ها بین پارس ویتایگر و ده‌ها ابزار دیگر (مانند ابزارهای ایرانی یا جهانی) به طور همزمان.	ساخت پیام های شخصی سازی شده توسط هوش مصنوعی و ارسال خودکار پیام از طریق واتساپ، تلگرام و… (با استفاده از نودهای n8n) به محض تبدیل سرنخ (Lead) در پارس ویتایگر.
افزایش دقت و به‌روزرسانی داده‌ها	اطمینان از صحت و یکپارچگی اطلاعات مشتریان در تمامی پلتفرم‌ها و جلوگیری از تکرار داده‌ها.	در پایان هر هفته، n8n داده‌های مربوط به فاکتورهای پرداخت شده را از پارس ویتایگر استخراج کرده، محاسبات خاصی روی آن‌ها انجام داده و نتیجه را توسط هوش مصنوعی تحلیل می کند، سپس نتیجه نهایی را برای مدیریت ایمیل می کند تا مدیران بتوانند گزارش‌های سفارشی خارج از CRM تهیه کنند.
استفاده از هوش مصنوعی (AI)	اضافه کردن قابلیت‌های پیشرفته هوش مصنوعی به فرآیندهای CRM بدون کدنویسی پیچیده.	۱. تحقیق خودکار درباره یک سرنخ جدید با استفاده از شماره تماس یا ایمیل در ابزارهای خارجی و غنی‌سازی اطلاعات در پارس ویتایگر. ۲. استفاده از DeepSeek LLM (یا سایر مدل‌ها) برای خلاصه‌سازی خودکار تیکت‌های پشتیبانی یا تولید پاسخ‌های پیشنهادی برای FAQ و ثبت آن‌ها در پارس ویتایگر. ۳. ساخت چت‌بات پشتیبانی یا فروش که با داده‌های درون پارس ویتایگر شما تعامل دارد.
اتصال به ابزارهای بازاریابی و مالی	گسترش دامنه اتوماسیون به خارج از فرآیندهای سنتی فروش و پشتیبانی.	انتقال خودکار سرنخ‌های جدید یا مشتریان خاص از پارس ویتایگر به فهرست‌های بازاریابی در Mailchimp یا ActiveCampaign برای شروع کمپین‌های ایمیلی.
اتصالات پیشرفته از طریق Webhook	دریافت داده‌ها از هر فرم یا سیستم خارجی (حتی اگر نود داخلی نداشته باشد) و اعمال منطق‌های پیچیده پیش از ثبت در پارس ویتایگر.	ثبت پاسخ‌های نظرسنجی‌ها یا فرم‌های خارج از پارس ویتایگر و ایجاد یک رکورد جدید در پارس ویتایگر پس از اعتبارسنجی و تبدیل داده‌ها در n8n.

آموزش گام به گام اتصال n8n به CRM پارس ویتایگر

برای شروع این هم‌افزایی قدرتمند، نیاز به چند مرحله ساده دارید. خوشبختانه، جامعه کاربری فعال ویتایگر، یک Community Node اختصاصی برای این اتصال توسعه داده است که کار را بسیار آسان می‌کند.

گام اول: نصب گره‌های اختصاصی ویتایگر (Community Nodes)

همانطور که می‌دانید، جامعه کاربری n8n بسیار فعال است و برای اتصال به سرویس‌های تخصصی، Community Nodes یا همان گره‌های توسعه داده شده توسط جامعه کاربری، بهترین راهکار هستند. برای اتصال به ویتایگر، باید گره‌ای که مخصوص این کار طراحی شده را نصب کنیم. مراحل نصب:

1. ورود به تنظیمات: ابتدا در محیط n8n، به مسیر Settings > Community Nodes بروید.

 

 

2. شروع نصب: روی دکمه Install کلیک کنید تا وارد محیط نصب شوید.

 

 

3. معرفی بسته: نام بسته n8n-nodes-vtiger-crm را در بخش Enter npm package name وارد کنید. این نام، شناسه بسته در مخزن npm است که n8n از آنجا گره مورد نظر ما را پیدا و نصب می‌کند.
4. تأیید ریسک: گزینه I understand the risks of installing unverified code from a public source را انتخاب کنید. این یک گام ضروری است، چون n8n برای حفظ امنیت از شما می‌خواهد که آگاه باشید که در حال نصب کدی از یک منبع عمومی هستید.

 

 

5. اجرای نصب: در نهایت، روی دکمه Install کلیک کنید. n8n در یک چشم بر هم زدن گره را نصب کرده و شما را به لیست Community Nodes برمی‌گرداند. حالا ویتایگر به فهرست ابزارهای اتوماسیون شما اضافه شده است.

گام دوم: ایجاد و تعریف Credentials (اطلاعات احراز هویت)

اتصال به هر سرویس خارجی‌ای، نیازمند احراز هویت است. n8n این کار را از طریق Credentials انجام می‌دهد؛ جایی که اطلاعات محرمانه شما به صورت امن ذخیره می‌شوند تا در جریان‌های کاری، بدون نیاز به وارد کردن مجدد، از آن‌ها استفاده شود.

فرآیند ایجاد Credentials:

1. دسترسی به بخش Credentials: در گوشه بالا و سمت راست صفحه Overview در n8n، روی فلش کنار دکمه قرمز رنگ کلیک کنید.
2. انتخاب ایجاد: گزینه Create Credential را انتخاب کنید.

 

 

3. جستجوی نوع اعتبار: در کادر جستجوی باز شده، Vtiger CRM Creadentials API را تایپ کرده و سپس روی دکمه continue کلیک کنید.

 

4. تکمیل اطلاعات اتصال: صفحه‌ای برای وارد کردن جزئیات احراز هویت باز می‌شود. اینجا باید سه مقدار اصلی را وارد کنید:
   • نام (Name): ابتدا یک نام واضح و گویا برای این اتصال انتخاب کنید (مثلاً “Vtiger Production” یا “Vtiger Dev”) تا در آینده به راحتی بتوانید آن را تشخیص دهید.آدرس (Host): URL کامل نرم‌افزار CRM پارس ویتایگر خود را در این بخش وارد کنید. فرمت باید حتماً به شکل https://your-vtiger-instance.com باشد.
     نکته کلیدی: حواستان باشد که نباید در انتهای آدرس از علامت اسلش (/) و همچنین مسیر webservice.php/ استفاده کنید. آدرس باید صرفاً تا نام دامنه یا زیردامنه شما باشد.
   • نام کاربری (Username): نام کاربری‌ای که می‌خواهید با دسترسی‌های آن در CRM، عملیات اتوماسیون انجام شود.
   • کلید دسترسی (Access Key): این مهم‌ترین بخش است! کلید API کاربر مورد نظر شماست. این کلید را می‌توانید در رابط کاربری وب CRM و در بخش “تنظیمات پروفایل من” یا از طریق مسیر اطلاعات دسترسی پیشرفته کاربر > کلید دسترسی پیدا کنید.

 

 

 

توصیه امنیتی: برای حفظ امنیت، همیشه بهتر است یک نام کاربری جدید و اختصاصی برای اتصالات API و اتوماسیون ایجاد کنید و تنها حداقل سطح دسترسی لازم برای انجام عملیات مورد نظرتان را به آن بدهید. از این طریق، در صورت افشا شدن این کلید، دسترسی‌ها محدود می‌شوند.

با تکمیل این اطلاعات، اتصال شما برقرار شده و n8n آماده است تا جریانات داده‌ای را بین پارس ویتایگر و سایر سرویس‌ها به راه اندازد!

گام سوم: شروع به کار با گره‌های پارس ویتایگر در Workflow

حالا که گره‌ها نصب شده‌اند و احراز هویت انجام شده، وقت آن است که اولین جریان کاری (Workflow) خود را بسازید. افزودن گره پارس ویتایگر:

1. ایجاد گردش کار: یک گردش کار جدید ایجاد کنید.
2. افزودن گام: روی آیکون + (Add first step…) کلیک کنید.

 

 

1. جستجو: در کادر جستجوی موجود در ستون سمت راست، کلمه Vtiger را جستجو کنید و سپس روی گره آن کلیک نمایید.

شما مجموعه‌ای از عملیات‌های کلیدی را در اختیار دارید که توسط این بسته پشتیبانی می‌شوند. برای استفاده مؤثر، لازم است که با مفاهیم پایه‌ای پارس ویتایگر مثل موجودیت‌ها (Entities) و نحوه نام‌گذاری ماژول‌ها آشنا باشید.

 

معرفی نودهای اصلی پارس ویتایگر

این گره‌ها تمامی عملیات حیاتی CRUD (Create, Retrieve, Update, Delete) را پوشش می‌دهند:

 

نود	عملیات	توضیحات
ایجاد (Create)	ایجاد رکورد جدید	برای ساخت موجودیت‌ها (مثل مخاطب، سرنخ و…). ورودی آن باید یک شی JSON معتبر حاوی فیلدهای الزامی باشد.
به‌روزرسانی (Update Entities)	تغییر اطلاعات رکوردها	برای تغییر اطلاعات یک موجودیت موجود. ورودی آن یک JSON است و به شناسه موجودیت (Entity ID) نیاز دارد.
حذف (Delete)	حذف یک رکورد	برای پاک کردن یک موجودیت خاص. به شناسه موجودیت (Entity ID) نیاز دارد.
بازیابی (Retrieve)	دریافت جزئیات رکورد	برای گرفتن تمام اطلاعات یک موجودیت با استفاده از شناسه موجودیت (Entity ID).
جست‌وجو (Query)	جستجو با SQL	برای انجام جستجوهای پیچیده و سفارشی. ورودی آن یک درخواست معتبر SQL (مثل SELECT * FROM Leads WHERE...) است که باید با سیمی‌کالن (;) تمام شود.
توصیف (Describe)	مشاهده ساختار ماژول	برای دریافت اطلاعاتی مثل مجوزهای دسترسی، فیلدها و تنظیمات آن‌ها که برای تنظیم درست ورودی‌های JSON در عملیات Create و Update حیاتی است.
فهرست انواع (List Types)	دریافت فهرست ماژول‌ها	برای دسترسی به لیست نام‌های ماژول‌های استاندارد و سفارشی موجود در CRM شما.

نکته حیاتی برای Create و Update: ورودی این نودها باید یک JSON باشد که نام فیلدها (attributes) به عنوان کلید و مقادیر آن‌ها به عنوان مقدار در آن قرار بگیرد. برای مثال، برای اختصاص یک رکورد به یک کاربر، از فیلدی مثل "assigned_user_id" : "19x1" استفاده می‌کنید که 19x1 همان شناسه موجودیت (Entity ID) کاربر مورد نظر است.

 

نمونه‌ای از JSON برای ثبت اطلاعات سرنخ: مثال JSON:

{

  "firstname": "بهروز",

  "lastname": "قاسمی",

  "email": "b.ghasemei@gmail.com",

  "assigned_user_id" : "19x1"

}

مثال Query:

SELECT * FROM Leads WHERE email LIKE '%@domain.com';

 

برای اطلاعات کامل‌تر در مورد قراردادهای نام‌گذاری ماژول‌ها و ساختار شناسه موجودیت (Entity ID) (که فرمت MODULExID مثل 10x1234 را دارد)، می‌توانید از مسیر منوی اصلی > تنظیمات > تنظیمات پارس ویتایگر > راهنمای REST API نسخه 2 در خود CRM استفاده کنید.

حالا، با این ابزارها در دست، شما آماده‌اید تا فرآیندهای کسب‌وکار خود را به طور کامل و با کمترین دخالت انسانی، بین پارس ویتایگر و دنیای اتوماسیون n8n، یکپارچه سازید! آیا آماده‌اید تا اولین Workflow اتوماتیک خود را طراحی کنید؟

نمونه گردش کارهای آماده و رایگان اتصال n8n به ویتایگر

• Auto-Generate FAQ Answers in Vtiger CRM with DeepSeek LLM and LangChain: تولید خودکار پاسخ‌های سؤالات متداول (FAQ) در Vtiger CRM با استفاده از مدل زبان بزرگ DeepSeek و لنگ‌چین (LangChain).
• Real-time Vtiger Support Tickets to Telegram with Auto Status Updates: ارسال لحظه‌ای تیکت‌های پشتیبانی Vtiger به تلگرام با به‌روزرسانی خودکار وضعیت.
• WhatsApp Message Auto-Logger for Vtiger CRM with Lead Relation: ثبت خودکار پیام‌های واتس‌اپ در Vtiger CRM با ارتباط به سرنخ (Lead).
• Auto-Send Welcome Messages to Vtiger CRM Leads via Evolution API WhatsApp: ارسال خودکار پیام‌های خوش‌آمدگویی به سرنخ‌های Vtiger CRM از طریق Evolution API واتس‌اپ.

پاسخ به سوالات متداول

آیا استفاده از n8n رایگان است؟

بله، هسته اصلی و بخش عظیمی از قابلیت‌های n8n به صورت متن‌باز و رایگان منتشر شده است. شما می‌توانید این نسخه را روی سرور خود نصب کنید (پارس ویتایگر نیز از نصب در محیط‌های خودمیزبان پشتیبانی می‌کند)، که این یک مزیت بزرگ برای کنترل هزینه و امنیت داده‌ها است.

آیا اتوماسیون با n8n امنیت داده‌های من را به خطر می‌اندازد؟

خیر، اگر شما n8n را روی سرور خود (Self-hosted) نصب کنید، داده‌های شما هرگز از محیط امن سرورهای خودتان خارج نمی‌شوند و شما کنترل کامل بر اینکه کدام داده‌ها بین کدام سرویس‌ها جابه‌جا شوند، خواهید داشت.

آیا پارس‌ویتایگر نمی‌تواند به ابزارهای خارجی متصل شود؟ چرا به n8n نیاز داریم؟

پارس ویتایگر دارای API و وب‌هوک است که برای اتصال به هر ابزار خارجی کافی و مناسب است، اما n8n با پشتیبانی از اتصال به بیش از 500 سرویس، اتصال را برای کاربران غیرفنی یا با دانش فنی کم، فوق‌العاده ساده، بصری و سریع می‌کند. به طوری که یک اتوماسیون پیچیده در عرض چند دقیقه و بدون نیاز به کدنویسی انجام می‌شود و این امر سرعت و مقرون به صرفه بودن یکپارچه‌سازی را افزایش می‌دهد.

یادگیری n8n چقدر زمان لازم دارد؟

اگر با گردش کارهای Vtiger آشنایی دارید، یادگیری n8n برایتان بسیار سریع خواهد بود. n8n از یک محیط بصری کشیدن و رها کردن (Drag-and-Drop) استفاده می‌کند. هزاران گردش کار آماده و رایگان نیز در n8n وجود دارد که فرآیند شروع کار و توسعه اتوماسیون‌های پیچیده را بسیار آسان‌تر می‌کند.

نتیجه‌گیری: اتوماسیونی فراتر از مرزها

گردش کارهای داخلی پارس ویتایگر برای حفظ کارایی درونی و اتوماسیون داده‌های CRM ضروری و بسیار مفید هستند. اما زمانی که این قدرت داخلی را با انعطاف‌پذیری، هوش مصنوعی و بیش از ۵۰۰ اتصال آماده n8n در هم می‌آمیزید، قابلیت‌های پارس ویتایگر را به اوج می‌رسانید. n8n ضعف یا کمبود قابلیت های این CRM نیست، بلکه پتانسیل آن را برای ارتباط با دنیای خارج چند برابر می‌کند. این اتصال یک گام بزرگ به سوی اتوماسیون بدون محدودیت است که به شما کمک می‌کند فرآیندهایی طراحی کنید که نه تنها سریع‌تر، بلکه هوشمندتر، پیچیده‌تر و کاملاً سازگار با دنیای چند پلتفرمی امروز باشند.