> ## Documentation Index
> Fetch the complete documentation index at: https://developers.didar.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

# نودهای 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 را در اختیار نودهای بعدی قرار می‌دهد.

<Note>
  `Didar CRM Trigger` خودش Webhook را داخل دیدار ایجاد نمی‌کند. URL دریافت را از بخش **Webhook URLs** در اختیار شما قرار می‌دهد و شما باید آن را به‌عنوان **آدرس مقصد** Webhook در دیدار ثبت کنید.
</Note>

برای آشنایی کامل با مفهوم Webhook، رویدادهای موجود، نحوه ساخت Webhook در دیدار و ساختار Payloadها، صفحه [شروع کار با وب‌هوک‌های دیدار](/start-webhook) را بخوانید.

***

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

`Didar CRM` نودی است که برای **ارسال درخواست از n8n به دیدار** استفاده می‌شود. عملیات‌های این نود بر پایه Endpointهای Open API دیدار ساخته شده‌اند.

ابتدا `Resource` را انتخاب می‌کنید؛ مثلاً Deal، Person یا Activity. سپس از بخش `Operation` مشخص می‌کنید چه کاری قرار است انجام شود؛ مثلاً Create، Update، Get یا Search.

<Note>
  در بعضی فیلدها مثل Owner، Pipeline یا Activity Type می‌توانید مقدار را از لیست انتخاب کنید یا ID را به‌صورت دستی وارد کنید. حالت دستی زمانی مناسب است که ID را از یک نود قبلی یا با Expression دریافت می‌کنید.
</Note>

<AccordionGroup>
  <Accordion title="Deal — معامله">
    برای ساخت، ویرایش، دریافت یا جستجوی معاملات استفاده می‌شود. معامله در دیدار برای پیگیری یک فروش مشخص از شروع تا نتیجه نهایی است.

    ### عملیات‌ها

    | Operation | کاربرد                                                                             | صفحه Endpoint متناظر این نود |
    | --------- | ---------------------------------------------------------------------------------- | ---------------------------- |
    | `Create`  | ساخت معامله جدید و مشخص‌کردن شخص، شرکت، مسئول، کاریز، مرحله، مبلغ، وضعیت و محصولات | [Create Deal](/Create-Deal)  |
    | `Update`  | ویرایش یک معامله موجود؛ مثل تغییر مرحله، مسئول، مبلغ، وضعیت یا محصولات             | [Update Deal](/Update-Deal)  |
    | `Get`     | دریافت اطلاعات کامل یک معامله از روی ID                                            | [Get Deal](/Get-Deal-By-Id)  |
    | `Search`  | پیدا کردن معاملات با فیلترهایی مثل مخاطب، مسئول، وضعیت، کاریز، مرحله یا منبع       | [Search Deals](/Search-Deal) |

    ### فیلدهای مهم

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

  <Accordion title="Person — شخص">
    برای کار با مخاطبان حقیقی دیدار استفاده می‌شود؛ مثل مشتری، سرنخ فروش یا فردی که در یک شرکت کار می‌کند.

    ### عملیات‌ها

    | Operation      | کاربرد                                                                     | صفحه Endpoint متناظر این نود                         |
    | -------------- | -------------------------------------------------------------------------- | ---------------------------------------------------- |
    | `Create`       | ساخت شخص جدید همراه با اطلاعات تماس، مسئول، شرکت، آدرس و فیلدهای اضافه     | [Create Person](/Create-Person)                      |
    | `Update`       | ویرایش اطلاعات شخص موجود                                                   | [Update Person](/Update-Person)                      |
    | `Get`          | دریافت جزئیات کامل شخص از روی ID                                           | [Get Person By Id](/Get-Person-By-Id)                |
    | `Get by Phone` | پیدا کردن شخص براساس شماره موبایل؛ مناسب برای جلوگیری از ساخت مخاطب تکراری | [Get Person By Mobile Number](/Get-Person-By-Mobile) |
    | `Search`       | جستجوی اشخاص براساس نام، موبایل، تلفن، ایمیل، کد ملی و سایر فیلترها        | [Search Persons](/Search-Person)                     |

    ### فیلدهای مهم

    * **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** — فیلدهای اضافه شخص.
  </Accordion>

  <Accordion title="Company — شرکت">
    برای ساخت و مدیریت سازمان‌ها و کسب‌وکارهایی استفاده می‌شود که به‌عنوان مخاطب در دیدار ثبت شده‌اند.

    ### عملیات‌ها

    | Operation | کاربرد                                                                                 | صفحه Endpoint متناظر این نود        |
    | --------- | -------------------------------------------------------------------------------------- | ----------------------------------- |
    | `Create`  | ساخت شرکت جدید همراه با اطلاعات تماس، اطلاعات ثبتی، مسئول و آدرس                       | [Create Company](/Create-Company)   |
    | `Update`  | ویرایش اطلاعات شرکت موجود                                                              | [Update Company](/Update-Company)   |
    | `Get`     | دریافت اطلاعات کامل شرکت از روی ID                                                     | [Get Company](/Get-Company-By-Id)   |
    | `Search`  | جستجوی شرکت‌ها براساس نام، شماره تماس، شناسه ملی، شماره ثبت، کد اقتصادی و سایر فیلترها | [Search Companies](/Search-Company) |

    ### فیلدهای مهم

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

  <Accordion title="Activity — فعالیت">
    برای مدیریت کارهایی استفاده می‌شود که باید در زمان مشخص انجام شوند؛ مثل تماس، جلسه یا پیگیری یک معامله.

    ### عملیات‌ها

    | Operation | کاربرد                                                                 | صفحه Endpoint متناظر این نود          |
    | --------- | ---------------------------------------------------------------------- | ------------------------------------- |
    | `Create`  | ساخت فعالیت جدید و تعیین نوع، مسئول، زمان و رکوردهای مرتبط             | [Create Activity](/Create-Activity)   |
    | `Update`  | ویرایش فعالیت موجود؛ مثل زمان، مسئول، نتیجه یا وضعیت انجام             | [Update Activity](/Update-Activity)   |
    | `Search`  | جستجوی فعالیت‌ها براساس نوع، مسئول، مخاطب، وضعیت، تاریخ یا رکورد مرتبط | [Search Activities](/Search-Activity) |

    ### فیلدهای مهم

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

  <Accordion title="Note — یادداشت">
    یادداشت برای ثبت متن آزاد کنار شخص، شرکت، معامله یا کارت استفاده می‌شود و برخلاف فعالیت، زمان انجام ندارد.

    ### عملیات‌ها

    | Operation | کاربرد                                         | صفحه Endpoint متناظر این نود |
    | --------- | ---------------------------------------------- | ---------------------------- |
    | `Create`  | ساخت یادداشت جدید و اتصال آن به رکوردهای مرتبط | [Create Note](/Create-Note)  |
    | `Update`  | تغییر متن یا ارتباط‌های یک یادداشت موجود       | [Update Note](/Update-Note)  |

    ### فیلدهای مهم

    * **Result Note** — متن اصلی یادداشت.
    * **Deal ID / Case ID / Contact IDs** — رکوردهایی که یادداشت به آن‌ها متصل می‌شود.
    * **Tags** — تگ‌های یادداشت.
    * **Owner / Creator** — مسئول و ایجادکننده رکورد.
  </Accordion>

  <Accordion title="Case — کارت">
    کارت برای پیگیری فرایندهایی استفاده می‌شود که الزاماً فروش نیستند؛ مثل تیکت پشتیبانی، راه‌اندازی مشتری یا یک فرایند کانبان.

    ### عملیات‌ها

    | Operation | کاربرد                                                                    | صفحه Endpoint متناظر این نود |
    | --------- | ------------------------------------------------------------------------- | ---------------------------- |
    | `Create`  | ساخت کارت جدید و تعیین مرحله، مسئول، مخاطبان، اولویت و سایر اطلاعات       | [Create Case](/Create-Case)  |
    | `Update`  | ویرایش یک کارت موجود                                                      | [Update Case](/Update-Case)  |
    | `Search`  | جستجوی کارت‌ها براساس عنوان، مخاطب، مسئول، معامله، تاریخ یا فیلدهای اضافه | [Search Cases](/Search-Case) |

    ### فیلدهای مهم

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

  <Accordion title="Product — محصول">
    برای ساخت، ویرایش و پیدا کردن محصولات یا خدمات دیدار استفاده می‌شود.

    ### عملیات‌ها

    | Operation      | کاربرد                                                        | صفحه Endpoint متناظر این نود                              |
    | -------------- | ------------------------------------------------------------- | --------------------------------------------------------- |
    | `Create`       | ساخت محصول یا خدمت جدید همراه با کد، قیمت، گروه و زیرمحصول‌ها | [Create Product](/Create-product)                         |
    | `Update`       | ویرایش محصول موجود با استفاده از Product ID                   | [Create Product — ساختار Endpoint مشترک](/Create-product) |
    | `Get by Codes` | دریافت یک یا چند محصول براساس کد محصول                        | [Get Products By Code](/get-products-by-code)             |
    | `Search`       | جستجوی محصولات براساس عنوان                                   | [Search Products](/Search-Products)                       |

    ### فیلدهای مهم

    * **Title / Code** — عنوان و کد محصول.
    * **Product Category** — گروهی که محصول یا خدمت در آن دسته‌بندی می‌شود.
    * **Unit / Unit Price** — واحد و قیمت پایه.
    * **Variants** — زیرمحصول‌ها و مشخصات آن‌ها.
    * **Active** — فعال یا غیرفعال بودن محصول.
    * **Custom Fields** — فیلدهای اضافه محصول.

    <Note>
      در Community Node، عملیات Create و Update محصول هر دو از Endpoint `POST /api/product/save` استفاده می‌کنند. در Update، شناسه محصول نیز ارسال می‌شود. در API Reference فعلی صفحه مستقلی برای Update Product وجود ندارد.
    </Note>
  </Accordion>

  <Accordion title="Supplementary — اطلاعات تکمیلی">
    این Resource برای دریافت اطلاعات پایه و اجرای عملیات‌های کمکی استفاده می‌شود.

    ### Get Base Info

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

    | Dataset              | کاربرد                        | صفحه Endpoint متناظر این نود                |
    | -------------------- | ----------------------------- | ------------------------------------------- |
    | `Deal Pipelines`     | کاریزهای معامله و مراحل آن‌ها | [Get Deal Pipelines](/List-Deal-Pipelines)  |
    | `Case Pipelines`     | کاریزهای کارت و مراحل آن‌ها   | [Get Case Pipelines](/List-Case-Pipelines)  |
    | `Activity Types`     | انواع فعالیت                  | [Get Activity Types](/Activity-Type)        |
    | `User List`          | کاربران دیدار و UserId آن‌ها  | [Get Users](/User-List)                     |
    | `Custom Fields List` | فیلدهای اضافه و Key آن‌ها     | [Get Custom Fields](/Get-Custom-Fields)     |
    | `Product Categories` | گروه‌های محصول                | [Get Product Categories](/product-category) |
    | `Segments`           | گروه‌بندی اشخاص و شرکت‌ها     | [Get Segments](/Segments)                   |
    | `Case Labels`        | برچسب‌های کارت                | [Get Case Labels](/Case-Labels)             |
    | `Deal Labels`        | برچسب‌های معامله              | [Get Deal Labels](/Deal-Labels)             |
    | `Tags`               | تگ‌های فعالیت و یادداشت       | [Get Tags](/Tags)                           |
    | `Lost Reasons`       | دلایل شکست معامله             | [Get Lost Reasons](/Lost-Reasons)           |
    | `Sources`            | گزینه‌های نحوه آشنایی         | [Get Sources](/Sources)                     |

    ### Didaryab Searching

    برای جستجوی هم‌زمان یک عبارت در چند نوع رکورد دیدار استفاده می‌شود.

    **Endpoint متناظر:** [Didaryab Search](/Didaryab-Global-Search)

    * **Keyword** — عبارت مورد جستجو.
    * **Types** — مشخص می‌کند جستجو بین Contact، Company، Deal، Case یا Attachment انجام شود.
  </Accordion>
</AccordionGroup>