Skip to main content

​
نودهای n8n دیدار

Community Node دیدار دو دسته نود اصلی در اختیار شما قرار می‌دهد:
  1. نود وبهوک دیدار — Didar CRM Trigger برای شروع Workflow بعد از رخ‌دادن یک رویداد در دیدار، از طریق Webhook.
  2. نود عملیات‌های دیدار — Didar CRM برای اجرای عملیات مختلف روی اطلاعات دیدار؛ مثل ایجاد معامله، جستجوی شخص یا ویرایش فعالیت. این عملیات‌ها بر پایه Endpointهای Open API دیدار ساخته شده‌اند.

​
1. نود وبهوک دیدار

Didar CRM Trigger نود Trigger دیدار است. یعنی برخلاف نود Didar CRM که یک درخواست به دیدار می‌فرستد، این نود منتظر می‌ماند تا دیدار اطلاعات یک رویداد را برای n8n ارسال کند و با دریافت آن، Workflow را شروع می‌کند.

​
کجا از این نود استفاده کنیم؟

زمانی از Didar CRM Trigger استفاده کنید که می‌خواهید Workflow شما بلافاصله بعد از یک اتفاق در دیدار اجرا شود و نمی‌خواهید n8n مرتباً از دیدار بپرسد که آیا اطلاعات جدیدی ایجاد شده یا تغییر کرده است. برای مثال:
  • بعد از ایجاد یک معامله، اطلاعات آن را به سیستم دیگری ارسال کنید.
  • بعد از ایجاد یا ویرایش یک شخص، اطلاعات مخاطب را در سرویس دیگری به‌روزرسانی کنید.
  • بعد از ایجاد فعالیت یا کارت، یک فرایند خودکار در n8n شروع کنید.
  • بعد از ایجاد یا تغییر فاکتور، پیش‌فاکتور، محصول یا سایر موجودیت‌هایی که Webhook دارند، مراحل بعدی Workflow را اجرا کنید.
در این مدل، Webhook دیدار نقطه شروع Workflow است و Didar CRM Trigger درخواست ارسال‌شده از دیدار را دریافت می‌کند.

​
این نود چطور کار می‌کند؟

فلو کلی به این شکل است:
  1. نود Didar CRM Trigger را به ابتدای Workflow اضافه کنید.
  2. داخل نود، بخش Webhook URLs را باز کنید.
  3. URL مقصدی که n8n برای این Trigger در اختیار شما قرار داده است بردارید.
  4. در دیدار یک Webhook بسازید و این URL را در فیلد آدرس مقصد قرار دهید.
  5. نوع موجودیت و رویدادی را که می‌خواهید دنبال کنید در Webhook دیدار انتخاب کنید؛ مثلاً «ایجاد معامله».
  6. از این به بعد، هر زمان آن رویداد در دیدار اتفاق بیفتد، دیدار Payload مربوط به Webhook را به URL نود ارسال می‌کند.
  7. Didar CRM Trigger اطلاعات را دریافت می‌کند، Workflow را اجرا می‌کند و داده Webhook را در اختیار نودهای بعدی قرار می‌دهد.
Didar CRM Trigger خودش Webhook را داخل دیدار ایجاد نمی‌کند. URL دریافت را از بخش Webhook URLs در اختیار شما قرار می‌دهد و شما باید آن را به‌عنوان آدرس مقصد Webhook در دیدار ثبت کنید.
برای آشنایی کامل با مفهوم Webhook، رویدادهای موجود، نحوه ساخت Webhook در دیدار و ساختار Payloadها، صفحه شروع کار با وب‌هوک‌های دیدار را بخوانید.

​
2. نود عملیات‌های دیدار

Didar CRM نودی است که برای ارسال درخواست از n8n به دیدار استفاده می‌شود. عملیات‌های این نود بر پایه Endpointهای Open API دیدار ساخته شده‌اند. ابتدا Resource را انتخاب می‌کنید؛ مثلاً Deal، Person یا Activity. سپس از بخش Operation مشخص می‌کنید چه کاری قرار است انجام شود؛ مثلاً Create، Update، Get یا Search.
در بعضی فیلدها مثل Owner، Pipeline یا Activity Type می‌توانید مقدار را از لیست انتخاب کنید یا ID را به‌صورت دستی وارد کنید. حالت دستی زمانی مناسب است که ID را از یک نود قبلی یا با Expression دریافت می‌کنید.
برای ساخت، ویرایش، دریافت یا جستجوی معاملات استفاده می‌شود. معامله در دیدار برای پیگیری یک فروش مشخص از شروع تا نتیجه نهایی است.

​
عملیات‌ها

​
فیلدهای مهم

  • Person / Company — مشخص می‌کند معامله به کدام شخص و شرکت مربوط است.
  • Owner — User مسئول پیگیری معامله.
  • Pipeline / Pipeline Stage — کاریز و مرحله فعلی معامله. مرحله باید متعلق به همان کاریز باشد.
  • Status — وضعیت معامله: Pending، Won یا Lost.
  • Price — مبلغ معامله.
  • Source — نحوه آشنایی معامله را مشخص می‌کند.
  • Labels — برچسب‌های معامله برای دسته‌بندی و شناسایی سریع‌تر معاملات استفاده می‌شوند.
  • Lost Reason — در معامله ناموفق، دلیل شکست معامله را مشخص می‌کند.
  • Deal Items — محصولات یا خدمات معامله همراه با تعداد، قیمت، تخفیف، مالیات و زیرمحصول.
  • Custom Fields — برای مقداردهی فیلدهای اضافه معامله استفاده می‌شود.
برای کار با مخاطبان حقیقی دیدار استفاده می‌شود؛ مثل مشتری، سرنخ فروش یا فردی که در یک شرکت کار می‌کند.

​
عملیات‌ها

​
فیلدهای مهم

  • First Name / Last Name — نام و نام خانوادگی شخص.
  • Mobile Phone / Work Phone / Email — اطلاعات تماس اصلی مخاطب.
  • Owner — User مسئول پیگیری شخص.
  • Company ID — اتصال شخص به یک شرکت موجود.
  • Company Name — در Create، اگر Company ID ارسال نشود، می‌تواند برای ساخت شرکت جدید همراه با شخص استفاده شود.
  • Position — سمت شخص در شرکت.
  • Segments — برای گروه‌بندی شخص در دسته‌های مختلف استفاده می‌شود.
  • Addresses / Other Phones / Other Emails / Websites — اطلاعات چندمقداری مخاطب.
  • Custom Fields — فیلدهای اضافه شخص.
برای ساخت و مدیریت سازمان‌ها و کسب‌وکارهایی استفاده می‌شود که به‌عنوان مخاطب در دیدار ثبت شده‌اند.

​
عملیات‌ها

​
فیلدهای مهم

  • Name — نام شرکت.
  • Mobile Phone / Work Phone / Email — اطلاعات تماس اصلی شرکت.
  • Owner — User مسئول شرکت.
  • Economic Code / Registration Number / National ID — اطلاعات ثبتی و اقتصادی.
  • Segments — گروه‌بندی‌های شرکت.
  • Addresses / Other Phones / Other Emails / Websites — اطلاعات چندمقداری شرکت.
  • Custom Fields — فیلدهای اضافه شرکت.
برای مدیریت کارهایی استفاده می‌شود که باید در زمان مشخص انجام شوند؛ مثل تماس، جلسه یا پیگیری یک معامله.

​
عملیات‌ها

​
فیلدهای مهم

  • Title — عنوان فعالیت.
  • Activity Type — نوع فعالیت را مشخص می‌کند؛ مثل تماس، جلسه یا پیگیری.
  • Owner — User مسئول انجام فعالیت.
  • Due Date / Duration — زمان و مدت برنامه‌ریزی‌شده فعالیت.
  • Is Done / Done Date — وضعیت و زمان انجام فعالیت.
  • Note — توضیحات قبل از انجام فعالیت.
  • Result Note — نتیجه فعالیت بعد از انجام آن.
  • Deal ID / Case ID / Contact IDs — رکوردهایی که فعالیت به آن‌ها مرتبط است.
  • Tags — برای دسته‌بندی و شناسایی فعالیت‌ها استفاده می‌شوند.
  • Recurrence — تنظیمات فعالیت تکرارشونده.
یادداشت برای ثبت متن آزاد کنار شخص، شرکت، معامله یا کارت استفاده می‌شود و برخلاف فعالیت، زمان انجام ندارد.

​
عملیات‌ها

​
فیلدهای مهم

  • Result Note — متن اصلی یادداشت.
  • Deal ID / Case ID / Contact IDs — رکوردهایی که یادداشت به آن‌ها متصل می‌شود.
  • Tags — تگ‌های یادداشت.
  • Owner / Creator — مسئول و ایجادکننده رکورد.
کارت برای پیگیری فرایندهایی استفاده می‌شود که الزاماً فروش نیستند؛ مثل تیکت پشتیبانی، راه‌اندازی مشتری یا یک فرایند کانبان.

​
عملیات‌ها

​
فیلدهای مهم

  • Title — عنوان کارت.
  • Owner / Users — مسئول و کاربران مرتبط با کارت.
  • Pipeline Stage — مرحله‌ای از کاریز کارت که کارت در آن قرار دارد.
  • Status — وضعیت کارت؛ مثل در حال انجام یا انجام‌شده.
  • Person / Company / Other Contacts — مخاطبان مرتبط.
  • Deal ID — معامله مرتبط با کارت.
  • Due Date — موعد کارت.
  • Priority — اولویت کارت.
  • Labels — برچسب‌های مخصوص کارت برای دسته‌بندی و شناسایی سریع‌تر کارت‌ها.
  • Custom Fields — فیلدهای اضافه کارت.
برای ساخت، ویرایش و پیدا کردن محصولات یا خدمات دیدار استفاده می‌شود.

​
عملیات‌ها

​
فیلدهای مهم

  • Title / Code — عنوان و کد محصول.
  • Product Category — گروهی که محصول یا خدمت در آن دسته‌بندی می‌شود.
  • Unit / Unit Price — واحد و قیمت پایه.
  • Variants — زیرمحصول‌ها و مشخصات آن‌ها.
  • Active — فعال یا غیرفعال بودن محصول.
  • Custom Fields — فیلدهای اضافه محصول.
در Community Node، عملیات Create و Update محصول هر دو از Endpoint POST /api/product/save استفاده می‌کنند. در Update، شناسه محصول نیز ارسال می‌شود. در API Reference فعلی صفحه مستقلی برای Update Product وجود ندارد.
این Resource برای دریافت اطلاعات پایه و اجرای عملیات‌های کمکی استفاده می‌شود.

​
Get Base Info

در Dataset مشخص می‌کنید کدام اطلاعات پایه را می‌خواهید دریافت کنید:

​
Didaryab Searching

برای جستجوی هم‌زمان یک عبارت در چند نوع رکورد دیدار استفاده می‌شود.Endpoint متناظر: Didaryab Search
  • Keyword — عبارت مورد جستجو.
  • Types — مشخص می‌کند جستجو بین Contact، Company، Deal، Case یا Attachment انجام شود.