Skip to main content

این مجموعه مستندات چیست؟

این‌جا مرجع فنی کامل و متمرکز برای هر نوع اینتگریشن با نرم افزار دیدار است، شما قرار است خودتان با تکیه بر همین مستندات بتوانید اینتگریشن خود را از صفر تا آصد پیاده‌سازی کنید. این مجموعه شامل این بخش‌هاست:
  • راهنمای توسعه‌دهنده (همین بخش) — مفاهیم پایه دیدار و نکات عمومی شروع کار با API، پیش‌نیاز فهم بقیه بخش‌ها
  • API Reference — مستند دقیق تک‌تک Endpointهای دیدار: چه Requestای باید بسازید، چه Responseای برمی‌گردد، چه فیلدهایی الزامی‌اند و هرکدام از این فیلدها به چه معنایی هستند
  • Webhook Reference — رویدادهایی که دیدار می‌تواند به شما اطلاع بدهد و ساختار دقیق Payload هرکدام
  • مستندات نودهای اختصاصی n8n — نحوه استفاده از دیدار در گردش‌کارهای n8n بدون نوشتن کد
هدف این است که این مستندات، قرارداد فنی رسمی و قابل‌اعتماد بین دیدار و شما باشد؛ چیزی که هم برای ساخت integration کافی است، هم می‌توانید به آن ارجاع بدهید.

این مستندات برای چه کسانی نوشته شده؟

برنامه نویسان

برنامه نویسانی که می‌خواهند دیدار را به یک سیستم یا سرویس دیگر (اپلیکیشن داخلی، وب‌سایت، سیستم مالی و…) وصل کنند.

کاربران فنی دیدار

افرادی که خودشان از دیدار به‌عنوان کاربر استفاده می‌کنند، دانش فنی هم دارند و می‌خواهند فرآیندهای تیم فروش یا پشتیبانی خودشان را با API یا Webhook خودکار کنند.

کاربران ابزارهای اتوماسیون

کسانی که با ابزارهایی مثل n8n کار کرده‌اند و می‌خواهند بدون نوشتن کد، دیدار را به گردش‌کارهای خودکار خودشان وصل کنند.

دیدار چیست؟

دیدار یک نرم‌افزار CRM ایرانی است؛ یعنی ابزاری که به شرکت‌ها کمک می‌کند فرآیند فروش‌شان را، از اولین تماس با یک مشتری بالقوه تا فروش موفق و صدور فاکتور، در یک‌جا مدیریت کنند. به زبان ساده‌تر، یک تیم فروش هر روز باید به سوالاتی مثل این‌ها جواب بدهد:
  • الان با کدام مشتری‌ها در حال مذاکره هستیم؟
  • هرکدام از این معامله‌ها در چه مرحله‌ای از فرآیند فروش قرار دارند؟
  • آخرین تماس یا جلسه با این مشتری کِی بوده و چه نتیجه‌ای داشته؟
  • این مشتری چه محصول یا خدماتی خریده و چقدر برایش فاکتور صادر شده؟
  • بعد از فروش، درخواست یا مشکل این مشتری در چه وضعیتی است؟
دیدار دقیقاً همین اطلاعات را نگه می‌دارد، سازمان‌دهی می‌کند و قابل پیگیری می‌سازد. نکته‌ای که برای شما به‌عنوان دولوپر مهم است: لازم نیست کاربر دیدار باشید یا پنلش را دیده باشید، اما باید بدانید این نرم‌افزار حول چه مفاهیمی می‌چرخد؛ چون تقریباً هر Object و Endpoint در API دیدار، معادل دقیق یک چیزی است که یک فروشنده یا کارشناس پشتیبانی هر روز با آن سروکار دارد.

دیدار چه راه‌هایی برای یکپارچه‌سازی جلوی شما می‌گذارد؟

بسته به چیزی که می‌خواهید بسازید، یکی از این سه راه مناسب شماست: این سه راه با هم در تضاد نیستند و معمولاً ترکیبی از آن‌ها استفاده می‌شود. API برای ساخت رکورد و Webhook

مسیر پیشنهادی مطالعه

  1. همین صفحه
    یک تصویر کلی از دیدار و مسیر مطالعه به دست آوردید.
  2. مفاهیم پایه دیدار
    اجزای اصلی دیدار (شخص، شرکت، معامله، کاریز، فعالیت، محصول، فاکتور، پرونده) و رابطه‌شان با هم را یاد می‌گیرید. این صفحه پیش‌نیاز فهم درست همه صفحات بعدی است.
  3. شروع کار با اینتگریشن دیدار
    آدرس پایه، احراز هویت، ساخت کلید API، ساختار پاسخ‌ها و محدودیت‌ها را می‌بینید.
  4. براساس نیازتان ادامه دهید
    اگر با کد کار می‌کنید سراغ API Reference بروید. اگر می‌خواهید از رویدادهای آنی باخبر شوید سراغ Webhook. اگر بدون کد می‌سازید سراغ مستندات n8n.

دیگر لازم نیست تک‌تک این صفحات را بخوانید

راستش را بخواهید، خواندن پشت‌سرهم ده‌ها صفحه مستندات برای پیدا کردن یک Endpoint یا فهمیدن یک فیلد، روش قدیمی است. ما یک دستیار هوشمند اختصاصی ساخته‌ایم که دقیقاً روی همین مستندات فنی دیدار — همین API Reference، همین Webhook Docs، همین مفاهیم پایه — سوار است و می‌تواند به‌جای شما در این صفحات بگردد. کافی است سوال‌تان را به زبان معمولی بپرسید، مثل:
  • «چطور یک معامله جدید بسازم که چند محصول هم بهش وصل باشه؟»
  • «فیلد discountType دقیقاً چه مقادیری می‌تونه بگیره؟»
  • «برای وقتی یک معامله Won می‌شه، چه Webhookـی باید فعال کنم؟»
  • «یک نمونه کد برای ساخت مخاطب جدید از طریق n8n بهم بده»
و به‌جای این‌که خودتان دنبال جواب در بین صفحات بگردید، جواب دقیق، مبتنی بر همین مستندات — نه حدس و گمان — تحویل می‌گیرید.

دستیار هوشمند دیدار را امتحان کنید

درصورتی که از ابزار هوش مصنوعی غیر از chatGPT استفاده می کنید میتوانید از روش زیر اقدام کنید:
  1. ابتدا از لینک زیر فایل markdown داکیومنت فنی دیدار رو دریافت کنید:
    Didar Technical Document
  2. در ابزار هوش مصنوعی خود یک پروژه جدید اضافه کنید
  3. در بخش منابع (source) پروژه فایل markdown دریافت شده را آپلود کنید
  4. متن دستورالعمل پروژه خود را وارد کنید (می توانید از دستورالعمل آماده زیر استفاده کنید)

    Instruction for Didar integration Project

    Open in Cursor